[EN] Built for Real Servers

Arcadia Spawn is a production-grade spawn-side toolkit. Thread-safe managers, async JSON reload, atomic file swaps with rotated backups, anti-spam rate limiters, per-command permission nodes, 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 Spawn est une boîte à outils spawn de qualité production. Managers thread-safe, rechargement JSON asynchrone, écritures atomiques avec backups rotatifs, limiteurs anti-spam, nodes de permission par commande, 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 & CONFIG-DRIVEN

Drop the jar in mods/ and you get a custom spawn dimension, a lobby chest GUI, RTP, a themed tab list with rank sorting, and 14+ admin commands out of the box. Every behavior tunable via TOML and JSON — no Java, no KubeJS, no datapacks.

✅ Works in singleplayer and on dedicated servers. Reload lobbies live with /arcadia_spawn reload; reload tab list live with /arcadia_spawn tablist reload.

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

Posez le jar dans mods/ et vous avez une dimension spawn personnalisée, un menu lobby, du RTP, une tab list thématique avec tri par grade, et 14+ commandes admin d'office. Chaque comportement réglable via TOML et JSON — pas de Java, pas de KubeJS, pas de datapacks.

✅ Fonctionne en solo et sur serveur dédié. Rechargement à chaud des lobbies via /arcadia_spawn reload ; tab list via /arcadia_spawn tablist reload.

🏠 Custom Spawn Dimension
The arcadia:spawn dimension is fully configurable — biome, flat layers, time lock, mob spawning rules, height, ambient light, ceiling. Drop your players into a controlled hub world.

🚪 Dynamic Lobby Menu
/lobby opens a chest GUI listing every configured warp. Each warp has its own item icon and bilingual description. Add or edit warps live with /arcadia_spawn setlobbytp.

🎯 Smart RTP
/arcadiartp finds a safe ground position in the Overworld within a configurable radius. Usage cap per player, warmup with movement cancel, cooldown — all tunable. Callable from any dimension.

📋 Themed Tab List
Configurable header / footer with placeholders, &-style color codes, and 7 built-in animations (scroll, pulse, rainbow, loading, blink, bar, title_color). Refresh rate tunable down to 5 ticks for smooth animations.

👑 LuckPerms Rank Sorting
Players are placed into Minecraft teams named as_<999-weight>_<group> so the highest LuckPerms weight always sits at the top of the tab. Without LuckPerms: clean op-level fallback (Owner → Default). Listens to UserDataRecalculateEvent for instant refresh.

👻 Spectator Hide
Players in /gamemode spectator disappear from the tab list of non-spectators. Other spectators still see each other so co-moderation works. Server-authoritative via ClientboundPlayerInfoRemovePacket.

🌐 Cross-Server Player Counts
Every server heartbeats its row into a shared arcadia_tablist_servers table via the arcadia-lib database, reads the others, and renders one footer line per peer with ALIVE / STALE flag. All JDBC async — main thread never blocks.

🗺️ Custom Dimensions On Demand
/arcadia_spawn dimension create <id> [preset] [biome]. Definitions are JSON under config/arcadia/spawn/dimensions/ registered at startup under the arcadia_custom: namespace. Presets ship for flat, void, lobby.

🔐 Slot Bypass
Permission-based slot bypass. Players with arcadia_spawn.slots.bypass bypass the slot limit when the server is full. Mixin-based fake max-slots in the server list and optional join / leave message hiding.

🛡️ Anti-Corruption Hardened
Atomic JSON writes via SafeFileIO, 5 rotated backups per file, auto-recovery on load failure. SpawnData validates dimensions, DimensionType clamps heights to vanilla limits. Strict input regex on lobby names and dimension ids (Windows reserved blocklist).

🌐 100% Bilingual EN/FR
Every user-facing string flows through LocalizationManager with both English and French translations. Detection per-player via client info — no manual switch needed.

🔑 Soft LuckPerms Integration
Permission nodes on every admin subcommand and on slot bypass. Weight-driven grade sorting + prefix rendering when LP is installed. Falls back silently to vanilla OP checks when it isn't. Listener subscribes to UserDataRecalculateEvent for live promotion / demotion updates.

1️⃣ Drop the jar in mods/ and start the server. Configs auto-generate.

2️⃣ Tune config.toml for the dimension. Set tablist.toml > enabled = true to activate the custom tab list.

3️⃣ Run /arcadia_spawn setspawn, /arcadia_spawn setlobbytp hub, and your warps are live.

4️⃣ Players type /lobby, /spawn, /arcadiartp. Open Tab. Watch the rank-sorted, animated tab list. Done.

🎨 Placeholders

Plug live data into your templates using %placeholder% tokens. Color codes follow Bukkit-style & syntax.

header_lines = [
  "%anim_scroll%",
  "",
  "&b&lArcadia &8• &f%server%",
  "&7%online%&8/&7%max% online",
  ""
]

