Arcadia LootBox

## [1.3.0] - 2026-10-06

### Added

- **3D lootbox chests** — A lootbox is now a modelled steampunk chest item (`arcadialootbox:lootbox_chest`, lootbox id in the `LootboxID` custom data). Placed on solid ground, it lands, rumbles, bursts open with light rays in the color of its gem, throws its rewards one by one (guaranteed item first, best reward last) and vanishes.

- **61 chest styles in the language of vanilla textures** — Flat planks with clean seams and a dark outline, bevelled metal, vanilla materials (colors measured on the vanilla blocks). 11 tier styles with ornaments that grow with the tier (gem, gold crown, amethyst cluster, horns, floating halo, orbiting crystals, panels showing the sky of the End) and one style for each of the 50 keys, whose family adds its mark: skull lock with glowing eyes and moss (dungeon), spinning gold coin (shop), waving pennant (vote), rope straps (lootable), ribbon bow (event), skull and horns (boss). A lootbox using a key of the mod takes the style of that key by default.

- **50 ready-to-use lootboxes** — One per key in `templates/` (key, chest style, EN and FR names, rewards by tier), not loaded until `/arcadia_lootbox template <id>` installs one. Right-clicking a key no lootbox uses says so, and tells operators which template to install.

- **Loot for the opener only** — Rewards land as loot drops that only the player who placed the chest can pick up. Other players, hoppers and mobs cannot take them; they cannot burn or be destroyed, never despawn, come back from the void, show a beam of their rarity color and their name when rare, and fly to their owner after `autoCollectSeconds` when the owner is near.

- **Restart-proof openings** — Rewards, command rewards and experience are rolled once, on the first tick after the placement, and kept in the chest until they are given. A restart or an unloaded chunk resumes the opening; a chest removed in the middle of an opening releases everything it still held.

- **Custom preview screen** — Replaces the chest menu: the chest turning on a pedestal (drag to turn it, hover to peek inside), the lootbox stats (type, rewards, average items per opening, item cap, chests carried, free claim) and every reward with its real chance per opening, sortable by rarity, chance or name and filterable by rarity, with full item tooltips. For weighted lootboxes the chance accounts for `maxDropsPerOpen`. Nothing can be drawn from it.

- **Key migration** — Keys stay registered so that nothing holding them breaks. A key that reaches a player inventory is exchanged for the chest of the lootbox naming it in `keyItem`, one chest per key, and the shulker lootboxes of earlier versions become chests. `minecraft` items are never exchanged. New `[keyMigration]` config section (`mode` = `ALL`, `MOD_KEYS_ONLY` or `OFF`, `message`) and `migrateKeys` lootbox field.

- **New config section `[chest]`** — `chargeTicks`, `ejectIntervalTicks`, `autoCollectSeconds`, `requireSolidGround`, `lootBeams`, `hologram`.

- **New lootbox field `chestStyle`** — Picks the look of the chest. Left empty, the style comes from a tier word of the lootbox id or key id, then from the rarity.

- **`/arcadia_lootbox migrate <player>`** and **`template <id>`** — Exchange the legacy items of a player at once; install a ready-to-use lootbox. `info` now shows the chest style and the real chance of each entry.

- **Chest model tool** — `tools/chest-model/generate.py` describes the model once and writes the Java model layer, the list of styles, the textures of every style and the preview sheets.

### Changed

- **Opening** — Lootboxes open by placing their chest; the Draw button and the bulk opening are gone. The per-lootbox cooldown, the permission and the anti-autoclicker are checked before the chest is placed.

- **Commands** — `give`, `giveall` and `free` give chests. `givekey` gives the chest of the lootbox using the key, or the key when none does.

- **Chest names** — Shown in the language of each player and updated after a reload, instead of being written into the item.

- **Network protocol** — Version 2 (new preview packet, richer lootbox list). Server and clients must both run 1.3.0.

### Compatibility

- Lootbox JSON files, `free_claims.json`, history and `lootbox.toml` load unchanged; new settings get their default.

- Shulker lootboxes placed before 1.3.0 still show their preview on right-click, and `setuses` still applies to them.

- Fields `maxUses`, `destroyOnOpen` and `requireSneakToOpen` only concern those older blocks; `giveToInventoryOnly` now makes the thrown rewards fly straight to their owner.

### Ajouts

- **Coffres de lootbox en 3D** — Une lootbox est désormais un objet coffre steampunk modélisé (`arcadialootbox:lootbox_chest`, id de la lootbox dans la custom data `LootboxID`). Posé sur un sol solide, il atterrit, tremble, s'ouvre dans des rayons de lumière à la couleur de sa gemme, jette ses récompenses une par une (l'objet garanti d'abord, la meilleure récompense en dernier) et disparaît.

