ArcadiaDungeon

Arcadia Dungeon

---

🇬🇧 English

Create competitive dungeons on your Minecraft server — without writing a single line of code.

Arcadia Dungeon is a fully JSON-driven dungeon system for NeoForge 1.21.1 servers. Define your dungeons, bosses, enemy waves and rewards in configuration files, hot-reload them in-game, and you're done. The mod handles the rest: automatic scaling, combat phases, weekly leaderboard, and a full in-game admin GUI.

---

Features

Complete JSON Configuration

Every dungeon is described in a schema-validated JSON file. You control:

• Spawn point and dimension (multi-dimension supported)
• Global announcement messages on start, completion and failure (%player%, %dungeon% placeholders)
• Per-player, per-dungeon cooldowns
• Required Arcadia level to enter
• Speedrun mode with a time threshold and bonus XP
• Hot-reload without server restart

Adaptive & Multi-Phase Bosses

• Automatic scaling: boss health and damage are recalculated each run based on the number of players present (1.0 + multiplier × (players − 1))
• Successive phases triggered at configurable HP thresholds
• Invulnerability between phases for dramatic tension
• Post-spawn invulnerability (5 seconds by default, configurable)
• Per-phase minion summoning with custom messages
• Independent damage and speed multipliers per phase
• Server boss bar with configurable color
• Configurable damage type immunity

Enemy Waves

• Define wave sequences with entity types, quantities and delays
• Configurable required actions: kill all enemies, wait for a timer, etc.
• Waves chain automatically based on defined conditions

Weekly Leaderboard

• Best times per dungeon ranked in real time
• Automatic reset every Monday (day configurable)
• Scheduled weekly announcement with configurable broadcast hour
• Full archive of past weeks
• Separate rewards for top 1, top 2 and top 3
• Duplicate reward protection

In-Game Admin GUI

Manage everything from inside the game without complex commands:

• AdminGuiRouter: central administration panel
• Dungeon management: enable/disable, edit configs, force reload
• Active boss and entity management
• Player progression tracking: Arcadia XP levels, cooldowns, history
• Real-time support and diagnostic tools

Player Progression System

• Arcadia XP awarded on dungeon completion (amount configurable per dungeon)
• Minimum level requirement per dungeon
• Per-UUID tracking persisted in dedicated JSON files
• Independent cooldowns per player and per dungeon

Compatibility & Security

• Anti-parasite: prevents players from benefiting from a run without participating
• Anti-fly: bypassable via LuckPerms permission
• Permission nodes: arcadia_dungeon.bypass.antiparasite, arcadia_dungeon.bypass.antifly
• Checkpoint protection (SpawnSafety)
• Configurable auto-teleport back on completion

---

Commands

Players

Command	Description
/arcadiadungeon list	List available dungeons
/arcadiadungeon info <id>	Show dungeon details
/arcadiadungeon join <id>	Join a dungeon
/arcadiadungeon leave	Leave the current dungeon
/arcadiadungeon reload	Reload configurations (requires permission)

Administration

All admin commands are grouped under /arcadiaadmin with dedicated sub-trees: boss, wave, config, support.

---

Requirements

Required

Mod	Version
NeoForge	21.1.0 or higher
Minecraft	1.21.1
Arcadia Core	0.1.0 or higher

Arcadia Core is available on this same CurseForge page. Both mods must be installed together.

Optional

Mod	Purpose
LuckPerms	Fine-grained admin and bypass permissions
Spark	Server performance profiling

---

Installation

1. Download arcadia_dungeon-1.0.0.jar and arcadia_core-x.x.x.jar from CurseForge.
2. Place both files in the mods/ folder of your NeoForge 1.21.1 server.
3. Start the server once to generate the configuration folders.
4. Create your dungeon files in config/arcadia/dungeon/ using the JSON schema provided in the dungeon-configs/ folder.
5. Use /arcadiaadmin config reload to reload configurations without restarting.

---

Compatibility

	Support
Minecraft 1.21.1	✅
NeoForge 21.1.x	✅
Dedicated server	✅ Recommended
Singleplayer	⚠️ Not designed for solo
Forge	❌
Fabric / Quilt	❌

---

🇫🇷 Français

Créez des donjons compétitifs sur votre serveur Minecraft — sans écrire une seule ligne de code.

Arcadia Dungeon est un système de donjons entièrement piloté par JSON pour serveurs NeoForge 1.21.1. Définissez vos donjons, vos boss, vos vagues d'ennemis et vos récompenses dans des fichiers de configuration, rechargez à chaud en jeu, et c'est prêt. Le mod gère le reste : scaling automatique, phases de combat, classement hebdomadaire, et interface d'administration in-game complète.

---

Fonctionnalités

Configuration JSON complète

Chaque donjon est décrit dans un fichier JSON validé par schéma. Vous contrôlez :

