Arcadia LootBox

### Added

- **Free Timed Lootboxes** — Configurable per-lootbox free claims with cooldown timers (72h default, 48h with permissions). Persistent across server restarts via JSON storage. Auto-save every 5 minutes.

- **Soft LuckPerms Integration** — Full LuckPerms support that works gracefully when LP is not installed. Falls back to vanilla OP checks. Per-lootbox permission nodes, reduced free cooldowns with permission.

- **PermissionHelper** — Centralized permission wrapper with cached LP detection, default fallback, and error handling.

- **FreeLootboxManager** — Persistent per-player claim tracker with formatted remaining time display.

- **3 New Commands** — `/arcadia_lootbox free`, `/arcadia_lootbox freetimer`, `/arcadia_lootbox resetfree` for free lootbox management.

- **Dual Lootbox Types** — Two distinct modes: "weighted" (each item rolls independently with its %) and "guaranteed" (picks ONE item from pool + always gives a guaranteed item).

- **50 Integrated Key Items** — Dungeon (10 tiers), Shop (10 tiers), Vote (10 tiers), Lootable (10 tiers), Event (5 tiers), Boss (5 tiers) with custom textures.

- **Arcadia Lib Integration** — Full integration with arcadia-lib: ArcadiaTheme, ArcadiaMessages, CooldownManager, SchedulerService, TextFormatter, ItemBuilder.

- **Arcadia Hub Module** — Lootbox card registered in the Arcadia Hub with steampunk-themed client-side browser screen.

- **Rarity System** — 6 rarity tiers (Common → Mythic) with colored display and broadcast support.

- **Server Broadcast** — Configurable server-wide announcements when rare items are found.

- **Opening History** — Per-player history tracking with admin commands to view and clear.

- **Usage Limits** — maxUses per placed lootbox with NBT persistence and admin override.

- **Anti-Autoclicker** — Detects rapid-fire openings and temporarily blocks abusers.

- **Title Animations** — Configurable title/subtitle on lootbox opening with fade timings.

- **Command Rewards** — Execute console/player commands as lootbox rewards with independent chances.

- **XP Rewards** — Grant experience points on lootbox opening.

- **Permission System** — Per-lootbox LuckPerms permission nodes via arcadia-lib.

- **Global TOML Config** — 30+ configurable parameters: cooldowns, broadcasts, hub, performance, security, animation, sounds.

- **Network Sync** — S2C packets sync lootbox data to clients for hub display.

### Changed

- **Package Rename** — Moved from `com.vyrriox.arcadialootbox` to `com.arcadia.lootbox`.

- **Commands** — All commands now under `/arcadia_lootbox` with 14 subcommands and full tab-completion.

- **Preview GUI** — Enhanced with copper-glass border, nether star info panel, rarity sorting, enchant glint on epic+ items.

- **Thread Safety** — ConcurrentHashMap for all managers, volatile fields, bounded history queues.

- **Random Optimization** — Uses `level.random` instead of `new Random()` per opening.

- **Particle Optimization** — Batched particle sending (single call with count > 1), configurable limit.

- **Config Validation** — Validates minCount <= maxCount, chance range, guaranteed type fields on load.

- **Async Reload** — Config reload runs off the main thread to prevent tick freezes.

### Fixed

- **ClassCastException** — Added `instanceof ServerPlayer` check in left-click handler.

- **minCount > maxCount crash** — Validated at config load time.

- **Unknown item silent failure** — Now logs a warning for missing items.

- **Random color support** — "random" color value now works as documented.

- **Block existence check** — Preview GUI validates block still exists.

### Ajouts

- **Lootbox gratuites avec timer** — Claims gratuits par lootbox avec cooldown configurable (72h par défaut, 48h avec permissions). Persistant au redémarrage. Auto-save toutes les 5 minutes.

- **Intégration LuckPerms souple** — Support LuckPerms complet qui fonctionne sans LP installé. Fallback sur OP vanilla. Permissions par lootbox, cooldowns réduits avec permission.

- **3 Nouvelles commandes** — `/arcadia_lootbox free`, `/arcadia_lootbox freetimer`, `/arcadia_lootbox resetfree`.

- **Deux types de Lootbox** — Mode "weighted" (% indépendant par item) et "guaranteed" (1 item tiré + item garanti).

- **50 Clés intégrées** — Donjon (10), Boutique (10), Vote (10), Trouvable (10), Événement (5), Boss (5) avec textures.

- **Intégration Arcadia Lib** — ArcadiaTheme, ArcadiaMessages, CooldownManager, SchedulerService, TextFormatter, ItemBuilder.

- **Module Hub Arcadia** — Carte lootbox dans le Hub avec écran client steampunk.

- **Système de rareté** — 6 niveaux (Common → Mythic) avec couleurs et broadcast.

- **Broadcast serveur** — Annonces configurables pour les drops rares.

- **Historique d'ouvertures** — Suivi par joueur avec commandes admin.

- **Limites d'utilisation** — maxUses par lootbox placée avec persistance NBT.

- **Anti-Autoclicker** — Détection des ouvertures rapides.

- **Animations titre** — Titre/sous-titre configurables à l'ouverture.

- **Récompenses commandes** — Exécution de commandes comme récompenses.

- **Récompenses XP** — Points d'expérience à l'ouverture.

- **Système de permissions** — Nodes LuckPerms par lootbox.

- **Config TOML globale** — 30+ paramètres configurables.

### Modifications

- **Renommage package** — `com.vyrriox.arcadialootbox` → `com.arcadia.lootbox`.

- **Commandes** — Toutes sous `/arcadia_lootbox` avec 14 sous-commandes et auto-complétion.

- **GUI Preview** — Bordure cuivre, étoile info, tri par rareté, glint enchantement.

- **Thread Safety** — ConcurrentHashMap partout, champs volatile.

- **Optimisation particules** — Envoi groupé, limite configurable.

### Correctifs

- **ClassCastException** — Vérification `instanceof ServerPlayer`.

- **Crash minCount > maxCount** — Validation au chargement.

- **Item inconnu silencieux** — Warning dans les logs.