Weapon enhancement

Levelling, ascension and refinement are built, as the weapon enhancement page describes. What is left is a weapon's passive: each refinement rank changes it, and it acts through the character kits, so this page waits on them.

Decisions

• A passive is its table's numbers and a module. EquipAffixExcelConfigData holds a passive's name, description and numbers at each refinement rank, which the stats run reads. What the passive does is written as a small module over the kits' shared effects, as a character's own module is, since the game's own weapon configs (BinOutput/Talent/EquipTalents) are scrambled like its ability configs.
• A weapon's passive rows are its skill affix's. A weapon names its passive by its skillAffix group, and the rows of that group are its ranks by their level, from zero for rank one to four for rank five.
• The rows ride in the weapons' own chunk, flat and trimmed. weapons.json is already a chunk of its own, imported on demand, so the passive adds no chunk: each weapon gains passiveNameTextId and passiveDescriptionTextId ("" for a weapon with no skill affix) and passiveRankParams, one paramList per rank with the zeros past the longest rank's last used place cut ([] for none). The words stay text ids, never written into the per-language names chunk, until a screen shows them.
• The passive reads the weapon's rank. A weapon at refinement rank R reads the row of level R less one, so the rank kept with the weapon is the only input the module takes.

How it works

flowchart TD
  W["Weapon: refinement rank"] --> ROW["The passive's row at that rank, from the affix table"]
  ROW --> MODULE["The passive's module over the kits' shared effects"]
  MODULE --> FIGHT["The wielder's stats and combat"]

Scope and order

Today: a weapon's refinement rank is kept and paid for; nothing reads it as a passive, and the affix table is not read.

This adds, in order:

scripts/src/services/genshinAssets/stats/toWeaponPassive.ts

1. The affix table, read into each weapon. ExcelWeaponRow (scripts/src/models/genshinAssets/stats/ExcelWeaponRow.ts) gains skillAffix: number[] and descTextMapHash. A new toWeaponPassive.ts takes one affix id's rows of EquipAffixExcelConfigData (an ExcelEquipAffixRow, as getArtifactSetDatas reads them) and returns the three fields above, the rows ordered by level. getWeaponDatas groups the table by id, looks up each weapon's skillAffix[0] (0, for about a tenth of the weapons, is none) and spreads toWeaponPassive in, and WeaponData and weaponDataSchema gain the three fields. toWeaponPassive.test.ts asserts rows given out of order come back by rank, the zeros cut to the longest used place, and no rows give "", "" and []. pnpm -C scripts genshin:assets stats then rewrites packages/genshin-world/src/generated/stats/weapons.json.
2. Each passive as a module, read at its rank, once the character kits, the unit the other machine holds, hold the shared effects a passive acts through.

Data and measures

• Read from the game's tables: EquipAffixExcelConfigData, in the stats run, grouped by the weapon's skillAffix.
• Measured: nothing; the passive's words are the game's own, through game text by their text ids once they are keyed.

Key files

Sources

• AnimeGameData, the community's per-patch dump: EquipAffixExcelConfigData, and the scrambled weapon configs (BinOutput/Talent/EquipTalents).