footer_lines = [
  "",
  "%peers%",
  "",
  "&7Ping &a%player_ping%ms",
  "",
  "&6● &b&narcadia-echoes-of-power.fr&r &6●",
  "%anim_scroll%"
]

🎞️ Animations

Use %anim_<name>% to embed a cyclic animation frame. Refresh interval (default 10 ticks = 0.5 s) drives the animation rate.

%anim_scroll%       sliding bright spot in a bar
%anim_pulse%        single pulsing dot
%anim_loading%      three dots loading effect
%anim_rainbow%      color-cycling dot
%anim_title_color%  cyan/white cycle for headlines
%anim_blink%        bright bar that blinks
%anim_bar%          static full-width separator

/arcadia_spawn dimension create myworld flat
# → config/arcadia/spawn/dimensions/myworld.json created
# → restart the server for arcadia_custom:myworld to load

/arcadia_spawn dimension list
# • arcadia_custom:myworld  [LOADED]

/arcadia_spawn dimension delete myworld true
# Definition removed. _purge_myworld.marker written —
# manually delete world/dimensions/arcadia_custom/myworld
# after shutdown.

🏠 Dimension Spawn Personnalisée
La dimension arcadia:spawn est entièrement configurable — biome, couches de blocs, time lock, règles de spawn, hauteur, lumière ambiante, plafond. Plongez vos joueurs dans un monde hub contrôlé.

🚪 Menu Lobby Dynamique
/lobby ouvre un GUI listant chaque warp configuré. Chaque warp a sa propre icône et sa description bilingue. Ajout / édition live via /arcadia_spawn setlobbytp.

🎯 RTP Intelligent
/arcadiartp trouve une position sol sûre dans l'Overworld dans un rayon configurable. Limite par joueur, warmup avec annulation au mouvement, cooldown. Invocable depuis toute dimension.

📋 Tab List Thématique
Header / footer configurables avec placeholders, codes couleur &, et 7 animations intégrées (scroll, pulse, rainbow, loading, blink, bar, title_color). Refresh ajustable jusqu'à 5 ticks pour des animations fluides.

👑 Tri par Grade LuckPerms
Les joueurs sont placés dans des équipes Minecraft as_<999-weight>_<groupe> pour que le weight LP le plus haut reste en haut de la tab. Sans LP : fallback op-level propre (Owner → Default). Réagit à UserDataRecalculateEvent pour les promotions instantanées.

👻 Masquage Spectator
Les joueurs en /gamemode spectator disparaissent de la tab des non-spectateurs. Les autres spectateurs se voient toujours pour coordonner la modération. Server-authoritative via ClientboundPlayerInfoRemovePacket.

🌐 Compteur Cross-Server
Chaque serveur écrit sa ligne dans une table partagée arcadia_tablist_servers via la DB arcadia-lib, lit les autres, et affiche une ligne par peer dans le footer avec flag ALIVE / STALE. Tout le JDBC async — le main thread ne bloque jamais.

🗺️ Dimensions à la Demande
/arcadia_spawn dimension create <id> [preset] [biome]. Définitions JSON sous config/arcadia/spawn/dimensions/ enregistrées au démarrage sous le namespace arcadia_custom:. Presets flat, void, lobby.

🔐 Slot Bypass
Bypass de slot par permission. Les joueurs avec arcadia_spawn.slots.bypass contournent le slot limit quand le serveur est plein. Faux max-slots dans la liste serveur via mixin, masquage optionnel des messages join / leave.

🛡️ Anti-Corruption
Écritures JSON atomiques via SafeFileIO, 5 backups rotatifs par fichier, auto-recovery au load. SpawnData valide les dimensions, DimensionType clamp les hauteurs aux limites vanilla. Regex stricte sur les noms de lobby et IDs de dimension (blocklist Windows).

🌐 100% Bilingue EN/FR
Toutes les chaînes utilisateur passent par LocalizationManager avec traductions EN et FR. Détection par joueur via les infos client — pas de switch manuel.

🔑 Intégration LuckPerms Souple
Nodes de permission sur chaque sous-commande admin et sur le slot bypass. Tri par weight + rendu du préfixe quand LP est installé. Fallback silencieux sur les checks OP vanilla en son absence.

1️⃣ Posez le jar dans mods/ et démarrez le serveur. Les configs se génèrent.

2️⃣ Réglez config.toml pour la dimension. Passez tablist.toml > enabled = true pour activer la tab list.

3️⃣ Lancez /arcadia_spawn setspawn, /arcadia_spawn setlobbytp hub — vos warps sont en place.

4️⃣ Les joueurs tapent /lobby, /spawn, /arcadiartp. Tab. Profitez de la tab list triée par grade et animée. Terminé.

🔗 True Cross-Mod Progression
Tech and magic don't live in separate silos. Late-game crafts need both ecosystems. 4 custom bridge items 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 Spawn, Arcadia Lootbox, Arcadia Pets, Arcadia Guard, Prestige, 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. Fresh or 1000-hour veteran, you always know what to do next.