Skip to content

Card format

Player cards are MIFARE Classic 1K (4K works the same). The firmware uses sector 1 with the factory default key A (FF FF FF FF FF FF). The sector trailer is never written, so every reader can still rewrite the card.

Identity = UID

The card stores only the nickname, for display and for older tools. The player's identity is the card's UID, which NestrisLTM links to the player. If someone renames a card with a phone app, games do not move to another player.

Blocks in sector 1

Block Content
4 Name: ASCII, 1โ€“15 bytes, padded with 0x00
5 Retroverse marker (below)
6 Reserved, zeros
7 Sector trailer, never written

Block 5: marker

Bytes Content
0โ€“3 Magic 52 56 52 53 ("RVRS")
4 Format version 0x01
5 Name length (1โ€“15)
6โ€“7 CRC-16/CCITT-FALSE (poly 0x1021, init 0xFFFF) over all 16 bytes of block 4, big endian
8โ€“15 Reserved, zeros

How a card is classified

flowchart TD
    A["<span style='color:#f8fafc'>Card detected</span>"]:::hw --> B{"MIFARE Classic?"}
    B -- no --> U1["<span style='color:#ffffff'>unsupported</span>"]:::ext
    B -- yes --> C{"Sector 1 readable?"}
    C -- no --> U2["<span style='color:#ffffff'>unreadable</span>"]:::ext
    C -- yes --> D{"Block 5 starts<br/>with RVRS?"}
    D -- yes --> E{"Version, length,<br/>CRC, ASCII OK?"}
    E -- yes --> OK["<span style='color:#111111'>retroverse โœ“</span>"]:::rfid
    E -- no --> CO["<span style='color:#ffffff'>corrupt</span>"]:::ext
    D -- no --> F{"Block 4 printable<br/>ASCII?"}
    F -- yes --> LG["<span style='color:#ffffff'>legacy<br/>(first-generation card)</span>"]:::ext
    F -- no --> BL["<span style='color:#ffffff'>blank</span>"]:::ext

    classDef rfid fill:#f472b6,stroke:#be185d,color:#111,stroke-width:2px
    classDef ext fill:#64748b,stroke:#334155,color:#fff,stroke-width:2px
    classDef hw fill:#1f2937,stroke:#94a3b8,color:#f8fafc,stroke-dasharray:4 3

Safe writing

A write command writes block 4 (name + padding), then block 5 (marker with the CRC of the new block 4), then reads both back and compares. If a write is interrupted, the card is left either with a CRC mismatch (corrupt) or with its old content, never as a valid card with half a name. Legacy cards become retroverse cards the first time they are written.