🏠 ARCADIA SPAWN — DIMENSIONS, LOBBY, TAB & RTP 🏠

⚡ The spawn-side toolkit your server actually deserves ⚡

Custom dimension, dynamic lobby menu, RTP, themed tab list with LuckPerms rank sorting, cross-server player counts, slot bypass — all in one mod.

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

🇺🇸 Description (English) 🇺🇸

🌟 Turn your spawn into a full experience — without writing a single line of code. 🌟

🤔 Why Arcadia Spawn?

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

🎮 How to Use

It really is this simple:

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.

📋 The Tab List in Detail

Configure in config/arcadia/spawn/tablist.toml. Enable with tablist.enabled = true. Edit header_lines and footer_lines — each entry is one tab line.

🎨 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

🧩 Key placeholders you'll use most

Placeholder Resolves to %server% server_display_name from config, or ServerContext.SERVER_ID from arcadia-lib if empty. %online%, %max% Local player count / max slots. %tps%, %mspt% Server TPS / average ms-per-tick. %uptime% Server uptime (e.g. 3h 14m). %player_ping%, %player_playtime% Per-player info, resolved against the player who sees the tab. %lp_group%, %lp_prefix% LuckPerms primary group display name / prefix. %cross_total% Sum of online across all alive peers including self. %peers% Special — auto-expands to one footer line per cross-server peer with ALIVE / STALE flag.

Full configuration reference is documented in the README.md.

🗺️ Custom Dimensions On Demand

Create new dimensions live with a single command. Definitions are JSON files; presets save you from copying boilerplate.

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

Presets shipped: flat (default), void (single-air-layer void), lobby (time-locked at noon, smooth-quartz floor). Edit the JSON after creation to tune any of 25+ parameters.

📦 Requirements

Dependency Version Minecraft 1.21.1 NeoForge 21.1.219+ Java 21 Arcadia Lib required — 1.2.14+ (separate mod) LuckPerms optional (soft integration)

Arcadia Lib is a required dependency — install arcadia-lib 1.2.14 or newer as a separate mod in the same mods/ folder. LuckPerms is fully optional; the mod falls back to vanilla OP checks when it's absent.

🐛 Bugs & Support

Crash or unexpected behavior? We want to know.

Please include your full crash log, Arcadia Spawn + NeoForge versions, the relevant config / dimension JSON, and clear repro steps.

🤝 Contributing

Issues, suggestions, and bug reports are welcome on the public tracker.

🤝 Official Hosting Partner

Want to run your own modded server with Arcadia Spawn? Our official US / international partner offers high-performance Minecraft hosting optimized for modpacks.

🇫🇷 Description (Français) 🇫🇷

🌟 Transformez votre spawn en expérience complète — sans écrire une seule ligne de code. 🌟

🤔 Pourquoi Arcadia Spawn ?

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

🎮 Comment l'utiliser

C'est vraiment aussi simple :

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

📦 Prérequis

Dépendance Version Minecraft 1.21.1 NeoForge 21.1.219+ Java 21 Arcadia Lib requis — 1.2.14+ (mod séparé) LuckPerms optionnel (intégration souple)

Arcadia Lib est une dépendance requise — installez arcadia-lib 1.2.14 ou plus récent comme mod séparé dans le même dossier mods/. LuckPerms est totalement optionnel ; le mod retombe sur les checks OP vanilla en son absence.

🐛 Bugs & Support

Vous avez un crash ou un comportement inattendu ? On veut bien le savoir.

Merci d'inclure votre log de crash complet, vos versions d'Arcadia Spawn et NeoForge, le JSON de la dimension / config concernée le cas échéant, ainsi que des étapes claires pour reproduire.

🤝 Contribuer

Issues, suggestions et signalements de bugs sont les bienvenus sur le tracker public.

🤝 Hébergeur Officiel Partenaire

Vous souhaitez héberger votre propre serveur moddé avec Arcadia Spawn ? Notre partenaire officiel français propose un hébergement Minecraft haute performance optimisé pour les modpacks.

🌟 PLAY ARCADIA V2 — ECHOES OF POWER 🌟

⚡ Where Magic Meets Machinery ⚡

The flagship modpack Arcadia Spawn was built for — and ships in by default.

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

🎮 JOIN THE ADVENTURE — 490 MODS, ONE EPIC JOURNEY 🎮

🇫🇷 Découvrez Arcadia V2 : Echoes of Power
Le modpack phare pour lequel Arcadia Spawn a été conçu — et qui l'inclut par défaut. 490+ mods, 3 000+ quêtes, 5 serveurs actifs, 100 % bilingue EN/FR. Industrie + Magie + Exploration, comptez 150 à 300 heures pour atteindre l'endgame.

❤️ Support the Project / Soutenir le Projet

Your support helps us keep Arcadia alive and evolving!
Votre soutien nous aide à faire vivre et évoluer Arcadia !