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

Download arcadia_dungeon-1.0.0.jar and arcadia_core-x.x.x.jar from CurseForge.
Place both files in the mods/ folder of your NeoForge 1.21.1 server.
Start the server once to generate the configuration folders.
Create your dungeon files in config/arcadia/dungeon/ using the JSON schema provided in the dungeon-configs/ folder.
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

Téléchargez arcadia_dungeon-1.0.0.jar et arcadia_core-x.x.x.jar depuis CurseForge.
Placez les deux fichiers dans le dossier mods/ de votre serveur NeoForge 1.21.1.
Démarrez le serveur une première fois pour générer les dossiers de configuration.
Créez vos fichiers de donjon dans config/arcadia/dungeon/ en vous basant sur le schéma JSON fourni dans le dossier dungeon-configs/.
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

Arcadia Dungeon

🇬🇧 English

Features

Complete JSON Configuration

Adaptive & Multi-Phase Bosses

Enemy Waves

Weekly Leaderboard

In-Game Admin GUI

Player Progression System

Compatibility & Security

Commands

Players

Administration

Requirements

Required

Optional

Installation

Compatibility

🇫🇷 Français

Fonctionnalités

Configuration JSON complète

Bosses adaptatifs et multi-phases

Vagues d'ennemis

Leaderboard hebdomadaire

Interface d'administration in-game (GUI)

Système de progression joueur

Compatibilité et sécurité

Commandes

Joueurs

Administration

Dépendances

Requises

Optionnelles

Installation

Compatibilité

Auteurs / Authors

Licence / License

ArcadiaDungeon