- **61 styles de coffre dans le langage des textures vanilla** — Planches nettes avec un liseré sombre, métal biseauté, matières vanilla (couleurs mesurées sur les blocs vanilla). 11 styles de palier avec des ornements qui montent en gamme (gemme, couronne d'or, grappe d'améthyste, cornes, auréole flottante, cristaux en orbite, panneaux montrant le ciel de l'End) et un style pour chacune des 50 clés, dont la famille ajoute sa marque : serrure crâne aux yeux luisants et mousse (donjon), pièce d'or qui tourne (boutique), fanion qui flotte (vote), sangles en corde (trouvable), nœud cadeau (événement), crâne et cornes (boss). Une lootbox qui utilise une clé du mod prend par défaut le style de cette clé.

- **50 lootbox prêtes à l'emploi** — Une par clé dans `templates/` (clé, style de coffre, noms EN et FR, récompenses par palier), chargées seulement quand `/arcadia_lootbox template <id>` en installe une. Un clic droit avec une clé qu'aucune lootbox n'utilise l'indique, et donne aux opérateurs le modèle à installer.

- **Butin réservé à qui ouvre** — Les récompenses tombent en butin que seul le joueur qui a posé le coffre peut ramasser. Les autres joueurs, les entonnoirs et les mobs ne peuvent pas le prendre ; il ne brûle pas, ne peut pas être détruit, ne disparaît jamais, revient du vide, montre un faisceau de la couleur de sa rareté et son nom quand il est rare, et vole vers son propriétaire au bout de `autoCollectSeconds` quand celui-ci est proche.

- **Ouvertures à l'épreuve des redémarrages** — Les récompenses, les command rewards et l'expérience sont tirées une seule fois, au premier tick après la pose, et gardées dans le coffre jusqu'à être données. Un redémarrage ou un chunk déchargé reprend l'ouverture ; un coffre retiré en pleine ouverture libère tout ce qu'il contenait encore.

- **Écran d'aperçu personnalisé** — Remplace le menu coffre : le coffre qui tourne sur un socle (glisser pour le tourner, survoler pour regarder dedans), les statistiques de la lootbox (type, récompenses, objets moyens par ouverture, limite d'objets, coffres possédés, réclamation gratuite) et chaque récompense avec sa chance réelle par ouverture, triable par rareté, chance ou nom et filtrable par rareté, avec les infobulles complètes des objets. Pour les lootbox pondérées, la chance tient compte de `maxDropsPerOpen`. On ne peut rien tirer depuis cet écran.

- **Migration des clés** — Les clés restent enregistrées pour ne rien casser. Une clé qui arrive dans l'inventaire d'un joueur est échangée contre le coffre de la lootbox qui la nomme dans `keyItem`, un coffre par clé, et les lootbox shulker des versions précédentes deviennent des coffres. Les objets `minecraft` ne sont jamais échangés. Nouvelle section de config `[keyMigration]` (`mode` = `ALL`, `MOD_KEYS_ONLY` ou `OFF`, `message`) et champ de lootbox `migrateKeys`.

- **Nouvelle section de config `[chest]`** — `chargeTicks`, `ejectIntervalTicks`, `autoCollectSeconds`, `requireSolidGround`, `lootBeams`, `hologram`.

- **Nouveau champ de lootbox `chestStyle`** — Choisit l'apparence du coffre. Laissé vide, le style vient d'un mot de palier de l'id de la lootbox ou de sa clé, puis de la rareté.

- **`/arcadia_lootbox migrate <joueur>`** et **`template <id>`** — Échange d'un coup les anciens objets d'un joueur ; installe une lootbox prête à l'emploi. `info` affiche maintenant le style du coffre et la chance réelle de chaque entrée.

- **Outil de modèle de coffre** — `tools/chest-model/generate.py` décrit le modèle une seule fois et écrit la couche de modèle Java, la liste des styles, les textures de chaque style et les planches d'aperçu.

### Modifications

- **Ouverture** — Les lootbox s'ouvrent en posant leur coffre ; le bouton Draw et l'ouverture multiple disparaissent. Le cooldown par lootbox, la permission et l'anti-autoclicker sont vérifiés avant la pose du coffre.

- **Commandes** — `give`, `giveall` et `free` donnent des coffres. `givekey` donne le coffre de la lootbox qui utilise la clé, ou la clé si aucune ne l'utilise.

- **Noms des coffres** — Affichés dans la langue de chaque joueur et mis à jour après un reload, au lieu d'être écrits dans l'objet.

- **Protocole réseau** — Version 2 (nouveau paquet d'aperçu, liste des lootbox enrichie). Le serveur et les clients doivent tous être en 1.3.0.

### Compatibilité

- Les JSON de lootbox, `free_claims.json`, l'historique et `lootbox.toml` se chargent sans changement ; les nouveaux réglages prennent leur valeur par défaut.

- Les lootbox shulker posées avant la 1.3.0 montrent toujours leur aperçu au clic droit, et `setuses` s'applique toujours à elles.

- Les champs `maxUses`, `destroyOnOpen` et `requireSneakToOpen` ne concernent plus que ces anciens blocs ; `giveToInventoryOnly` fait maintenant voler les récompenses jetées directement vers leur propriétaire.