# 🦋 Rebox Premium Animated Lootboxes

Rebox brings a deeply satisfying lootbox system to your modded Minecraft server:
5 tiers themed around the butterfly metamorphosis, a CS:GO-style spinning reveal,
an anti-bad-luck system (*pity*), a x10 opening, and an in-game showroom that displays
each crate's contents and real drop rates.

> Built for the Re:Craft server fully configurable for yours.

---

## ✨ Features

- 5 themed tiers (common → rarest): ReboxVote, Rebox Egg, Rebox Caterpillar,
Rebox Chrysalis, Rebox Monarch.
- Animated opening a decelerating spinning reel with a particle reveal, flash,
screen-shake and sounds scaled to rarity.
- x10 opening (Shift + right-click): a staggered reveal grid where each cell
"pops" with its rarity and highlights the best drop.
- Pity system (anti-bad-luck): a rare+ reward is guaranteed after a number of
unlucky openings and the counter is visible in the showroom.
- In-game showroom (`/reboxes`): preview every item in a crate with its real
probability, tier tabs, and detailed tooltips.
- Animated textures: a glow that shines brighter the rarer the box is.
- Shine on rare items during the roll.
- Server-wide announcement (FOMO) for high tiers broadcast after the animation
ends (no spoilers).
- Full armor sets as rewards (the whole set, not just one piece).
- Inventory button to open the showroom, toggleable on demand.

---

## 🎁 Fully configurable loot

- Each tier's contents are set in simple JSON files (`config/rebox/loot/<tier>.json`):
item, weight (probability), min/max amount, NBT, and bonus items (kits).
- A built-in item scanner (`/rebox scan`) generates loot suggestions from your modpack,
ranked by value (reads ProjectE EMC if present) and category, filtering out
decorative / non-obtainable items.
- Hot reload with `/rebox reload`.
- Shop/vote links and tier prices shown in the showroom are configurable in
`config/rebox-common.toml`.

---

## 🕹️ Commands

| Command | Description |
|---|---|
| `/reboxes [tier]` | Opens the showroom (available to everyone) |
| `/rebox give <player> <tier> [n]` | Gives Rebox crates (Azuriom / AzLink friendly, offline delivery queue) |
| `/rebox odds <tier>` | Lists each item's drop chance |
| `/rebox stats [player]` | Total openings + pity counter |
| `/rebox scan` | Scans the modpack and generates loot drafts |
| `/rebox reload` | Reloads the loot files |
| `/reboxbutton` | Shows/hides the inventory button (client) |

---

## 🛒 Shop integration (Azuriom / AzLink)

`/rebox give` is designed to be called from your Azuriom shop through AzLink
(use the `{player}` placeholder). If the player is offline, the delivery is queued and
handed over on their next login. Crates are obtained only via voting (free) and the shop.

---

## 📦 Compatibility

- Minecraft 1.20.1 Forge 47.4.20+ Java 17
- Optional: *ProjectE* (EMC-based valuation for the scanner), *Azuriom + AzLink*
(shop delivery).
- Required on both server and client (the animation and showroom render client-side).

---

## 🦋 About

Originally developed for the Re:Craft server. Rolls are server-authoritative
(no cheating possible); the animation is purely cosmetic.

# 🦋 Rebox Lootboxes premium animées (Re:Craft)

Rebox ajoute un système de lootbox ultra satisfaisant à ton serveur Minecraft modé :
5 paliers sur le thème de la métamorphose du papillon, une ouverture animée façon
roulette CS:GO, un système anti-malchance (*pity*), une ouverture x10, et une vitrine
en jeu qui affiche le contenu et les vraies probabilités de chaque caisse.

> Conçu pour le serveur Re:Craft, entièrement configurable pour le tien.

---

## ✨ Fonctionnalités

- 5 tiers thématiques (du plus commun au plus rare) : ReboxVote, Rebox Œuf,
Rebox Chenille, Rebox Chrysalide, Rebox Monarque.
- Ouverture animée style roulette qui décélère, avec révélation à particules,
flash, screen-shake et sons dosés selon la rareté.
- Ouverture x10 (Shift + clic droit) : une grille à révélation échelonnée,
chaque case « pop » avec sa rareté et met le meilleur lot en avant.
- Système de Pity (anti-malchance) : un lot rare+ garanti après un certain nombre
d'ouvertures sans chance et le compteur est visible dans la vitrine.
- Vitrine en jeu (`/reboxes`) : aperçu de tout le contenu de chaque caisse avec
les probabilités réelles affichées, onglets par tier, infobulles détaillées.
- Textures animées : un halo qui brille de plus en plus selon la rareté de la boîte.
- Brillance sur les objets rares pendant le tirage.
- Annonce serveur (FOMO) sur les hauts tiers diffusée à la fin de l'animation
(zéro spoil).
- Kits d'armure complets en récompense (le set entier, pas qu'une pièce).
- Bouton d'inventaire pour ouvrir la vitrine, masquable à la demande.

---

## 🎁 Loot 100 % configurable

- Le contenu de chaque tier se règle dans de simples fichiers JSON
(`config/rebox/loot/<tier>.json`) : item, poids (probabilité), quantité min/max,
NBT, et bonus (kits).
- Un scanner d'items intégré (`/rebox scan`) génère des propositions de loot à partir
du modpack, classées par valeur (lecture de l'EMC ProjectE si présent) et par
catégorie, en écartant le décoratif/non-obtenable.
- Rechargement à chaud avec `/rebox reload`.

---

## 🕹️ Commandes

| Commande | Description |
|---|---|
| `/reboxes [tier]` | Ouvre la vitrine (accessible à tous) |
| `/rebox give <joueur> <tier> [n]` | Donne des Rebox (compatible Azuriom / AzLink, livraison même hors-ligne) |
| `/rebox odds <tier>` | Affiche les chances de chaque item |
| `/rebox stats [joueur]` | Ouvertures totales + compteur de pity |
| `/rebox scan` | Scanne le modpack et génère des brouillons de loot |
| `/rebox reload` | Recharge les fichiers de loot |
| `/reboxbutton` | Affiche/masque le bouton d'inventaire (client) |

---

## 🛒 Intégration boutique (Azuriom / AzLink)

`/rebox give` est pensé pour être appelé depuis ta boutique Azuriom via AzLink
(placeholder `{player}`). Si le joueur est hors-ligne, la livraison est mise en file
et remise à sa prochaine connexion. Les caisses ne s'obtiennent que par le vote
(gratuit) et la boutique.

---

## 📦 Compatibilité

- Minecraft 1.20.1 Forge 47.4.20+ Java 17
- Optionnel : *ProjectE* (valorisation EMC pour le scanner), *Azuriom + AzLink*
(livraison depuis la boutique).
- Côté serveur et client (l'animation et la vitrine sont rendues côté client).

---

## 🦋 À propos

Mod développé pour le serveur Re:Craft. Le tirage est autoritaire côté serveur
(aucune triche possible) ; l'animation est purement cosmétique.