# FIFA 17 FUT — Card Taxonomy (single source of truth)

Status: verified 2026-08-12. This document supersedes every earlier scattered
taxonomy claim in the repo (see "Superseded taxonomy" at the bottom).

Evidence labels: **OBSERVED** = read directly from a shipped table or decompiled
function; **INFERRED** = derived from OBSERVED facts; **HYPOTHESIS** = plausible,
not yet proven. `UNKNOWN` is a valid answer and is stated as such.

## Provenance

- Authoritative tables: `10.10.0.105:/home/alex/Documents/OpenFUT/fifa17-recon/data/tables/`,
  copied byte-identical into this repo at `fifa17-recon/data/tables/`.
  SHA-256 manifest + verification: `docs/evidence/fifa17-recon/table-hashes.sha256`
  (36 files: 31 `fcc_*.json` + 5 staff tables; combined hash-of-hashes
  `10f239add919089354d8dbff873fc9737b0a0f80f6ac41b1aa2a096c0ec8d331`).
- Each table file is a DECODED dump `{table, source, rowcount, schema[], rows[]}`;
  card instances are in `rows[]`, one object per card. Row counts and id ranges
  below were re-extracted from the in-repo `.120` copies.
- Semantic (subtype→kind) labels are decompiler-derived, carried in
  `fifa17-recon/tools/fut_consumables.py` (`BY_SUBTYPE`, `_DOC`), generated by
  `tools/build_consumables.py` from `FUN_1800d8330`, `FUN_18013f4d0`,
  `FUN_1801bfac0`, `FUN_1801aa230`, `FUN_180048780` + the fcc tables.
- Staff family selection: `fifa17-recon/docs/CARD_SYSTEM.md` (2026-08-04/05 blocks)
  and `fifa17-recon/tools/fut_staff.py` / `fut_coaches.py`.

## Family selector (OBSERVED, binary)

Before registering an item, `FUN_180141660` merges the client's local DB. It
switches on record `+0x4c` (`cardtype`), which `FUN_1800d8330` derives from JSON
atom `0x6c cardsubtypeid` alone:

```
cardsubtypeid 0..3 -> cardtype 1   players
              4    -> cardtype 2   managercards
              5    -> cardtype 3   headcoachcards
              6    -> cardtype 10  gkcoachcards
              7    -> cardtype 5   physiocards
              8    -> cardtype 4   fitnesscoachcards
              0x1e,0x1f,0x91..0x96,0xe7..0xe9,0xec -> cardtype 9  club items + misc
              absent (default 342) -> cardtype 0   no merge
```

Key: `carddbid == resourceId` for non-player families (queried RAW, no mask);
players are queried by `playerid = resourceId & 0xffffff` (atom `0x287`), and
`assetId` (atom `0x23`) is never read by the merge.

## Consumable & staff families — evidence table (OBSERVED, `.120` tables)

| Family | Table | Rows | carddbid range | cardsubtype set | cardassetid (ART) |
|---|---|---|---|---|---|
| Contracts | `fcc_contractcards.json` | 13 | 5001001–5001013 | {201, 202} | {7, 8} |
| Fitness + Healing | `fcc_healingcards.json` | 27 | 5002001–5002030 | {211,212,213,215,216,217,218,219,220} | {9, 10} |
| Training (6 sub-families) | `fcc_trainingcards.json` | 143 | 5003001–5003159 | 51-57, 61-67, 91-110, 121-136, 250-273, 300-340 | {1,3,32,34,35,50,51} |
| Misc | `fcc_misccards.json` | 42 | 5004001–5004042 | {231, 232, 233, 236} | {43, 44, 45, 46} |
| Badges | `fcc_badgecards.json` | 656 | 6000000–6000656 | (none in row) | {39} |
| Stadiums | `fcc_stadium.json` | 78 | 6200000–6200077 | (none in row) | {36} |
| Kits | `fcc_kitcards.json` | 1482 | 6300000–6400654 | (none in row) | {35} |
| League logos | `fcc_leaguelogos.json` | 44 | 8010000–8010044 | (none in row) | {40} |
| League logo stickers | `fcc_leaguelogostickers.json` | 39 | 8010000–8010039 | (none in row) | {40} |
| Balls | `fcc_balls.json` | 42 | 8120194–8120236 | (none in row) | {37} |
| Managers | `managercards.json` | 417 | 1000001–1001552 | (staff; by cardsubtypeid 4) | (assetid col) |
| Head coaches | `headcoachcards.json` | 124 | 2000004–2000328 | (staff; subtype 5) | — |
| GK coaches | `gkcoachcards.json` | 121 | 9000001–9000324 | (staff; subtype 6) | — |
| Physios | `physiocards.json` | 51 | 4000002–4000259 | (staff; subtype 7) | — |
| Fitness coaches | `fitnesscoachcards.json` | 115 | 3000019–3000328 | (staff; subtype 8) | — |

Notes:
- **Contracts (5001xxx)** — 201 = player_contract, 202 = manager_contract
  (OBSERVED, `BY_SUBTYPE`).
