[EN] Built for Real Servers

Arcadia Lootbox is a production-grade crate system. Thread-safe managers, async config reload, atomic map swaps, anti-autoclicker, per-lootbox cooldowns, usage caps, soft LuckPerms integration. No client-only references leak into common code - safe on dedicated servers from day one.

[FR] Conçu pour les vrais serveurs

Arcadia Lootbox est un système de crates de qualité production. Managers thread-safe, rechargement de config asynchrone, swap atomique des maps, anti-autoclicker, cooldowns par lootbox, limites d'utilisations, intégration LuckPerms souple. Aucune classe client ne fuit dans le code commun - sûr sur serveur dédié dès le premier lancement.

🔌 DROP-IN & DATA-DRIVEN

Drop the jar in mods/ and you get 50 themed keys, a steampunk Hub UI, and 14 admin commands out of the box. Define new lootboxes with simple JSON files - no Java, no KubeJS scripts, no datapacks.

✅ Works in singleplayer and on dedicated servers. Reload live with /arcadia_lootbox reload - async, no tick freeze.

🔌 PRÊT À L'EMPLOI & DATA-DRIVEN

Posez le jar dans mods/ et vous avez 50 clés thématiques, une UI Hub steampunk et 14 commandes admin d'office. Définissez de nouvelles lootbox avec de simples fichiers JSON - pas de Java, pas de scripts KubeJS, pas de datapacks.

✅ Fonctionne en solo et sur serveur dédié. Rechargement à chaud via /arcadia_lootbox reload - asynchrone, sans freeze de tick.

🗝️ 50 Themed Keys
Six categories - Dungeon, Shop, Vote, Lootable, Event, Boss - with up to 10 tiers each (Common → Transcendent / Bronze → Overlord). Custom 16×16 textures and JSON-defined item models, all bundled.

📦 Data-Driven Lootboxes
Define a lootbox by writing a JSON file. 35+ tunable parameters: weighted or guaranteed drops, per-item chance, min/max counts, rarities, broadcast triggers, free timers, permissions, particles, sounds, animations, command rewards. Rewards can even carry NBT / data components (enchanted books, named gear, custom potions) via the vanilla /give syntax.

🎨 Steampunk Hub UI
A polished client-side browser screen with copper-glass styling. Categories collapse and expand on click; expand-all / collapse-all controls keep things tidy when you have dozens of lootboxes.

🎯 Smart Preview Menu
Single clickable action row, 28 items per page, rarity filter chips, multi-draw (left = 1, right = all keys, shift = 10). Right-click a key in air to open its matching lootbox preview directly.

⏰ Free Lootbox Timers
Per-lootbox free claims with configurable cooldown (72 h default, 48 h with permission). Persistent across restarts via free_claims.json. Auto-save every 5 minutes.

🛡️ Hardened & Optimized
Anti-autoclicker, per-lootbox cooldowns, usage caps, strict slot bounds, click anti-spam, null-safe registry lookups, input sanitization. Frame cached, rarity counts cached, ordered lists immutable.

🌐 100% Bilingual EN/FR
Every user-facing string goes through LanguageHelper with both English and French translations. Language is detected per-player via client info - no manual switch needed.

🔑 Soft LuckPerms Integration
Permission nodes on every lootbox and free-reduced-cooldown perk. LuckPerms is optional - the mod gracefully falls back to vanilla OP checks when LP isn't installed.

1️⃣ Drop the jar in mods/ and start the server.

2️⃣ Edit JSON files in config/arcadialootbox/ to define your lootboxes.

3️⃣ Run /arcadia_lootbox give to spawn a crate, or /arcadia_lootbox hub to open the UI.

4️⃣ Right-click the placed crate with the correct key. Watch the rewards fly. Done.

🎲 Weighted Mode

Each item in lootTable rolls independently against its chance (0.0 to 1.0). Multiple items can drop on the same open, or none at all if you set low chances.

{
  "displayName": "Treasure Chest",
  "color": "yellow",
  "keyItem": "arcadialootbox:shop_key_rare",
  "rarity": "rare",
  "type": "weighted",
  "broadcastRare": true,
  "lootTable": [
    { "item": "minecraft:diamond",
      "minCount": 1, "maxCount": 3,
      "chance": 0.3, "rarity": "rare",
      "displayName": "Diamond",
      "broadcast": true },
    { "item": "minecraft:gold_ingot",
      "minCount": 2, "maxCount": 5,
      "chance": 0.6, "rarity": "uncommon",
      "displayName": "Gold Ingot" },
    { "item": "minecraft:iron_ingot",
      "minCount": 5, "maxCount": 10,
      "chance": 1.0, "rarity": "common",
      "displayName": "Iron Ingot" }
  ],
  "particles": ["minecraft:flame"],
  "openSound": "minecraft:block.chest.open",
  "openMessage": "§aLootbox opened!"
}

