DungeonUltimate

DungeonMod lets you build fully configurable dungeons in-game — no complicated commands, no datapacks. Build your dungeon, outline it with a wand, and the mod handles the rest. Every group plays its own instanced copy of the dungeon in a dedicated dimension, so everyone can run dungeons in parallel without getting in each other's way!

🧩 Built for servers: GUI-first workflow, optional integrations (Lightman's Currency, EasyNPC), zero required dependencies.

---

✨ Key features

🏗️ In-game dungeon creation

• Architect's Wand to select the dungeon area (2 corners).
• Dungeon Core: the brain of the dungeon, with a full GUI (admin & player).
• Dungeon Entrance and Dungeon Exit blocks to teleport players.

🎯 Multiple, independent objectives

• Several objectives per dungeon, each with an id, a free-text description and a type:
  • Kill a boss, Kill a number of mobs, or Manual.
• In-GUI objective editor (add / edit / delete), with one-click id copy.

🎁 Smart reward chests

• Real vanilla chest (3D render) with a selectable aura: §6gold (boss)§r or §7silver (normal)§r.
• Per-player loot: each player rolls their own loot (per-slot drop chance, %).
• Objective lock: a chest unlocks when its objective (or several, comma-separated) is completed.
• Chest presets: save/load a full chest config (copy-paste) — shared server-wide.

🧟 Configurable spawners

• Admin GUI: mobs per wave, number of waves, interval, spawn radius.
• List of all mobs (vanilla + modded) with search — click to add/remove.
• 🔗 EasyNPC integration (optional): spawn your exported NPCs straight from the spawner!
• Linked to the dungeon: they start on launch and stop on close.

🏰 Copy-based instancing (the heart of the mod)

• Each group (or solo player) gets their own copy of the dungeon in a dedicated dimension.
• Lag-friendly copy spread over several ticks (large dungeons supported).
• Automatic Adventure mode inside (creative/spectator admins are exempt), survival restored on exit.
• Robust cleanup: server restart, disconnects, dungeon deletion — all handled.

👥 Parties & cooldowns

• Built-in party system: create a party, invite (player list + search), enter solo or as a team.
• Kick vote among members (with reason: AFK / Troll).
• Per-dungeon reset cooldown (24h default, configurable) that pauses when a participant returns — tracked by UUID (leaving the party doesn't cancel it).

🛡️ Admin tools

• Reset all runs of a dungeon, or a specific player's run (list + search).
• Configurable max players per party.
• Dungeon deletion (button + command).

---

🎮 Getting started

1. Grab the Architect's Wand and Dungeon Core from the creative tab.
2. Build your dungeon, select the area with the wand, and link it to the Core.
3. Add objectives, reward chests, spawners, an entrance and an exit.
4. Enable instanced mode in the Core config — and you're ready!

---

🔌 Compatibility

• Minecraft 1.21.1 · NeoForge
• Optional integrations (no hard dependency): Lightman's Currency, EasyNPC.
• Server-side recommended; players need the mod for the GUIs.

💬 Support

Found a bug or have a suggestion? Leave a comment or open an issue. Happy dungeoning! ⚔️

---

Français

DungeonUltimate te permet de créer des donjons entièrement configurables en jeu , sans aucune commande compliquée ni datapack : tu construis ton donjon, tu les délimites avec une baguette, et le mod gère le reste. Chaque groupe joue sa propre copie instanciée du donjon, dans une dimension dédiée — pour que tout le monde puisse jouer en parallèle sans se gêner !

🧩 Pensé pour les serveurs : workflow GUI-first, intégration optionnelle (Lightman's Currency, EasyNPC), zéro dépendance obligatoire.

---

✨ Fonctionnalités principales

🏗️ Création de donjon en jeu

• Baguette d'Architecte pour sélectionner la zone du donjon (2 pièces).
• Noyau de Donjon : le cerveau du donjon, avec une interface complète (admin & joueur).
• Entrée et Sortie de Donjon : blocs dédiés pour téléporter les joueurs.

🎯 Objectifs multiples & indépendants

• Plusieurs objectifs par donjon, chacun avec un id , une description libre et un type :
  • Tuer un boss , Tuer un nombre de mobs, ou Manuel .
• Éditeur d'objectifs en GUI (ajouter / modifier / supprimer), avec copie d'id en un clic.

🎁 Coffres de récompense intelligente

• Vrai coffre vanille (rendu 3D) avec une aura au choix : §6dorée (boss)§r ou §7argentée (normal)§r.
• Loot par joueur : chaque joueur tire son propre butin (chances de drop réglables par case, %).
• Verrouillage par objectif : le coffre se déverrouille lorsque son objectif (ou plusieurs, séparés par des virgules) est accompli.
• Presets de coffre : sauvegarde/charge une config de coffre complet (copier-coller) — partagée sur tout le serveur.

🧟 Générateurs configurables

• Administrateur GUI : nombre de mobs par vague , nombre de vagues , intervalle , rayon de spawn .
• Liste de tous les mobs (vanilla + moddés) avec recherche — cliquez pour ajouter/retirer.
• 🔗 Intégration EasyNPC (optionnelle) : fais apparaître tes NPC exportés directement via le spawner !
• Liés au donjon : ils s'activent au lancement et s'arrêtent à la fermeture.

🏰 Instanciation par copie (le cœur du mod)

• Chaque groupe (ou joueur solo) obtient sa propre copie du donjon dans une dimension dédiée .
• Copie anti-lag étalée sur plusieurs ticks (gros donjons supportés).
• Mode Aventure automatique à l'intérieur (les admins en créatif/spectateur sont exemptés), survie restaurée à la sortie.
• Nettoyage robuste : restauré serveur, déconnexions, suppression de donjon — tout est géré.

👥 Groupes et temps de recharge

• Système de groupe interne : créer un groupe, inviter (liste de joueurs + recherche), entrer en solo ou en équipe.
• Vote d'exclusion entre membres (avec raison : AFK / Troll).
• Cooldown de reset par donjon (24h par défaut, configurable) qui se met en pause quand un participant revient — suivi par UUID (quitter le groupe n'annule rien).

🛡️ Outils admin

• Réinitialiser toutes les runs d'un donjon, ou le run d' un joueur précis (liste + recherche).
• Limite de joueurs max par groupe configurable.
• Suppression de donjon (bouton + commande).

---

🎮 Pour commencer

1. Récupère la Baguette d'Architecte et le Noyau de Donjon dans l'onglet créatif.
2. Construis ton donjon, sélectionne la zone avec la baguette, et lie-la au Noyau.
3. Ajout des objectifs , des coffres de récompense , des géniteurs , une entrée et une sortie .
4. Activez le mode instantané dans la config du Noyau — et c'est parti !

---

🔌 Compatibilité

• Minecraft 1.21.1 · NeoForge
• Intégrations optionnelles (sans dépendance obligatoire) : Lightman's Currency , EasyNPC .
• Côté serveur recommandé ; les joueurs ont besoin du mod pour les interfaces.

💬 Soutien

Un bug, une suggestion ? Laisse un commentaire ou ouvre un ticket. Bon donjon ! ⚔️