Loot Box plus plus

## 1.1.0

Minecraft 1.20.1, Forge 47.4.10 minimum.

### Français

**Avant de mettre à jour**

- Le protocole réseau a changé : le serveur et tous les joueurs doivent utiliser cette version.
- Les poids des tables de butin ont changé. Un datapack qui remplace une table du mod garde son propre contenu et ne reçoit pas les nouvelles récompenses.

**Nouvelles récompenses**

- Niveau I : livre enchanté, épée en fer enchantée, pomme dorée, totem d'immortalité.
- Niveau II : livre enchanté, épée et pioche en diamant enchantées, pomme dorée, totem d'immortalité, pomme dorée enchantée.
- Niveau III : livre enchanté, épée et plastron en diamant enchantés, totem d'immortalité, pomme dorée enchantée, élytres.

**Raretés et gros lots**

- Cinq raretés, chacune avec sa couleur sur la roulette, dans le nom de la récompense et dans la liste du contenu : commun, peu commun, rare, épique, légendaire.
- Un objet légendaire est un gros lot : effet doré autour de la récompense et son dédié. Chance par box : 2 % au niveau I, 5 % au niveau II, 10 % au niveau III.
- Quand une box donne plusieurs objets, la roulette s'arrête sur le plus rare.

**Aperçu du contenu**

- Le bouton CONTENU de l'écran d'ouverture liste les récompenses possibles, avec leur rareté, leur quantité et leur chance estimée.
- La liste vient de vrais tirages dans la table de butin : elle suit donc les datapacks.

**Chance garantie**

- Un gros lot est assuré après 50 box sans gros lot au niveau I, 30 au niveau II et 15 au niveau III. L'écran affiche le nombre de box restantes.
- Le compteur est propre à chaque joueur et à chaque niveau, et il est sauvegardé avec le monde.
- Réglable dans `serverconfig/lootboxplusplus-server.toml` du monde : `jackpotGuaranteeLevel1`, `jackpotGuaranteeLevel2`, `jackpotGuaranteeLevel3`. La valeur 0 désactive la garantie.

**Annonce sur le serveur**

- Un gros lot est annoncé dans le chat à tous les joueurs. Désactivable avec `announceJackpots` dans le même fichier.

**Fusion**

- Trois box de même niveau se fusionnent en une box du niveau supérieur (I vers II, II vers III). La recette se débloque en obtenant une box du niveau à fusionner.

**Succès**

- Nouvel onglet Loot Box++ avec 7 succès : obtenir une box, ouvrir sa première box, fusionner, ouvrir une box de niveau III, premier gros lot, gros lot garanti, 50 box ouvertes.

**Objets d'autres mods**

- Nouveau guide et exemple de datapack pour ajouter des objets d'autres mods aux box sans casser une table de butin si l'un de ces mods est absent. Le guide couvre aussi le tirage depuis la table de butin d'un autre mod.
- Les raretés se règlent par les tags `lootboxplusplus:rarity/uncommon`, `rare`, `epic` et `legendary`.

### English

**Before updating**

- The network protocol changed: the server and all players must use this version.
- The loot table weights changed. A datapack replacing one of the mod's tables keeps its own contents and does not get the new rewards.

**New rewards**

- Level I: enchanted book, enchanted iron sword, golden apple, totem of undying.
- Level II: enchanted book, enchanted diamond sword and pickaxe, golden apple, totem of undying, enchanted golden apple.
- Level III: enchanted book, enchanted diamond sword and chestplate, totem of undying, enchanted golden apple, elytra.

**Rarities and jackpots**

- Five rarities, each with its own color on the roulette, in the reward name and in the contents list: common, uncommon, rare, epic, legendary.
- A legendary item is a jackpot: golden effect around the reward and its own sound. Chance per box: 2% at level I, 5% at level II, 10% at level III.
- When a box gives several items, the roulette stops on the rarest one.

**Contents preview**

- The CONTENTS button on the opening screen lists the possible rewards with their rarity, amount and estimated chance.
- The list comes from real rolls in the loot table, so it follows datapacks.

**Guaranteed luck**

- A jackpot is guaranteed after 50 boxes without one at level I, 30 at level II and 15 at level III. The screen shows how many boxes are left.
- The counter is kept per player and per level, and is saved with the world.
- Adjustable in the world's `serverconfig/lootboxplusplus-server.toml`: `jackpotGuaranteeLevel1`, `jackpotGuaranteeLevel2`, `jackpotGuaranteeLevel3`. A value of 0 turns the guarantee off.

**Server announcement**

- A jackpot is announced in the chat to all players. Can be turned off with `announceJackpots` in the same file.

**Merging**

- Three boxes of the same level merge into one box of the next level (I to II, II to III). The recipe unlocks when you get a box of the level to merge.

**Advancements**

- New Loot Box++ tab with 7 advancements: getting a box, opening your first box, merging, opening a level III box, first jackpot, guaranteed jackpot, 50 boxes opened.

**Items from other mods**

- New guide and example datapack to add items from other mods to the boxes, without breaking a loot table when one of those mods is missing. The guide also covers pulling from another mod's loot table.
- Rarities are set through the `lootboxplusplus:rarity/uncommon`, `rare`, `epic` and `legendary` tags.