🎯 Guaranteed Mode

The player always receives guaranteedItem and exactly one entry from lootTable, picked using chance as a weight (higher = more likely).

{
  "displayName": "Lucky Box",
  "color": "lime",
  "keyItem": "arcadialootbox:vote_key_common",
  "rarity": "uncommon",
  "type": "guaranteed",
  "guaranteedItem": "minecraft:bread",
  "guaranteedMinCount": 1,
  "guaranteedMaxCount": 3,
  "lootTable": [
    { "item": "minecraft:diamond",
      "minCount": 1, "maxCount": 1,
      "chance": 0.05, "rarity": "legendary" },
    { "item": "minecraft:emerald",
      "minCount": 1, "maxCount": 3,
      "chance": 0.15, "rarity": "rare" },
    { "item": "minecraft:gold_ingot",
      "minCount": 2, "maxCount": 5,
      "chance": 0.30, "rarity": "uncommon" },
    { "item": "minecraft:iron_ingot",
      "minCount": 3, "maxCount": 8,
      "chance": 0.50, "rarity": "common" }
  ],
  "freeEnabled": true,
  "freeCooldownHours": 72,
  "freeReducedCooldownHours": 48,
  "freeReducedPermission": "arcadialootbox.free.reduced",
  "experienceReward": 5
}

"lootTable": [
  { "item": "minecraft:enchanted_book[stored_enchantments={levels:{\"minecraft:sharpness\":5}}]",
    "minCount": 1, "maxCount": 1, "chance": 0.1, "rarity": "legendary",
    "displayName": "Sharpness V Book", "broadcast": true },

  { "item": "minecraft:diamond_sword[enchantments={levels:{\"minecraft:looting\":3}}]",
    "minCount": 1, "maxCount": 1, "chance": 0.2, "rarity": "epic",
    "displayName": "Looting III Sword" },

  { "item": "minecraft:potion[potion_contents={potion:\"minecraft:strong_healing\"}]",
    "minCount": 1, "maxCount": 2, "chance": 0.4, "rarity": "rare",
    "displayName": "Healing II Potion" }
]

🗝️ 50 clés thématiques
Six catégories - Donjon, Boutique, Vote, Trouvable, Événement, Boss - avec jusqu'à 10 paliers chacune (Commune → Transcendante / Bronze → Suzerain). Textures custom 16×16 et modèles d'objet en JSON, tout est inclus.

📦 Lootbox data-driven
Définissez une lootbox en écrivant un fichier JSON. 35+ paramètres réglables : drops pondérés ou garantis, chance par item, min/max, raretés, déclencheurs de broadcast, timers gratuits, permissions, particules, sons, animations, récompenses par commande. Les récompenses peuvent même porter du NBT / data-components (livres enchantés, équipement nommé, potions custom) via la syntaxe de la commande /give.

🎨 UI Hub steampunk
Un écran navigateur côté client soigné avec style cuivre-verre. Les catégories se replient et se déploient au clic ; les boutons Tout déployer / Tout replier gardent l'écran propre quand vous avez des dizaines de lootbox.

🎯 Menu Preview intelligent
Une seule rangée d'action cliquable, 28 objets par page, puces de filtre par rareté, multi-tirage (gauche = 1, droit = toutes les clés, shift = 10). Clic-droit avec une clé dans le vide pour ouvrir directement la lootbox correspondante.

⏰ Timers de lootbox gratuites
Réclamations gratuites par lootbox avec cooldown configurable (72 h par défaut, 48 h avec permission). Persistantes entre redémarrages via free_claims.json. Sauvegarde auto toutes les 5 minutes.

🛡️ Durci & optimisé
Anti-autoclicker, cooldowns par lootbox, limites d'utilisations, bornes strictes sur les slots, anti-spam de clic, lookups de registry null-safe, sanitization des entrées. Cadre en cache, comptes de rareté en cache, listes immuables.

🌐 100 % bilingue EN/FR
Chaque texte visible passe par LanguageHelper avec traductions anglaise et française. La langue est détectée par joueur via le client info - aucun switch manuel.

🔑 Intégration LuckPerms souple
Nodes de permission sur chaque lootbox et perk de cooldown réduit. LuckPerms est optionnel - le mod retombe gracieusement sur les checks OP vanilla quand LP n'est pas installé.

