Files
blitzkit/packages/scripts/src/buildAssets/definitions.ts
T

1834 lines
56 KiB
TypeScript
Raw Normal View History

2024-09-30 22:35:37 -05:00
import {
Armor,
2024-12-13 10:58:16 -06:00
BlitzTankClass,
2024-09-30 22:35:37 -05:00
CamouflageDefinitions,
Consumable,
ConsumableDefinitions,
ConsumableTankCategoryFilterCategory,
Crew,
CrewType,
EquipmentDefinitions,
EquipmentSlot,
GameDefinitions,
GunDefinition,
2024-10-05 23:20:04 -05:00
GunDefinitionBase,
2025-01-14 14:38:41 -06:00
I18nString,
2024-09-30 22:35:37 -05:00
MapDefinitions,
ModelDefinitions,
ModuleType,
Provision,
ProvisionDefinitions,
2024-10-05 23:20:04 -05:00
ResearchCost,
2024-09-30 22:35:37 -05:00
ShellType,
SkillDefinitions,
TankClass,
TankDefinitions,
TankPrice,
TankPriceType,
TankType,
toUniqueId,
Unlock,
Vector3,
} from '@blitzkit/core';
2025-01-14 19:22:41 -06:00
import {
DEFAULT_LOCALE,
SUPPORTED_LOCALE_BLITZ_MAP,
SUPPORTED_LOCALES,
} from '@blitzkit/i18n';
2024-09-30 22:35:37 -05:00
import { readdir } from 'fs/promises';
2025-05-16 19:14:56 -05:00
import { deburr } from 'lodash-es';
2024-09-30 22:35:37 -05:00
import { parse as parsePath } from 'path';
import { Vector3Tuple } from 'three';
import { parse as parseYaml } from 'yaml';
import { readStringDVPL } from '../core/blitz/readStringDVPL';
import { readXMLDVPL } from '../core/blitz/readXMLDVPL';
import { readYAMLDVPL } from '../core/blitz/readYAMLDVPL';
import { commitAssets } from '../core/github/commitAssets';
import { DATA } from './constants';
import { Avatar } from './skillIcons';
2024-12-19 11:32:53 -06:00
import { TankParameters } from './tankIcons';
2024-09-30 22:35:37 -05:00
2025-05-16 19:14:56 -05:00
const nonAlphanumericRegex = /[^a-z0-9]/g;
const multipleDashesRegex = /--+/g;
const trailingDashRegex = /-$/g;
const leadingDashRegex = /^-/g;
const nationSlugDiscriminators = {
china: 'cn',
european: 'eu',
france: 'fr',
germany: 'de',
japan: 'jp',
other: 'ot',
uk: 'gb',
usa: 'us',
ussr: 'ru',
};
2024-10-05 23:20:04 -05:00
function parseResearchCost(raw: number | string) {
if (typeof raw === 'number') {
return {
2024-10-07 19:37:38 -05:00
research_cost_type: { $case: 'xp', value: raw },
2024-10-05 23:20:04 -05:00
} satisfies ResearchCost;
} else {
return {
2024-10-07 19:37:38 -05:00
research_cost_type: {
$case: 'seasonal_tokens',
2024-10-05 23:20:04 -05:00
value: {
season: Number(/prx_season_(\d+):\d+/.exec(raw)![1]),
tokens: Number(/prx_season_\d+:(\d+)/.exec(raw)![1]),
},
},
} satisfies ResearchCost;
}
}
2024-09-30 22:35:37 -05:00
type BlitzTankFilterDefinitionCategory = 'clip';
const blitzTankFilterDefinitionCategoryToBlitzkit: Record<
BlitzTankFilterDefinitionCategory,
ConsumableTankCategoryFilterCategory
> = {
2024-10-05 15:24:54 -05:00
clip: ConsumableTankCategoryFilterCategory.CLIP,
2024-09-30 22:35:37 -05:00
};
function vector3TupleToBlitzkit(tuple: Vector3Tuple) {
return { x: tuple[0], y: tuple[1], z: tuple[2] } satisfies Vector3;
}
const blitzTankClassToBlitzkit: Record<BlitzTankClass, TankClass> = {
2024-10-05 15:24:54 -05:00
lightTank: TankClass.LIGHT,
'AT-SPG': TankClass.TANK_DESTROYER,
heavyTank: TankClass.HEAVY,
mediumTank: TankClass.MEDIUM,
2024-09-30 22:35:37 -05:00
};
export interface BlitzStrings {
[key: string]: string;
}
type ShellKind =
| 'ARMOR_PIERCING'
| 'ARMOR_PIERCING_CR'
| 'HIGH_EXPLOSIVE'
| 'HOLLOW_CHARGE';
type ShellDefinitionsList = Record<
string,
{
id: number;
userString: string;
icon: string;
kind: ShellKind;
caliber: number;
damage: { armor: number; devices: number };
2024-10-05 23:20:04 -05:00
normalizationAngle?: number;
ricochetAngle?: number;
2024-09-30 22:35:37 -05:00
explosionRadius?: number;
}
> & {
icons: Record<string, string>;
};
interface EngineDefinitionsList {
nextAvailableId: number;
ids: Record<string, number>;
shared: {
[key: string]: {
userString: string;
level: number;
fireStartingChance: number;
weight: number;
power: number;
};
};
}
export interface ChassisDefinitionsList {
nextAvailableId: number;
ids: Record<string, number>;
}
type VehicleDefinitionArmor = Record<
string,
number | { vehicleDamageFactor: 0; '#text': number }
>;
interface UnlocksInner {
cost: number | string;
'#text': number;
}
type BlitzModuleType = {
[key in 'vehicle' | 'engine' | 'chassis' | 'turret' | 'gun']:
| UnlocksInner
| UnlocksInner[];
};
type UnlocksListing = BlitzModuleType | undefined;
type BlitzCrewType = 'commander' | 'radioman' | 'gunner' | 'driver' | 'loader';
const blitzCrewTypeToBlitzkit: Record<BlitzCrewType, CrewType> = {
2024-10-05 15:24:54 -05:00
commander: CrewType.COMMANDER,
driver: CrewType.DRIVER,
gunner: CrewType.GUNNER,
loader: CrewType.LOADER,
radioman: CrewType.RADIOMAN,
2024-09-30 22:35:37 -05:00
};
const blitzkitCrewTypeToBlitz: Record<CrewType, BlitzCrewType> = {
2024-10-05 15:24:54 -05:00
[CrewType.COMMANDER]: 'commander',
[CrewType.DRIVER]: 'driver',
[CrewType.GUNNER]: 'gunner',
[CrewType.LOADER]: 'loader',
[CrewType.RADIOMAN]: 'radioman',
2024-09-30 22:35:37 -05:00
};
interface VehicleDefinitions {
invisibility: {
moving: number;
still: number;
firePenalty: number;
};
crew: Record<BlitzCrewType, string | string[]>;
speedLimits: {
forward: number;
backward: number;
};
consumableSlots: number;
provisionSlots: number;
optDevicePreset: string | string[];
hull: {
armor: VehicleDefinitionArmor;
turretPositions: { turret: string };
turretInitialRotation?: { yaw: 0; pitch: 6.5; roll: 0 };
maxHealth: number;
weight: number;
};
chassis: {
[key: string]: {
unlocks: UnlocksListing;
weight: number;
terrainResistance: string;
rotationSpeed: number;
userString: string;
shotDispersionFactors: {
vehicleMovement: number;
vehicleRotation: number;
};
level: number;
hullPosition: string;
armor: {
leftTrack:
| number
| {
chanceToHitByProjectile: number;
chanceToHitByExplosion: number;
'#text': number;
};
rightTrack:
| number
| {
chanceToHitByProjectile: number;
chanceToHitByExplosion: number;
'#text': number;
};
};
};
};
engines: {
[key: string]: {
unlocks: UnlocksListing;
};
};
turrets0: {
[key: string]: {
unlocks: UnlocksListing;
rotationSpeed: number;
weight: number;
circularVisionRadius: number;
maxHealth: number;
armor: VehicleDefinitionArmor;
2025-01-14 14:38:41 -06:00
userString: string;
2024-09-30 22:35:37 -05:00
level: number;
yawLimits: string | string[];
gunPosition: string | string[];
models: { undamaged: string };
hitTester: {
collisionModel: string;
};
guns: {
[key: string]: {
unlocks: UnlocksListing;
armor: VehicleDefinitionArmor & {
gun?:
| number
| {
chanceToHitByProjectile: number;
chanceToHitByExplosion: number;
'#text': number;
};
};
invisibilityFactorAtShot: number | number[];
reloadTime: number;
aimingTime?: number;
shotDispersionRadius: number;
shotDispersionFactors?: {
turretRotation: number;
afterShot: number;
whileGunDamaged: number;
};
maxAmmo: number;
extraPitchLimits?: {
front?: string;
back?: string;
transition?: number | number[];
};
pitchLimits?: string | string[];
pumpGunMode?: boolean;
pumpGunReloadTimes?: string;
clip?: { count: number; rate: number };
models: { undamaged: string };
2025-07-31 13:40:30 -05:00
extras?: {
trayShell?: {
kinds: string;
sectors: Record<
string,
{ id: number; distance: number; factor: number }[]
>;
};
};
2024-09-30 22:35:37 -05:00
};
};
};
};
extras?: {
armorsStatesController?: {
state: [
{
id: 0;
armors: string;
type: 'default';
enabled: true;
factorsModifiers: '';
default: '';
},
{
id: 1;
armors: string;
type: 'default';
enabled: false;
factorsModifiers: '';
},
];
};
};
}
export interface VehicleDefinitionList {
[key: string]: {
id: number;
userString: string;
shortUserString?: string;
description: string;
price: number | { gold: ''; '#text': number };
sellPrice?: { gold: ''; '#text': number };
enrichmentPermanentCost: number;
notInShop?: boolean;
tags: string;
level: number;
combatRole?: Record<string, string>;
configurationModes: string;
};
}
interface TurretDefinitionsList {
nextAvailableId: number;
ids: Record<string, number>;
}
interface GunDefinitionsList {
nextAvailableId: number;
ids: Record<string, number>;
shared: {
[key: string]: {
rotationSpeed: number;
weight: number;
shotDispersionFactors: {
turretRotation: number;
afterShot: number;
whileGunDamaged: number;
};
2024-11-09 19:16:06 -06:00
maxAmmo: number;
2024-09-30 22:35:37 -05:00
aimingTime: number;
shotDispersionRadius: number;
userString: string;
tags: string;
level: number;
pitchLimits: string;
burst?: { count: number; rate: number };
clip?: { count: number; rate: number };
shots: {
[key: string]: {
speed: number;
piercingPower: string;
2024-11-09 12:55:39 -06:00
maxDistance: number;
2024-09-30 22:35:37 -05:00
};
};
};
};
}
export interface OptionalDevices {
[key: string]: {
id: number;
userString: string;
description: string;
icon: string;
script: unknown;
display_params: unknown;
};
}
interface OptionalDeviceSlots {
presets: {
[key: string]: {
level0: OptionalDeviceSlotRow;
level1: OptionalDeviceSlotRow;
level2: OptionalDeviceSlotRow;
};
};
}
interface OptionalDeviceSlotRow {
[key: string]: { device0: string; device1: string };
}
export interface ConsumablesCommon {
[key: string]: {
id: number;
userString: string;
description: string;
icon: string;
category: string;
tags: string;
vehicleFilter?: {
include: { vehicle: ConsumablesVehicleFilter; nations?: string };
exclude?: { vehicle: ConsumablesVehicleFilter; nations?: string };
};
script: {
'#text': string;
automatic?: boolean;
cooldown: number;
duration?: number;
shotEffect?: string;
bonusValues?: { [key: string]: number };
} & Record<string, string>;
};
}
export interface ProvisionsCommon {
[key: string]: {
id: number;
userString: string;
description: string;
icon: string;
category: string;
tags: string;
vehicleFilter?: {
include: { vehicle: ConsumablesVehicleFilter; nations?: string };
exclude?: { vehicle: ConsumablesVehicleFilter; nations?: string };
};
script: {
'#text': string;
automatic?: boolean;
shotEffect?: string;
bonusValues?: { [key: string]: number };
} & Record<string, string>;
};
}
type CamouflagesInclude =
| {
nations?: string;
}
| {
vehicle?: { name?: string; minLevel?: number; maxLevel?: number };
};
interface CamouflagesXML {
camouflages: Record<
string,
{
id: number;
userString: string;
description: string;
category: string;
group: string;
kind: string;
notInShop: boolean;
unlockCostCategory?: string;
vehicleFilter: {
include?: CamouflagesInclude | CamouflagesInclude[];
};
script: string[] | string;
icon?: string;
unlockPremium?: string;
unlockQuest?: string;
unlockClanLevel?: number;
unlockShopBundle?: string;
unlockTankRank?: number;
}
>;
}
type CamouflagesYaml = Record<
string,
{
userString?: string;
shortUserString?: string;
}
>;
type ConsumablesVehicleFilter =
| { minLevel: number; maxLevel: number }
| { name: string }
| { extendedTags: string };
export interface Maps {
maps: {
[key: string]: {
id: number;
tags?: string;
localName: string;
avaliableInTrainingRoom: boolean; // lol wg typo
spriteFrame: number;
supremacyPointsThreshold?: number;
availableModes: number[];
shadowMapsAvailable?: boolean;
assaultRespawnPoints: {
allies: MapAlly[];
enemies: MapAlly[];
};
levels?: number[];
};
};
}
export interface MapAlly {
respawnNumber: number;
points: Array<number[]>;
}
interface AvailableNationsYaml {
available_nations: string[];
}
export interface SquadBattleTypeStyles {
Prototypes: {
components: {
UIDataLocalBindingsComponent: {
data: [string, string, string][];
};
};
}[];
}
type CombatRolesYaml = Record<
string,
{
id: number;
default_abilities: string[];
}
>;
const blitzShellKindToBlitzkit: Record<ShellKind, ShellType> = {
2024-10-05 15:24:54 -05:00
ARMOR_PIERCING: ShellType.AP,
ARMOR_PIERCING_CR: ShellType.APCR,
HIGH_EXPLOSIVE: ShellType.HE,
HOLLOW_CHARGE: ShellType.HEAT,
2024-09-30 22:35:37 -05:00
};
2025-05-16 19:14:56 -05:00
export const botPattern = /^.+((tutorial_bot(\d+)?)|(TU))$/;
2024-09-30 22:35:37 -05:00
const blitzModuleTypeToBlitzkit: Record<keyof BlitzModuleType, ModuleType> = {
2024-10-05 15:24:54 -05:00
chassis: ModuleType.TRACKS,
engine: ModuleType.ENGINE,
gun: ModuleType.GUN,
turret: ModuleType.TURRET,
vehicle: ModuleType.VEHICLE,
2024-09-30 22:35:37 -05:00
};
2024-09-29 22:24:35 -05:00
2024-08-27 14:40:43 -05:00
export async function definitions() {
2024-02-11 14:17:41 -06:00
console.log('Building definitions...');
2024-09-29 22:24:35 -05:00
2024-09-30 22:35:37 -05:00
const gameDefinitions: GameDefinitions = {
2025-01-14 19:22:41 -06:00
version: (await readStringDVPL(`${DATA}/version.txt`)).split(' ')[0],
2024-09-30 22:35:37 -05:00
nations: (
2025-01-14 19:22:41 -06:00
await readYAMLDVPL<AvailableNationsYaml>(`${DATA}/available_nations.yaml`)
2024-09-30 22:35:37 -05:00
).available_nations,
gameModes: {},
roles: {},
};
const tankDefinitions: TankDefinitions = { tanks: {} };
const camouflageDefinitions: CamouflageDefinitions = { camouflages: {} };
const modelDefinitions: ModelDefinitions = { models: {} };
const mapDefinitions: MapDefinitions = { maps: {} };
const equipmentDefinitions: EquipmentDefinitions = {
presets: {},
equipments: {},
};
const consumableDefinitions: ConsumableDefinitions = { consumables: {} };
const provisionDefinitions: ProvisionDefinitions = { provisions: {} };
const skillDefinitions: SkillDefinitions = {
classes: {
2024-10-05 15:24:54 -05:00
[TankClass.LIGHT]: { skills: [] },
[TankClass.MEDIUM]: { skills: [] },
[TankClass.HEAVY]: { skills: [] },
[TankClass.TANK_DESTROYER]: { skills: [] },
2024-09-29 22:42:15 -05:00
},
2024-09-30 22:35:37 -05:00
};
const nations = await readdir(`${DATA}/XML/item_defs/vehicles`).then(
(nations) => nations.filter((nation) => nation !== 'common'),
);
const tankStringIdMap: Record<string, number> = {};
const optionalDevices = await readXMLDVPL<{ root: OptionalDevices }>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/optional_devices.xml`,
2024-09-30 22:35:37 -05:00
);
2025-01-14 14:38:41 -06:00
const stringsI18n: Record<string, Record<string, string>> = {};
2025-01-14 19:22:41 -06:00
await Promise.all(
SUPPORTED_LOCALES.map(async (locale) => {
2025-07-31 13:40:30 -05:00
if (locale !== 'en') {
stringsI18n[locale] = {};
return;
}
2025-01-14 19:22:41 -06:00
const blitzLocale = SUPPORTED_LOCALE_BLITZ_MAP[locale];
const cache = await fetch(
`https://stufficons.wgcdn.co/localizations/${blitzLocale}.yaml`,
)
.then((response) => response.text())
.then((string) => parseYaml(string) as BlitzStrings);
const preInstalled = await readYAMLDVPL<BlitzStrings>(
`${DATA}/Strings/${blitzLocale}.yaml`,
);
2025-01-14 14:38:41 -06:00
2025-01-14 19:22:41 -06:00
stringsI18n[locale] = {
...cache,
...preInstalled,
};
console.log(`Loaded strings for ${locale}`);
}),
);
2025-01-14 14:38:41 -06:00
function getString(name: string) {
const locales: Record<string, string> = {
[DEFAULT_LOCALE]: stringsI18n[DEFAULT_LOCALE][name],
};
for (const locale of SUPPORTED_LOCALES) {
const localizedString = stringsI18n[locale][name];
if (
localizedString === undefined ||
localizedString === locales[DEFAULT_LOCALE]
) {
continue;
}
locales[locale] = localizedString;
}
return { locales } satisfies I18nString;
}
2024-09-30 22:35:37 -05:00
const optionalDeviceSlots = await readXMLDVPL<{
root: OptionalDeviceSlots;
2025-01-14 19:22:41 -06:00
}>(`${DATA}/XML/item_defs/vehicles/common/optional_device_slots.xml`);
2024-09-30 22:35:37 -05:00
const consumables: ConsumablesCommon = {};
const provisions: ProvisionsCommon = {};
2024-09-29 22:24:35 -05:00
2024-09-30 22:35:37 -05:00
for (const match of (
await readStringDVPL(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/consumables/list.xml`,
2024-09-30 22:35:37 -05:00
)
).matchAll(/<items path="(.+)\.xml"\/>/g)) {
if (match[1] === 'prototypes') continue;
2024-09-29 22:24:35 -05:00
2024-09-30 22:35:37 -05:00
Object.assign(
consumables,
(
await readXMLDVPL<{ root: ConsumablesCommon }>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/consumables/${match[1]}.xml`,
2024-09-30 22:35:37 -05:00
)
).root,
);
}
for (const match of (
await readStringDVPL(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/provisions/list.xml`,
2024-09-30 22:35:37 -05:00
)
).matchAll(/<items path="(.+)\.xml"\/>/g)) {
if (match[1] === 'prototypes') continue;
Object.assign(
provisions,
(
await readXMLDVPL<{ root: ConsumablesCommon }>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/provisions/${match[1]}.xml`,
2024-09-30 22:35:37 -05:00
)
).root,
);
}
const avatar = await readXMLDVPL<{ root: Avatar }>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/tankmen/avatar.xml`,
2024-09-30 22:35:37 -05:00
);
2025-01-14 19:22:41 -06:00
const maps = await readYAMLDVPL<Maps>(`${DATA}/maps.yaml`);
2024-10-05 23:20:04 -05:00
const tankXps = new Map<number, ResearchCost>();
2024-09-30 22:35:37 -05:00
const camouflagesXml = await readXMLDVPL<{ root: CamouflagesXML }>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/camouflages.xml`,
2024-09-30 22:35:37 -05:00
);
const camouflagesYaml = await readYAMLDVPL<CamouflagesYaml>(
2025-01-14 19:22:41 -06:00
`${DATA}/camouflages.yaml`,
2024-09-30 22:35:37 -05:00
);
const camouflagesXmlEntries = Object.entries(camouflagesXml.root.camouflages);
const squadBattleTypeStyles = await readYAMLDVPL<SquadBattleTypeStyles>(
2025-01-14 19:22:41 -06:00
`${DATA}/UI/Screens3/Lobby/Hangar/Squad/SquadBattleType.yaml`,
2024-09-30 22:35:37 -05:00
);
const gameTypeSelectorStyles = await readYAMLDVPL<SquadBattleTypeStyles>(
2025-01-14 19:22:41 -06:00
`${DATA}/UI/Screens/Lobby/Hangar/GameTypeSelector.yaml`,
2024-09-30 22:35:37 -05:00
);
const gameModeNativeNames: Record<string, number> = {};
const combatRoles = await readYAMLDVPL<CombatRolesYaml>(
2025-01-14 19:22:41 -06:00
`${DATA}/XML/item_defs/vehicles/common/combat_roles.yaml`,
2024-09-30 22:35:37 -05:00
);
const consumableNativeNames: Record<string, number> = {};
const provisionNativeNames: Record<string, number> = {};
for (const match of squadBattleTypeStyles.Prototypes[0].components.UIDataLocalBindingsComponent.data[1][2].matchAll(
/"(\d+)" -> "(battleType\/([a-zA-Z]+))"/g,
)) {
const id = Number(match[1]);
2025-01-14 14:38:41 -06:00
const name = getString(match[2]);
2024-09-30 22:35:37 -05:00
gameModeNativeNames[match[3]] = id;
gameDefinitions.gameModes[id] = {
name,
};
}
for (const match of gameTypeSelectorStyles.Prototypes[0].components.UIDataLocalBindingsComponent.data[1][2].matchAll(
/eGameMode\.([a-zA-Z]+) -> "~res:\/Gfx\/UI\/Hangar\/GameTypes\/battle-type_([^"]+)"/g,
)) {
Object.entries(gameModeNativeNames).forEach(([key, value]) => {
if (key.toLowerCase() === match[2].toLowerCase()) {
gameModeNativeNames[match[1]] = value;
}
});
}
camouflagesXmlEntries.forEach(([camoKey, camo]) => {
const yamlEntry = camouflagesYaml[camoKey];
const fullName = yamlEntry.userString
2025-01-14 14:38:41 -06:00
? getString(yamlEntry.userString)
2024-09-30 22:35:37 -05:00
: undefined;
const shortName = yamlEntry.shortUserString
2025-01-14 14:38:41 -06:00
? getString(yamlEntry.shortUserString)
2024-09-30 22:35:37 -05:00
: undefined;
const resolvedTankName = shortName ?? fullName;
const resolvedTankNameFull =
resolvedTankName === fullName ? undefined : fullName;
camouflageDefinitions.camouflages[camo.id] = {
id: camo.id,
2025-01-14 14:38:41 -06:00
name: getString(camo.userString),
2024-10-07 19:37:38 -05:00
tank_name: resolvedTankName,
tank_name_full: resolvedTankNameFull,
2024-09-30 22:35:37 -05:00
};
});
2025-05-16 19:14:56 -05:00
const slugRequesters = new Map<string, { id: number; key: string }[]>();
const idToNation: Record<number, string> = {};
2025-07-31 13:40:30 -05:00
for (const nation of nations) {
const tankList = await readXMLDVPL<{ root: VehicleDefinitionList }>(
`${DATA}/XML/item_defs/vehicles/${nation}/list.xml`,
);
2025-05-16 19:14:56 -05:00
2025-07-31 13:40:30 -05:00
for (const tankKey in tankList.root) {
if (botPattern.test(tankKey)) continue;
2025-05-16 19:14:56 -05:00
2025-07-31 13:40:30 -05:00
const tank = tankList.root[tankKey];
const tankId = toUniqueId(nation, tank.id);
2025-05-16 19:14:56 -05:00
2025-07-31 13:40:30 -05:00
const name = (
(tank.shortUserString ? getString(tank.shortUserString) : undefined) ??
getString(tank.userString)
).locales.en;
2025-05-16 19:14:56 -05:00
2025-07-31 13:40:30 -05:00
let slug = deburr(name).toLowerCase();
slug = slug.replaceAll(nonAlphanumericRegex, '-');
slug = slug.replaceAll(multipleDashesRegex, '-');
slug = slug.replaceAll(trailingDashRegex, '');
slug = slug.replaceAll(leadingDashRegex, '');
2025-05-16 19:14:56 -05:00
2025-07-31 13:40:30 -05:00
idToNation[tankId] = nation;
if (slugRequesters.has(slug)) {
slugRequesters.get(slug)!.push({ id: tankId, key: tankKey });
} else {
slugRequesters.set(slug, [{ id: tankId, key: tankKey }]);
2025-05-16 19:14:56 -05:00
}
2025-07-31 13:40:30 -05:00
}
}
2025-05-16 19:14:56 -05:00
const slugs = new Map<number, string>();
slugRequesters.forEach((requesters, slug) => {
if (requesters.length === 1) {
slugs.set(requesters[0].id, slug);
return;
}
console.warn(
`Multiple tanks share slug ${slug}: ${requesters.map(({ key }) => key).join(', ')}`,
);
if (requesters.length !== 2) {
throw new Error('Unresolvable number of duplicates :(');
}
const nonCanonical = requesters.find(({ key }) => key.endsWith('TUR'));
if (nonCanonical === undefined) {
console.log('Using nations to discriminate');
// both are non-tutorial tanks, will have to discriminate using nation
requesters.forEach(({ id, key }) => {
const nation = idToNation[id];
const discriminator =
nationSlugDiscriminators[
nation as keyof typeof nationSlugDiscriminators
];
console.log(`Solution: ${key} -> ${slug}-${discriminator}`);
slugs.set(id, `${slug}-${discriminator}`);
});
} else {
console.log('Using tutorial bot suffix to discriminate');
const canonical = requesters.find(({ key }) => !key.endsWith('TUR'));
if (canonical === undefined) {
throw new Error(
'Two tutorial bots share the same slug? The world is truly broken.',
);
}
console.log(`Solution: ${canonical.key} -> ${slug}`);
slugs.set(canonical.id, slug);
console.log(`Solution: ${nonCanonical.key} -> ${slug}-tur`);
slugs.set(nonCanonical.id, `${slug}-tur`);
}
});
2025-07-31 13:40:30 -05:00
for (const nation of nations) {
const tankList = await readXMLDVPL<{ root: VehicleDefinitionList }>(
`${DATA}/XML/item_defs/vehicles/${nation}/list.xml`,
);
const turretList = await readXMLDVPL<{
root: TurretDefinitionsList;
}>(`${DATA}/XML/item_defs/vehicles/${nation}/components/turrets.xml`);
const gunList = await readXMLDVPL<{
root: GunDefinitionsList;
}>(`${DATA}/XML/item_defs/vehicles/${nation}/components/guns.xml`);
const shellList = await readXMLDVPL<{
root: ShellDefinitionsList;
}>(`${DATA}/XML/item_defs/vehicles/${nation}/components/shells.xml`);
const enginesList = await readXMLDVPL<{
root: EngineDefinitionsList;
}>(`${DATA}/XML/item_defs/vehicles/${nation}/components/engines.xml`);
const chassisList = await readXMLDVPL<{
root: ChassisDefinitionsList;
}>(`${DATA}/XML/item_defs/vehicles/${nation}/components/chassis.xml`);
function resolveUnlocks(unlocks?: BlitzModuleType) {
if (!unlocks) return [];
return Object.entries(unlocks)
.map(([type, list]) =>
(Array.isArray(list) ? list : [list]).map((item) => {
const typeTyped = type as keyof BlitzModuleType;
let rawId: number;
if (typeTyped === 'chassis') {
rawId = chassisList.root.ids[item['#text']];
} else if (typeTyped === 'engine') {
rawId = enginesList.root.ids[item['#text']];
} else if (typeTyped === 'gun') {
rawId = gunList.root.ids[item['#text']];
} else if (typeTyped === 'turret') {
rawId = turretList.root.ids[item['#text']];
} else if (typeTyped === 'vehicle') {
rawId = tankList.root[item['#text']].id;
}
return {
id: toUniqueId(nation, rawId!),
type: blitzModuleTypeToBlitzkit[typeTyped],
cost: {
type:
typeof item.cost === 'number'
? 'xp'
: item.cost.split(':')[0],
value:
typeof item.cost === 'number'
? item.cost
: Number(item.cost.split(':')[1]),
},
} satisfies Unlock;
}),
)
.flat();
}
for (const tankKey in tankList.root) {
if (botPattern.test(tankKey)) continue;
const gunXps = new Map<number, ResearchCost>();
const turretXps = new Map<number, ResearchCost>();
const engineXps = new Map<number, ResearchCost>();
const trackXps = new Map<number, ResearchCost>();
const tank = tankList.root[tankKey];
let tankPrice: TankPrice;
const tankDefinition = await readXMLDVPL<{ root: VehicleDefinitions }>(
`${DATA}/XML/item_defs/vehicles/${nation}/${tankKey}.xml`,
2024-09-30 22:35:37 -05:00
);
2025-07-31 13:40:30 -05:00
const tankParameters = await readYAMLDVPL<TankParameters>(
`${DATA}/3d/Tanks/Parameters/${nation}/${tankKey}.yaml`,
);
const turretOrigin = tankDefinition.root.hull.turretPositions.turret
.split(' ')
.map(Number) as Vector3Tuple;
const tankId = toUniqueId(nation, tank.id);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
const tankTags = tank.tags.split(' ');
const hullArmor: Armor = { spaced: [], thickness: {} };
const equipment = tankDefinition.root.optDevicePreset;
tankStringIdMap[`${nation}:${tankKey}`] = tankId;
const slug = slugs.get(tankId);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
if (slug === undefined) {
throw new Error(
`Could not find slug for ${nation}/${tankKey} (${tankId})`,
);
2024-09-30 22:35:37 -05:00
}
2025-07-31 13:40:30 -05:00
if (tank.sellPrice) {
tankPrice = {
type: TankPriceType.GOLD,
value: tank.sellPrice['#text'] * 2,
};
} else if (typeof tank.price === 'number') {
tankPrice = {
type: TankPriceType.CREDITS,
value: tank.price,
};
} else {
tankPrice = {
type: TankPriceType.CREDITS,
value: tank.price['#text'] * 400,
};
}
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.keys(tankDefinition.root.hull.armor)
.filter((name) => name.startsWith('armor_'))
.forEach((name) => {
const armorIdString = name.match(/armor_(\d+)/)?.[1];
if (armorIdString === undefined) {
throw new SyntaxError(`Invalid armor id: ${name}`);
}
const armorId = parseInt(armorIdString);
const armorRaw = tankDefinition.root.hull.armor[name];
if (typeof armorRaw === 'number') {
hullArmor.thickness[armorId] = armorRaw;
} else {
if (!hullArmor.spaced) hullArmor.spaced = [];
hullArmor.thickness[armorId] = armorRaw['#text'];
hullArmor.spaced.push(armorId);
}
});
const crew: Crew[] = [];
const fixedCamouflage = tankTags.includes('eventCamouflage_user');
const totalUnlocks: UnlocksListing[] = [];
Object.entries(tankDefinition.root.crew).forEach(([crewKey, value]) => {
let entry: Crew;
const index = crew.findIndex(
({ type }) => blitzkitCrewTypeToBlitz[type] === crewKey,
2024-09-30 22:35:37 -05:00
);
2025-07-31 13:40:30 -05:00
if (index === -1) {
if (crewKey === '#text') return;
entry = {
type: blitzCrewTypeToBlitzkit[crewKey as BlitzCrewType],
count: 0,
substitute: [],
};
crew.push(entry);
} else {
entry = crew[index];
}
if (typeof value === 'string') {
entry.count++;
if (value !== '') {
entry.substitute = value.split(/\n| /).map((member) => {
return blitzCrewTypeToBlitzkit[member.trim() as BlitzCrewType];
});
}
} else {
if (entry.count === undefined) {
entry.count = value.length;
} else {
entry.count += value.length;
}
}
});
const camouflages = camouflagesXmlEntries
.filter(([, camo]) => {
if (!camo.vehicleFilter.include) return false;
if (camo.unlockCostCategory !== 'legendary-skins-gold') return false;
const includeArray = Array.isArray(camo.vehicleFilter.include)
? camo.vehicleFilter.include
: [camo.vehicleFilter.include];
return includeArray.some((filter) => {
if ('vehicle' in filter && filter.vehicle?.name) {
return filter.vehicle.name === `${nation}:${tankKey}`;
}
return false;
});
})
.map(([, camo]) => camo.id);
tankDefinitions.tanks[tankId] = {
ancestors: [],
successors: [],
id: tankId,
roles: {},
camouflages: camouflages,
fixed_camouflage: fixedCamouflage,
crew,
weight: tankDefinition.root.hull.weight,
health: tankDefinition.root.hull.maxHealth,
speed_forwards: tankDefinition.root.speedLimits.forward,
speed_backwards: tankDefinition.root.speedLimits.backward,
equipment_preset:
typeof equipment === 'string' ? equipment : equipment.at(-1)!,
max_consumables: tankDefinition.root.consumableSlots,
max_provisions: tankDefinition.root.provisionSlots,
name:
(tank.shortUserString
? getString(tank.shortUserString)
: undefined) ?? getString(tank.userString),
slug,
nation,
type: tankTags.includes('collectible')
? TankType.COLLECTOR
: (typeof tank.price === 'number' ? false : 'gold' in tank.price)
? TankType.PREMIUM
: TankType.RESEARCHABLE,
tier: tank.level,
class: blitzTankClassToBlitzkit[tankTags[0] as BlitzTankClass],
testing: tankTags.includes('testTank'),
deprecated: tankTags.includes('deprecated'),
price: tankPrice,
camouflage_still: tankDefinition.root.invisibility.still,
camouflage_moving: tankDefinition.root.invisibility.moving,
camouflage_onFire: tankDefinition.root.invisibility.firePenalty,
turrets: [],
engines: [],
tracks: [],
};
if (tank.combatRole) {
Object.entries(tank.combatRole).forEach(([gameMode, role]) => {
const id = Object.entries(gameModeNativeNames).find(
([key]) => key.toLowerCase() === gameMode.toLowerCase(),
)?.[1];
if (id === undefined) {
throw new Error(
`Unknown game mode in tank ${tankKey}: ${gameMode}`,
);
}
tankDefinitions.tanks[tankId].roles[id] = combatRoles[role].id;
});
}
modelDefinitions.models[tankId] = {
armor: hullArmor,
turret_origin: vector3TupleToBlitzkit(turretOrigin),
initial_turret_rotation: tankDefinition.root.hull.turretInitialRotation
? {
yaw: tankDefinition.root.hull.turretInitialRotation.yaw,
pitch: tankDefinition.root.hull.turretInitialRotation.pitch,
roll: tankDefinition.root.hull.turretInitialRotation.roll,
}
: undefined,
bounding_box: {
min: vector3TupleToBlitzkit(tankParameters.collision.hull.bbox.min),
max: vector3TupleToBlitzkit(tankParameters.collision.hull.bbox.max),
},
turrets: {},
tracks: {},
};
Object.keys(tankDefinition.root.chassis).forEach((key) => {
const track = tankDefinition.root.chassis[key];
const trackId = toUniqueId(nation, chassisList.root.ids[key]);
const terrainResistances = track.terrainResistance
.split(' ')
.map(Number);
const trackArmorRaw = track.armor.leftTrack;
const hullOrigin = track.hullPosition
2024-09-30 22:35:37 -05:00
.split(' ')
.map(Number) as Vector3Tuple;
2025-05-16 22:11:01 -05:00
2025-07-31 13:40:30 -05:00
totalUnlocks.push(track.unlocks);
tankDefinitions.tanks[tankId].tracks.push({
id: trackId,
weight: track.weight,
name: getString(track.userString),
traverse_speed: track.rotationSpeed,
dispersion_move: track.shotDispersionFactors.vehicleMovement,
dispersion_traverse: track.shotDispersionFactors.vehicleRotation,
resistance_hard: terrainResistances[0],
resistance_medium: terrainResistances[1],
resistance_soft: terrainResistances[2],
tier: track.level,
unlocks: resolveUnlocks(track.unlocks),
2024-09-30 22:35:37 -05:00
});
2025-07-31 13:40:30 -05:00
modelDefinitions.models[tankId].tracks[trackId] = {
thickness:
typeof trackArmorRaw === 'number'
? trackArmorRaw
: trackArmorRaw['#text'],
origin: vector3TupleToBlitzkit(hullOrigin),
2024-09-30 22:35:37 -05:00
};
2025-07-31 13:40:30 -05:00
});
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.keys(tankDefinition.root.engines).forEach((engineKey) => {
const engine = tankDefinition.root.engines[engineKey];
const engineListEntry = enginesList.root.shared[engineKey];
const engineId = toUniqueId(nation, enginesList.root.ids[engineKey]);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
totalUnlocks.push(engine.unlocks);
tankDefinitions.tanks[tankId].engines.push({
id: engineId,
name: getString(engineListEntry.userString),
fire_chance: engineListEntry.fireStartingChance,
tier: engineListEntry.level,
weight: engineListEntry.weight,
power: engineListEntry.power,
unlocks: resolveUnlocks(engine.unlocks),
});
});
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.keys(tankDefinition.root.turrets0).forEach(
(turretKey, turretIndex) => {
const turret = tankDefinition.root.turrets0[turretKey];
const turretModel = Number(
parsePath(turret.models.undamaged).name.split('_')[1],
);
const turretId = toUniqueId(nation, turretList.root.ids[turretKey]);
const turretYaw = (
typeof turret.yawLimits === 'string'
? turret.yawLimits
: turret.yawLimits.at(-1)!
)
2024-09-30 22:35:37 -05:00
.split(' ')
2025-07-31 13:40:30 -05:00
.map(Number) as [number, number];
const gunOrigin = (
typeof turret.gunPosition === 'string'
? turret.gunPosition
: turret.gunPosition[0]
)
2024-09-30 22:35:37 -05:00
.split(' ')
.map(Number) as Vector3Tuple;
2025-07-31 13:40:30 -05:00
const turretArmor: Armor = { thickness: {}, spaced: [] };
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
totalUnlocks.push(turret.unlocks);
Object.keys(turret.armor)
.filter((name) => name.startsWith('armor_'))
.forEach((name) => {
const armorIdString = name.match(/armor_(\d+)/)?.[1];
if (armorIdString === undefined) {
throw new SyntaxError(`Invalid armor id: ${name}`);
}
const armorId = parseInt(armorIdString);
const armorRaw = turret.armor[name];
if (typeof armorRaw === 'number') {
turretArmor.thickness[armorId] = armorRaw;
} else {
if (!turretArmor.spaced) turretArmor.spaced = [];
turretArmor.thickness[armorId] = armorRaw['#text'];
turretArmor.spaced.push(armorId);
}
});
turret.userString;
tankDefinitions.tanks[tankId].turrets.push({
id: turretId,
traverse_speed: turret.rotationSpeed,
name: getString(turret.userString),
tier: turret.level,
guns: [],
health: turret.maxHealth,
view_range: turret.circularVisionRadius,
weight: turret.weight,
unlocks: resolveUnlocks(turret.unlocks),
2024-09-30 22:35:37 -05:00
});
2025-07-31 13:40:30 -05:00
modelDefinitions.models[tankId].turrets[turretId] = {
armor: turretArmor,
gun_origin: vector3TupleToBlitzkit(gunOrigin),
model_id: turretModel,
yaw:
-turretYaw[0] + turretYaw[1] === 360
? undefined
: { min: turretYaw[0], max: turretYaw[1] },
guns: {},
bounding_box: {
min: vector3TupleToBlitzkit(
tankParameters.collision[
parsePath(turret.hitTester.collisionModel).name.toLowerCase()
].bbox.min,
),
max: vector3TupleToBlitzkit(
tankParameters.collision[
parsePath(turret.hitTester.collisionModel).name.toLowerCase()
].bbox.max,
),
},
2024-09-30 22:35:37 -05:00
};
2025-07-31 13:40:30 -05:00
Object.keys(turret.guns).forEach((gunKey, gunIndex) => {
const gun = turret.guns[gunKey];
const gunId = toUniqueId(nation, gunList.root.ids[gunKey]);
const gunListEntry = gunList.root.shared[gunKey];
const pitchLimitsRaw = gun.pitchLimits ?? gunListEntry.pitchLimits;
const gunPitch = (
typeof pitchLimitsRaw === 'string'
? pitchLimitsRaw
: pitchLimitsRaw.at(-1)!
2024-09-30 22:35:37 -05:00
)
.split(' ')
.map(Number) as [number, number];
2025-07-31 13:40:30 -05:00
const gunModel = Number(
parsePath(gun.models.undamaged).name.split('_')[1],
);
const gunName = getString(gunListEntry.userString);
const gunType =
'clip' in gun
? gun.pumpGunMode
? 'autoReloader'
: 'autoLoader'
: 'regular';
// const gunReload = gun.reloadTime;
// const shellReloads =
const gunClipCount = gunType === 'regular' ? 1 : gun.clip!.count;
const front = gun.extraPitchLimits?.front
? gun.extraPitchLimits.front.split(' ').map(Number)
: undefined;
const back = gun.extraPitchLimits?.back
? gun.extraPitchLimits.back.split(' ').map(Number)
: undefined;
const transition = gun.extraPitchLimits?.transition
? typeof gun.extraPitchLimits.transition === 'number'
? gun.extraPitchLimits.transition
: gun.extraPitchLimits.transition.at(-1)!
: undefined;
const gunArmor: Armor = { thickness: {}, spaced: [] };
const shotDispersionFactors =
gun.shotDispersionFactors ?? gunListEntry.shotDispersionFactors;
const maskName = `gun_${gunModel.toString().padStart(2, '0')}`;
const maskEnabled =
tankParameters.maskSlice?.[maskName]?.enabled ?? false;
let mask: number | undefined;
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
if (gun.extras?.trayShell) {
const kinds = gun.extras.trayShell.kinds
.split(' ')
.map((string) => {
const trimmed = string.trim();
if (trimmed in blitzShellKindToBlitzkit) {
return blitzShellKindToBlitzkit[trimmed as ShellKind];
}
throw new SyntaxError(`Invalid shell kind: ${trimmed}`);
});
const sectorNames = Object.keys(gun.extras.trayShell.sectors);
if (sectorNames.length !== 1 || sectorNames[0] !== 'sector') {
throw new SyntaxError('Invalid tray shell sector');
}
const sector = gun.extras.trayShell.sectors.sector;
gun.assault_ranges = {
ranges: sector.map((value) => ({
factor: value.factor,
distance: value.distance,
})),
};
}
if (maskEnabled) {
const maskRaw = tankParameters.maskSlice![maskName]!;
mask = maskRaw.planePosition[1];
} else {
mask = undefined;
}
totalUnlocks.push(gun.unlocks);
Object.keys(gun.armor)
2024-09-30 22:35:37 -05:00
.filter((name) => name.startsWith('armor_'))
.forEach((name) => {
const armorIdString = name.match(/armor_(\d+)/)?.[1];
if (armorIdString === undefined) {
throw new SyntaxError(`Invalid armor id: ${name}`);
}
const armorId = parseInt(armorIdString);
2025-07-31 13:40:30 -05:00
const armorRaw = gun.armor[name];
2024-09-30 22:35:37 -05:00
if (typeof armorRaw === 'number') {
2025-07-31 13:40:30 -05:00
gunArmor.thickness[armorId] = armorRaw;
2024-09-30 22:35:37 -05:00
} else {
2025-07-31 13:40:30 -05:00
if (!gunArmor.spaced) gunArmor.spaced = [];
gunArmor.thickness[armorId] = armorRaw['#text'];
gunArmor.spaced.push(armorId);
2024-09-30 22:35:37 -05:00
}
});
2025-07-31 13:40:30 -05:00
const base = {
id: gunId,
weight: gunListEntry.weight,
rotation_speed: gunListEntry.rotationSpeed,
name: gunName,
tier: gunListEntry.level,
shells: [],
camouflage_loss:
typeof gun.invisibilityFactorAtShot === 'number'
? gun.invisibilityFactorAtShot
: gun.invisibilityFactorAtShot.at(-1)!,
aim_time: gun.aimingTime ?? gunListEntry.aimingTime,
dispersion_base:
gun.shotDispersionRadius ?? gunListEntry.shotDispersionRadius,
dispersion_damaged: shotDispersionFactors.whileGunDamaged,
dispersion_shot: shotDispersionFactors.afterShot,
dispersion_traverse: shotDispersionFactors.turretRotation,
unlocks: resolveUnlocks(gun.unlocks),
shell_capacity: gun.maxAmmo ?? gunListEntry.maxAmmo,
} satisfies GunDefinitionBase;
2025-01-14 14:38:41 -06:00
2025-07-31 13:40:30 -05:00
tankDefinitions.tanks[tankId].turrets[turretIndex].guns.push({
gun_type:
gunType === 'regular'
? {
$case: 'regular',
value: {
base,
extension: { reload: gun.reloadTime },
},
}
: gunType === 'autoReloader'
? {
$case: 'auto_reloader',
value: {
base,
extension: {
intra_clip: 60 / gun.clip!.rate,
shell_count: gunClipCount,
shell_reloads: gun
.pumpGunReloadTimes!.split(' ')
.map(Number),
},
},
}
: {
$case: 'auto_loader',
value: {
base,
extension: {
intra_clip: 60 / gun.clip!.rate,
clip_reload: gun.reloadTime,
shell_count: gunClipCount,
},
},
},
} satisfies GunDefinition);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
modelDefinitions.models[tankId].turrets[turretId].guns[gunId] = {
armor: gunArmor,
model_id: gunModel,
mask,
thickness:
gun.armor.gun === undefined
? 0
: typeof gun.armor.gun === 'number'
? gun.armor.gun
: gun.armor.gun['#text'],
pitch: {
min: gunPitch[0],
max: gunPitch[1],
front: front
? {
min: front[0],
max: front[1],
range: front[2],
}
: undefined,
back: back
? {
min: back[0],
max: back[1],
range: back[2],
}
: undefined,
transition,
2024-09-30 22:35:37 -05:00
},
};
2025-07-31 13:40:30 -05:00
Object.keys(gunListEntry.shots).forEach((shellKey) => {
const gunShellEntry = gunListEntry.shots[shellKey];
const shell = shellList.root[shellKey];
const shellId = toUniqueId(nation, shell.id);
const shellName = getString(shell.userString);
const penetrationRaw = gunShellEntry.piercingPower
2024-09-30 22:35:37 -05:00
.split(' ')
2025-07-31 13:40:30 -05:00
.filter((penetrationString) => penetrationString !== '')
.map(Number);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
tankDefinitions.tanks[tankId].turrets[turretIndex].guns[
gunIndex
].gun_type!.value.base.shells.push({
id: shellId,
name: shellName,
velocity: gunShellEntry.speed,
armor_damage: shell.damage.armor,
module_damage: shell.damage.devices,
caliber: shell.caliber,
normalization: shell.normalizationAngle,
ricochet: shell.ricochetAngle,
type: blitzShellKindToBlitzkit[shell.kind],
explosion_radius:
shell.kind === 'HIGH_EXPLOSIVE'
? (shell.explosionRadius ?? 0)
2024-09-30 22:35:37 -05:00
: undefined,
2025-07-31 13:40:30 -05:00
icon: shell.icon,
penetration: {
near: penetrationRaw[0],
far: penetrationRaw[1],
2024-09-30 22:35:37 -05:00
},
2025-07-31 13:40:30 -05:00
range: gunShellEntry.maxDistance,
2024-09-30 22:35:37 -05:00
});
});
2025-07-31 13:40:30 -05:00
});
},
);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
totalUnlocks.forEach((unlocks) => {
if (unlocks === undefined) return;
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.entries(unlocks).forEach(([key, value]) => {
(Array.isArray(value) ? value : [value]).forEach((vehicle) => {
switch (key as keyof BlitzModuleType) {
case 'vehicle': {
const tankListEntry = tankList.root[vehicle['#text']];
const currentTank = tankDefinitions.tanks[tankId];
const successorId = toUniqueId(nation, tankListEntry.id);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
tankXps.set(successorId, parseResearchCost(vehicle.cost));
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
if (currentTank.successors === undefined) {
currentTank.successors = [];
2024-09-30 22:35:37 -05:00
}
2025-07-31 13:40:30 -05:00
if (!currentTank.successors!.includes(successorId)) {
currentTank.successors!.push(successorId);
2024-09-30 22:35:37 -05:00
}
2025-07-31 13:40:30 -05:00
break;
2024-09-30 22:35:37 -05:00
}
2025-07-31 13:40:30 -05:00
case 'gun': {
gunXps.set(
toUniqueId(nation, gunList.root.ids[vehicle['#text']]),
parseResearchCost(vehicle.cost),
);
break;
}
case 'turret': {
turretXps.set(
toUniqueId(nation, turretList.root.ids[vehicle['#text']]),
parseResearchCost(vehicle.cost),
);
break;
}
case 'engine': {
engineXps.set(
toUniqueId(nation, enginesList.root.ids[vehicle['#text']]),
parseResearchCost(vehicle.cost),
);
break;
}
case 'chassis': {
trackXps.set(
toUniqueId(nation, chassisList.root.ids[vehicle['#text']]),
parseResearchCost(vehicle.cost),
);
break;
}
}
2024-09-30 22:35:37 -05:00
});
});
2025-07-31 13:40:30 -05:00
});
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.values(tankDefinitions.tanks[tankId].turrets).forEach((turret) => {
turret.research_cost = turretXps.get(turret.id);
2024-09-30 22:35:37 -05:00
2025-07-31 13:40:30 -05:00
Object.values(turret.guns).forEach((gunRaw) => {
gunRaw.gun_type!.value.base.research_cost = gunXps.get(
gunRaw.gun_type!.value.base.id,
);
2024-09-30 22:35:37 -05:00
});
2025-07-31 13:40:30 -05:00
});
Object.values(tankDefinitions.tanks[tankId].engines).forEach((engine) => {
engine.research_cost = engineXps.get(engine.id);
});
Object.values(tankDefinitions.tanks[tankId].tracks).forEach((track) => {
track.research_cost = trackXps.get(track.id);
});
}
}
2024-09-30 22:35:37 -05:00
Object.values(tankDefinitions.tanks).forEach((tank) => {
2024-10-07 19:37:38 -05:00
tank.research_cost = tankXps.get(tank.id);
2024-09-30 22:35:37 -05:00
});
Object.values(tankDefinitions.tanks).forEach((tank) => {
tank.successors?.forEach((predecessorId) => {
if (!tankDefinitions.tanks[predecessorId].ancestors?.includes(tank.id)) {
tankDefinitions.tanks[predecessorId].ancestors?.push(tank.id);
}
});
});
Object.entries(optionalDevices.root).forEach(
([optionalDeviceKey, optionalDeviceEntry]) => {
if (optionalDeviceKey === 'nextAvailableId') return;
equipmentDefinitions.equipments[optionalDeviceEntry.id] = {
2025-01-14 14:38:41 -06:00
name: getString(optionalDeviceEntry.userString),
description: getString(optionalDeviceEntry.description),
2024-09-30 22:35:37 -05:00
};
},
);
Object.entries(optionalDeviceSlots.root.presets).forEach(
([optionalDeviceSlotKey, optionalDeviceSlotEntry]) => {
if (optionalDeviceSlotKey === 'emptyPreset') return;
2024-10-05 23:20:04 -05:00
equipmentDefinitions.presets[optionalDeviceSlotKey] = {
slots: Object.values(optionalDeviceSlotEntry)
.map((level) => {
return Object.values(level).map((options) => {
return {
left: optionalDevices.root[options.device0].id,
right: optionalDevices.root[options.device1].id,
} satisfies EquipmentSlot;
});
})
.flat(),
};
2024-09-30 22:35:37 -05:00
},
);
Object.entries(consumables).forEach(([key, consumable]) => {
consumableNativeNames[key] = consumable.id;
const entry: Consumable = {
id: consumable.id,
2024-10-07 19:37:38 -05:00
game_mode_exclusive: 'gameModeFilter' in consumable,
2024-09-30 22:35:37 -05:00
cooldown: consumable.script.cooldown,
duration: consumable.script.duration,
2025-01-14 14:38:41 -06:00
name: getString(consumable.userString),
2024-09-30 22:35:37 -05:00
exclude: [],
include: [],
};
consumableDefinitions.consumables[consumable.id] = entry;
const includeRaw = consumable.vehicleFilter?.include.vehicle;
const excludeRaw = consumable.vehicleFilter?.exclude?.vehicle;
2024-10-07 19:37:38 -05:00
if (!entry.game_mode_exclusive) {
2024-09-30 22:35:37 -05:00
if (includeRaw) {
entry.include = [];
if ('minLevel' in includeRaw) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'tiers',
2024-11-12 21:38:00 -06:00
value: {
2024-11-20 10:26:55 -06:00
min: includeRaw.minLevel,
max: includeRaw.maxLevel,
2024-11-12 21:38:00 -06:00
},
2024-10-05 15:24:54 -05:00
},
2024-09-30 22:35:37 -05:00
});
} else if ('name' in includeRaw) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'ids',
2024-10-05 23:20:04 -05:00
value: {
ids: includeRaw.name.split(/ +/).map((key) => {
return tankStringIdMap[key];
}),
2024-10-05 15:24:54 -05:00
},
2024-09-30 22:35:37 -05:00
},
});
} else throw new SyntaxError('Unhandled include type');
if (consumable.vehicleFilter?.include.nations) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'nations',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
nations: consumable.vehicleFilter.include.nations.split(' '),
},
2024-09-30 22:35:37 -05:00
},
});
}
}
if (excludeRaw) {
entry.exclude = [];
if ('name' in excludeRaw) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'ids',
2024-10-05 23:20:04 -05:00
value: {
ids: excludeRaw.name.split(/ +/).map((key) => {
return tankStringIdMap[key];
}),
2024-10-05 15:24:54 -05:00
},
2024-09-30 22:35:37 -05:00
},
});
} else if ('extendedTags' in excludeRaw) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'categories',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
categories: excludeRaw.extendedTags
.split(' ')
.map(
(item) =>
blitzTankFilterDefinitionCategoryToBlitzkit[
item as BlitzTankFilterDefinitionCategory
],
),
},
2024-09-30 22:35:37 -05:00
},
});
} else throw new SyntaxError('Unhandled exclude type');
if (consumable.vehicleFilter?.exclude?.nations) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'nations',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
nations: consumable.vehicleFilter.exclude.nations.split(' '),
},
2024-09-30 22:35:37 -05:00
},
});
}
}
}
});
Object.entries(provisions).forEach(([key, provision]) => {
provisionNativeNames[key] = provision.id;
const entry: Provision = {
id: provision.id,
exclude: [],
include: [],
2024-10-07 19:37:38 -05:00
game_mode_exclusive: 'gameModeFilter' in provision,
2025-01-14 14:38:41 -06:00
name: getString(provision.userString),
2024-09-30 22:35:37 -05:00
};
provisionDefinitions.provisions[provision.id] = entry;
const includeRaw = provision.vehicleFilter?.include.vehicle;
const excludeRaw = provision.vehicleFilter?.exclude?.vehicle;
2024-10-07 19:37:38 -05:00
if (!entry.game_mode_exclusive) {
2024-09-30 22:35:37 -05:00
if (includeRaw) {
entry.include = [];
if ('minLevel' in includeRaw) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'tiers',
2024-10-05 23:20:04 -05:00
value: {
2024-11-20 10:26:55 -06:00
min: includeRaw.minLevel,
max: includeRaw.maxLevel,
2024-10-05 15:24:54 -05:00
},
2024-09-30 22:35:37 -05:00
},
});
} else if ('name' in includeRaw) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'ids',
2024-10-05 23:20:04 -05:00
value: {
ids: includeRaw.name.split(/ +/).map((key) => {
return tankStringIdMap[key];
}),
2024-10-05 15:24:54 -05:00
},
2024-09-30 22:35:37 -05:00
},
});
} else throw new SyntaxError('Unhandled include type');
if (provision.vehicleFilter?.include.nations) {
entry.include.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'nations',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
nations: provision.vehicleFilter.include.nations.split(' '),
},
2024-09-30 22:35:37 -05:00
},
});
}
}
if (excludeRaw) {
entry.exclude = [];
if ('name' in excludeRaw) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'ids',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
ids: excludeRaw.name
2024-10-05 23:20:04 -05:00
.split(/ +/)
2024-10-05 15:24:54 -05:00
.map((key) => tankStringIdMap[key]),
},
2024-09-30 22:35:37 -05:00
},
});
} else if ('extendedTags' in excludeRaw) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'categories',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
categories: excludeRaw.extendedTags
.split(' ')
.map(
(item) =>
blitzTankFilterDefinitionCategoryToBlitzkit[
item as BlitzTankFilterDefinitionCategory
],
),
},
2024-09-30 22:35:37 -05:00
},
});
} else throw new SyntaxError('Unhandled exclude type');
if (provision.vehicleFilter?.exclude?.nations) {
entry.exclude!.push({
2024-10-07 19:37:38 -05:00
filter_type: {
2024-10-05 15:24:54 -05:00
$case: 'nations',
2024-10-05 23:20:04 -05:00
value: {
2024-10-05 15:24:54 -05:00
nations: provision.vehicleFilter.exclude.nations.split(' '),
},
2024-09-30 22:35:37 -05:00
},
});
}
}
}
if (provision.script.bonusValues?.crewLevelIncrease !== undefined) {
provisionDefinitions.provisions[provision.id].crew =
provision.script.bonusValues?.crewLevelIncrease;
}
});
Object.entries(combatRoles).forEach(([, value]) => {
gameDefinitions.roles[value.id] = { provisions: [], consumables: [] };
value.default_abilities.forEach((ability) => {
if (ability in consumableNativeNames) {
gameDefinitions.roles[value.id].consumables.push(
consumableNativeNames[ability],
);
} else if (ability in provisionNativeNames) {
gameDefinitions.roles[value.id].provisions.push(
provisionNativeNames[ability],
);
} else throw new Error(`Unknown ability ${ability}`);
});
});
Object.entries(avatar.root.skillsByClasses).forEach(([tankClass, skills]) => {
skillDefinitions.classes[
blitzTankClassToBlitzkit[tankClass as BlitzTankClass]
] = {
skills: skills.split(' '),
};
});
Object.entries(maps.maps).forEach(([key, map]) => {
mapDefinitions.maps[map.id] = {
id: map.id,
2025-01-14 14:38:41 -06:00
name: getString(`#maps:${key}:${map.localName}`),
2024-09-30 22:35:37 -05:00
};
});
2025-07-31 13:40:30 -05:00
return;
2024-09-30 22:35:37 -05:00
await commitAssets('definitions', [
{
2025-06-07 12:35:23 -05:00
content: GameDefinitions.encode(gameDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/game.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: TankDefinitions.encode(tankDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/tanks.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: ModelDefinitions.encode(modelDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/models.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: EquipmentDefinitions.encode(equipmentDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/equipment.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: ConsumableDefinitions.encode(consumableDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/consumables.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: ProvisionDefinitions.encode(provisionDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/provisions.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: SkillDefinitions.encode(skillDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/skills.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: MapDefinitions.encode(mapDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/maps.pb',
2024-09-30 22:35:37 -05:00
},
{
2025-06-07 12:35:23 -05:00
content: CamouflageDefinitions.encode(camouflageDefinitions).finish(),
2024-10-05 23:20:04 -05:00
path: 'definitions/camouflages.pb',
2024-09-30 22:35:37 -05:00
},
]);
2023-12-05 19:14:53 -06:00
}