Editing Textdata rankingitem.txt

'''<code>rankingitem.txt</code>''' (3,190 bytes, part of [[BIN textdata]]) lists the weekly ranking-shop reward items.

== Format ==

117 rows = 13 weeks × 9 slots. Both consumers index it as <code>line = (week − 1) × 9 + slot</code> (week from the in-game clock; slot from the ranking panel button / the NPC's subtype) and <code>sscanf</code> only <code>%*d,%*d,%d,%d</code>:

{| class="wikitable"
! col !! meaning
|-
| 1 || week (1–13) — the row's own coordinate, not read directly
|-
| 2 || slot (0–8) — likewise positional
|-
| 3 || '''reward item dat file id'''
|-
| 4 || '''reward item entry index'''
|-
| 5–10 || not read by either client consumer (slots 6–8 stash extra <code>dat,entry</code> pairs in cols 5–8, unused here; likely legacy/server-side)
|}

== NPC subtype → slot table ==

Each ranking-shop NPC is bound to a slot via a hardcoded subtype→slot table at <code>0x4e2f30</code> (11 <code>byte(subtype), byte(slot)</code> pairs):

{| class="wikitable"
! NPC subtype !! slot !! !! NPC subtype !! slot
|-
| 1 || 0 || || 56 || 4
|-
| 11 || 1 || || 66 || 5
|-
| 24 || 1 || || 76 || 5
|-
| 30 || 2 || || 82 || 5
|-
| 40 || 2 || || 86 || 5
|-
| 46 || 3 || ||  ||
|}

So 11 NPC subtypes map to 6 slots (0–5), exactly the 6 item rows the panel exposes; the <code>dat=entry=0</code> rows (slots 6–8) are unreachable/control rows. Full lookup: <code>item = rankingitem[(week−1)*9 + slotTable[npc.subtype]]</code>, cols 3/4.

== Loading (Ghidra) ==

String address <code>004defc8</code>. Consumers: <code>cpt_panel_ranking_widget_OnClick @ 004295d2</code>; <code>State_NpcRankingShop_Tick @ 0046943f</code>. <code>State_NpcRankingShop_Tick</code> reads the subtype table with <code>npcObj+5</code>.

== See also ==

* [[BIN textdata]]
* [[textdata cpt_panel_ranking_msg.txt]]
* [[textdata NN.dat]] — the reward item records this table points into