1️⃣ Posez le jar dans mods/ et démarrez le serveur.

2️⃣ Éditez les fichiers JSON dans config/arcadialootbox/ pour définir vos lootbox.

3️⃣ Lancez /arcadia_lootbox give pour spawn une crate, ou /arcadia_lootbox hub pour ouvrir l'UI.

4️⃣ Clic-droit la crate posée avec la bonne clé. Regardez les récompenses voler. Terminé.

🎲 Mode Weighted

Chaque item dans lootTable tire indépendamment contre son chance (0.0 à 1.0). Plusieurs items peuvent drop sur la même ouverture, ou aucun si vous mettez des chances faibles.

{
  "displayName": "Coffre au Trésor",
  "color": "yellow",
  "keyItem": "arcadialootbox:shop_key_rare",
  "rarity": "rare",
  "type": "weighted",
  "broadcastRare": true,
  "lootTable": [
    { "item": "minecraft:diamond",
      "minCount": 1, "maxCount": 3,
      "chance": 0.3, "rarity": "rare",
      "displayName": "Diamant",
      "broadcast": true },
    { "item": "minecraft:gold_ingot",
      "minCount": 2, "maxCount": 5,
      "chance": 0.6, "rarity": "uncommon",
      "displayName": "Lingot d'or" },
    { "item": "minecraft:iron_ingot",
      "minCount": 5, "maxCount": 10,
      "chance": 1.0, "rarity": "common",
      "displayName": "Lingot de fer" }
  ],
  "particles": ["minecraft:flame"],
  "openSound": "minecraft:block.chest.open",
  "openMessage": "§aLootbox ouverte !"
}

🎯 Mode Guaranteed

Le joueur reçoit toujours guaranteedItem et exactement une entrée du lootTable, choisie avec chance utilisé comme poids (plus élevé = plus probable).

{
  "displayName": "Boîte Chanceuse",
  "color": "lime",
  "keyItem": "arcadialootbox:vote_key_common",
  "rarity": "uncommon",
  "type": "guaranteed",
  "guaranteedItem": "minecraft:bread",
  "guaranteedMinCount": 1,
  "guaranteedMaxCount": 3,
  "lootTable": [
    { "item": "minecraft:diamond",
      "minCount": 1, "maxCount": 1,
      "chance": 0.05, "rarity": "legendary" },
    { "item": "minecraft:emerald",
      "minCount": 1, "maxCount": 3,
      "chance": 0.15, "rarity": "rare" },
    { "item": "minecraft:gold_ingot",
      "minCount": 2, "maxCount": 5,
      "chance": 0.30, "rarity": "uncommon" },
    { "item": "minecraft:iron_ingot",
      "minCount": 3, "maxCount": 8,
      "chance": 0.50, "rarity": "common" }
  ],
  "freeEnabled": true,
  "freeCooldownHours": 72,
  "freeReducedCooldownHours": 48,
  "freeReducedPermission": "arcadialootbox.free.reduced",
  "experienceReward": 5
}

"lootTable": [
  { "item": "minecraft:enchanted_book[stored_enchantments={levels:{\"minecraft:sharpness\":5}}]",
    "minCount": 1, "maxCount": 1, "chance": 0.1, "rarity": "legendary",
    "displayName": "Livre Tranchant V", "broadcast": true },

  { "item": "minecraft:diamond_sword[enchantments={levels:{\"minecraft:looting\":3}}]",
    "minCount": 1, "maxCount": 1, "chance": 0.2, "rarity": "epic",
    "displayName": "Épée Butin III" },

  { "item": "minecraft:potion[potion_contents={potion:\"minecraft:strong_healing\"}]",
    "minCount": 1, "maxCount": 2, "chance": 0.4, "rarity": "rare",
    "displayName": "Potion de Soin II" }
]

🔗 True Cross-Mod Progression
Tech and magic don't live in separate silos. Late-game crafts need both ecosystems. 4 custom bridge items (Arcane Circuit, Ethereal Alloy, Industrial Heart, Rune Matrix) tie everything together.

🌐 100% Bilingual EN/FR
25,000+ translation entries across the entire pack. Quests, items, custom UIs - fully translated. Zero franglais.

🎮 Curated Server Experience
In-house mods built for Arcadia: Arcadia Lootbox, Arcadia Pets (collectibles + PvP duels + ELO ladder), Arcadia Guard moderation, Prestige progression, Heart of Arcadia. Not mods bolted together - a tailored ecosystem.

📜 3,000+ Quest-Guided Journey
31 chapters of FTB Quests covering every mod's progression path. Whether you're fresh or a 1000-hour veteran, you always know what to do next.