• Le point de spawn et la dimension (multi-dimension supporté)
• Les messages d'annonce globaux au démarrage, à la complétion et en cas d'échec (%player%, %dungeon% disponibles)
• Les cooldowns post-complétion par joueur et par donjon
• Le niveau Arcadia minimum requis pour entrer
• Un mode speedrun avec seuil de temps et XP bonus
• Le rechargement à chaud sans redémarrage du serveur

Bosses adaptatifs et multi-phases

• Scaling automatique : la santé et les dégâts du boss sont recalculés à chaque run selon le nombre de joueurs présents (1.0 + multiplicateur × (joueurs − 1))
• Phases successives déclenchées à des seuils de PV configurables
• Invulnérabilité entre les phases pour renforcer la tension dramatique
• Invulnérabilité post-spawn (5 secondes par défaut, configurable)
• Invocation de sbires par phase avec messages personnalisés
• Multiplicateurs de dégâts et de vitesse indépendants par phase
• Boss bar serveur avec couleur configurable
• Immunité à des types de dégâts configurable

Vagues d'ennemis

• Définissez des séquences de vagues avec types d'entités, quantités et délais
• Actions requises paramétrables : éliminer tous les ennemis, attendre un délai, etc.
• Les vagues s'enchaînent automatiquement selon les conditions définies

Leaderboard hebdomadaire

• Classement des meilleurs temps par donjon, mis à jour en temps réel
• Réinitialisation automatique chaque lundi (jour configurable)
• Annonce hebdomadaire programmée avec l'heure de diffusion configurable
• Archivage complet des semaines précédentes
• Récompenses distinctes pour le top 1, top 2 et top 3
• Protection contre les doublons de récompenses

Interface d'administration in-game (GUI)

Tout se gère depuis le jeu sans taper de commandes complexes :

• AdminGuiRouter : panneau central d'administration
• Gestion des donjons : activer/désactiver, modifier les configs, forcer un reload
• Gestion des boss et entités actifs
• Suivi de la progression joueur : niveaux Arcadia XP, cooldowns, historique
• Outils de support et diagnostic en temps réel

Système de progression joueur

• XP Arcadia attribué à la complétion (montant configurable par donjon)
• Niveau minimum requis pour accéder à certains donjons
• Suivi individuel par UUID, persisté dans des fichiers JSON dédiés
• Cooldowns indépendants par joueur et par donjon

Compatibilité et sécurité

• Anti-parasite : empêche les joueurs de profiter d'un run sans participer
• Anti-fly : désactivable via permission LuckPerms
• Nœuds de permission : arcadia_dungeon.bypass.antiparasite, arcadia_dungeon.bypass.antifly
• Protection des checkpoints (SpawnSafety)
• Téléportation automatique de retour à la complétion (configurable)

---

Commandes

Joueurs

Commande	Description
/arcadiadungeon list	Liste les donjons disponibles
/arcadiadungeon info <id>	Affiche les détails d'un donjon
/arcadiadungeon join <id>	Rejoint un donjon
/arcadiadungeon leave	Quitte le donjon en cours
/arcadiadungeon reload	Recharge les configurations (permission requise)

Administration

Toutes les commandes admin sont regroupées sous /arcadiaadmin avec des sous-arbres dédiés : boss, wave, config, support.

---

Dépendances

Requises

Mod	Version
NeoForge	21.1.0 ou supérieur
Minecraft	1.21.1
Arcadia Core	0.1.0 ou supérieur

Arcadia Core est disponible sur cette même page CurseForge. Les deux mods doivent être installés ensemble.

Optionnelles

Mod	Utilité
LuckPerms	Gestion fine des permissions admin et bypass
Spark	Profilage de performance serveur

---

Installation

1. Téléchargez arcadia_dungeon-1.0.0.jar et arcadia_core-x.x.x.jar depuis CurseForge.
2. Placez les deux fichiers dans le dossier mods/ de votre serveur NeoForge 1.21.1.
3. Démarrez le serveur une première fois pour générer les dossiers de configuration.
4. Créez vos fichiers de donjon dans config/arcadia/dungeon/ en vous basant sur le schéma JSON fourni dans le dossier dungeon-configs/.
5. Utilisez /arcadiaadmin config reload pour recharger les configurations sans redémarrer.

---

Compatibilité

	Support
Minecraft 1.21.1	✅
NeoForge 21.1.x	✅
Serveur dédié	✅ Recommandé
Client solo	⚠️ Non conçu pour solo
Forge	❌
Fabric / Quilt	❌

---

Auteurs / Authors

Developed by Blushister and vyrriox — Arcadia Project.

Issue tracker: github.com/Blushister

---

Licence / License

© All Rights Reserved — Arcadia. Redistribution and modification are prohibited without the explicit consent of the authors.