- **Fitness + Healing (5002xxx)** — subtype **214 is a valid enum value but ships
  ZERO rows** (OBSERVED: 214 absent from `rows[]`). Enum split (OBSERVED,
  `BY_SUBTYPE`): healing = 211-218, player_fitness = 219, squad_fitness = 220.
  The `+0x58 rareflag == 1` trap flips subtype 219 to squad-fitness.
- **Training (5003xxx)** — SIX sub-families, all OBSERVED in `rows[]` and labelled
  in `BY_SUBTYPE`:
  - `gk_training` 51-57 (7)
  - `player_training` 61-67 (7)
  - `position_mod` 91-110 (20)
  - `formation_mod` 121-136 (16)
  - chem/play styles 250-273 (24): `player_playstyle` 250-268 (19) +
    `gk_playstyle` 269-273 (5)
  - `manager_league` 300-**341** in the client enum (42), but the shipped table
    contains only 300-340 (41 rows) — 341 is defined, not shipped.
  - Client enum also defines vestigial/unshipped ranges NOT in the table:
    `manager_formation_mod` 71-86, and `DEAD_ZONE`
    58-60,68-70,87-90,111-120,203-210 (28). These have no rows.
- **Misc (5004xxx)** — subtypes {231,232,233,236}; cardassetid ART 43-46.
  cardsubtype 231 = 0xe7 anchors the 0xe7..0xe9 block to misc via `FUN_1800d8330`.
- **Club items (badges/stadiums/kits/logos/balls)** carry no `cardsubtype` in the
  row; they are keyed by `carddbid` range and distinguished on the wire by ART
  `cardassetid` (badges 39, stadium 36, kits 35, logos 40, balls 37). **Kits live
  at 6300000–6400654 and are NOT badges** (badges are 6000xxx). The client-side
  subtype→family map (which of 0x1e,0x1f,0x91..0x96 is ball vs stadium vs badge vs
  kit) is **UNKNOWN** — it is in none of the dumped tables and cardtype 9 has no
  miss-fill arm (see `CARD_SYSTEM.md`, "Club items", 2026-08-05).

## Staff — subtype/cardtype selectors (OBSERVED, binary)

| cardsubtypeid | cardtype | Family | Table | Rows | carddbid range |
|---|---|---|---|---|---|
| 4 | 2 | Manager | `managercards.json` | 417 | 1000001–1001552 |
| 5 | 3 | Head coach | `headcoachcards.json` | 124 | 2000004–2000328 |
| 6 | 10 | GK coach | `gkcoachcards.json` | 121 | 9000001–9000324 |
| 7 | 5 | Physio | `physiocards.json` | 51 | 4000002–4000259 |
| 8 | 4 | Fitness coach | `fitnesscoachcards.json` | 115 | 3000019–3000328 |

`cardsubtypeid -> rec+0x50` is the only family selector; `FUN_1800d8330` maps it to
`rec+0x4c cardtype`. Manager merge = `FUN_1801356c0` (queries `managercards` by
`carddbid` raw); coach merges live in the respective tables (`fut_coaches.py`).
All five render live with real photos/bonuses, zero "DB Error" (CARD_SYSTEM.md,
2026-08-05).

## Players (context, out of taxonomy scope here)

Players use cardsubtypeid 0..3 -> cardtype 1; merged by `playerid = resourceId &
0xffffff` against the local `players` table. Identity/name/nation/team come from
the client DB; rating/position/attributes come from our item JSON. See
`CARD_SYSTEM.md` and the migration work in `openfut-adapter-fifa17`.

## Superseded taxonomy (report only — no other files edited)

The earlier working taxonomy (in prior agent-session notes / long-term memory, and
partially in the original `TablesTaxonomy` scout output) got four things wrong.
Corrected here:

1. **Chemistry / play styles are 250-273, NOT 91-136.** 91-110 = `position_mod`,
   121-136 = `formation_mod`. (OBSERVED in `fcc_trainingcards` + `BY_SUBTYPE`.)
2. **6300xxx/6400xxx are KITS, not badges.** Badges are 6000xxx. (OBSERVED.)
3. **5004xxx misc cards exist** (subtypes 231/232/233/236, ART 43-46). Previously
   omitted. (OBSERVED, `fcc_misccards`.)
4. **8010xxx league logos exist** (+ stickers), ART 40. Previously omitted.
   (OBSERVED, `fcc_leaguelogos`.)

**Repo blast-radius of the superseded values: NONE.** A repo-wide grep
(`docs/`, `openfut-adapter-fifa17/`, `openfut-core/`, `fifa17-recon/`) for the wrong
claims (`91-136` chem styles; `6300/6400xxx` as badges) returns zero hits.
`fifa17-recon/docs/CARD_SYSTEM.md` and `plan-2026-08-06-card-subsystem.md` already
use the correct `250..273` for chem styles and the correct staff subtypes 4-8;
`CARD_SYSTEM.md` is a mechanism log, not a taxonomy, and asserts none of the wrong
ranges. The superseded values therefore live only in non-repo agent memory, which
should be corrected to point at this document.
