Rebox

🦋 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.