LixPlusDungeons v1.0

---

LixPlusDungeons is a dungeon engine for Minecraft servers that lets you create custom dungeon runs inside your own builds.

You can create dungeons with room progression, locked entrances, keys, mob waves, final boss arenas, dungeon coins, merchants, shops, gods, prayers, rewards, parties and session-based dungeon runs.

The plugin is designed for RPG, Survival, SkyBlock, Dungeon and progression-based servers that need repeatable PvE dungeon content without being locked to one specific premade map or structure.

Important: LixPlusDungeons does not generate random maps. You build your own dungeon template, and the plugin can run dungeon sessions using temporary instance worlds based on your configured build.

---

• Temporary instance worlds: run dungeon sessions from your configured build instead of forcing every group into the same static area.
• Your own dungeon templates: you build the physical dungeon areas, while the plugin handles the run flow, rooms, gates, boss arena, rewards and cleanup.
• Party-based run start: players can prepare in a lobby, create or join a party, then start the run with a configured dungeon key.
• Room gates and progression: configure barriers, gates and room mobs so players progress through the dungeon step by step.
• Boss damage-top rewards: reward top damage dealers with command-based top-1, top-2 and top-3 reward logic.
• Dungeon coin economy: use dungeon coins for rewards, merchant shops and repeatable progression loops.
• Gods and prayers: add risk/reward prayer mechanics with prices, success chances, good outcomes and bad outcomes.
• MythicMobs support with fallback logic: use MythicMobs mobs and bosses, with fallback handling if a custom mob cannot be spawned.
• NPC support for instance worlds: supports copying Citizens and ZNPCsPlus NPCs into dungeon instance worlds.
• Automatic cleanup: cleanup logic for mobs, entities, drops and old dungeon instances.

---

---

A typical dungeon run works like this:

1. Players join a dungeon lobby.
2. Joining the lobby does not instantly start the dungeon.
3. Players can create or join a party before the run starts.
4. A configured dungeon key is used on the entrance lock to begin the dungeon.
5. The plugin starts and tracks the dungeon as an active dungeon session.
6. Players move through configured dungeon rooms.
7. Each room can have its own mobs, barriers, gates and progression setup.
8. Clearing a room can open the next passage or gate.
9. After the room progression is complete, players can enter the final boss arena.
10. The boss fight can give rewards and support damage-top reward mechanics.
11. Players can earn dungeon coins and spend them in configured merchant shops.
12. Players can interact with the gods and prayer system for positive or negative outcomes.
13. Dungeon runs can fail if all participants die.

---

LixPlusDungeons includes session-based dungeon run logic. This means the plugin tracks an active dungeon run separately from the static dungeon configuration.

This is useful for servers that want repeatable dungeon content where players or parties can start a run, progress through rooms, fight the final boss and receive rewards as part of that run.

• Active dungeon sessions: each started run is tracked as its own active session.
• Temporary instance worlds: dungeon runs can use temporary instance worlds based on your configured dungeon build.
• Party-based entry: players can prepare in a lobby and enter the dungeon as a party.
• Room progression tracking: the plugin tracks room flow during the run.
• Boss flow tracking: the final arena and boss fight are handled as part of the dungeon run.
• Repeatable dungeon content: the same dungeon configuration can be used again for future runs.
• Manual build control: server owners keep full control over the physical dungeon build and room layout.
• Cleanup handling: old instances, mobs, entities and drops can be cleaned up by the plugin.

Note: LixPlusDungeons does not generate random dungeon maps. Server owners build their own dungeon template and configure the lobby, rooms, gates, boss arena, merchants and other locations using the included setup tools.

---

• Room-based dungeon progression: create dungeons with a custom number of rooms.
• Dungeon lobby system: players can join a lobby before the dungeon starts.
• Dungeon session tracking: active dungeon runs are tracked by the plugin.
• Temporary instance world support: run dungeon sessions using instance worlds based on configured builds.
• Party support: players can create parties, invite others, accept invites, leave, kick members, view members and use party chat.
• Up to 5 players per party: suitable for small group dungeon runs.
• Keys and locks: use configured dungeon keys to start dungeon progression.
• Room barriers and gates: configure room passage barriers or scan existing nearby gate blocks.
• Room clear progression: clearing a room can open the next passage.
• Custom room mobs: configure mobs for individual dungeon rooms.
• MythicMobs support: use custom MythicMobs mobs and bosses if MythicMobs is installed.
• MythicMobs fallback handling: fallback logic is available if a MythicMob cannot be spawned.
• Final boss arena: configure a final arena, boss entry button and boss mob.
• Boss rewards: supports boss fight reward logic, including damage-top style rewards.
• Top damage reward commands: configure rewards for top-1, top-2 and top-3 boss damage positions.
• Dungeon coins: built-in dungeon coin system for rewards and shops.
• Merchants and shops: create dungeon merchants and open shop menus for players.
• Shop item types: shops can use items, effects and mob glow style products.
• Gods and prayers: configure gods, prayer prices, success/fail outcomes, custom prayer text and effects.
• Death and fail flow: dungeon runs can handle player death, spectator flow and failed runs.
• Active dungeon protection: command usage during active dungeon runs can be controlled to prevent bypasses.
• Admin setup GUI: setup menus for configuring dungeon locations and arena settings.
• Admin setup commands: commands for creating and editing dungeons.
• GUI editors: editor menus for arenas, rooms, mobs, gods, merchants, shop items and effects.
• NPC instance support: Citizens and ZNPCsPlus NPCs can be copied into instance worlds.
• Built-in localization: multiple languages are supported.

---

LixPlusDungeons includes setup commands and editor menus for creating and managing your dungeons.

You can configure:

• Dungeon creation
• Room amount
• Dungeon lobby location
• Room spawn location
• Dungeon exit location
• Entrance lock block
• Dungeon keys
• Room mobs
• Room barriers and gates
• Final arena spawn
• Boss arena button
• Boss mob
• Dungeon merchants
• Dungeon shop menus
• Shop products
• Shop item effects
• Gods and prayers
• Prayer success and fail effects
• Dungeon coins
• Plugin language

---

---

---

The gods and prayer system allows server owners to create custom dungeon-related prayer mechanics.

A prayer can have:

• A configured god
• A prayer price
• A success chance
• A success result
• A fail result
• Custom prayer text
• Positive effects
• Negative effects

This system can be used for risk/reward mechanics, dungeon buffs, penalties, progression systems or custom RPG-style server features.

---

LixPlusDungeons includes its own dungeon coin system.

Dungeon coins can be used for:

• Dungeon rewards
• Merchant shops
• Custom dungeon economy
• Progression-based purchases
• Reward loops for repeatable dungeon content

Merchant shop products can include:

• Items
• Effects
• Mob glow style products

Admins can give coins, check coin balances and create dungeon merchants that open shop menus for players.

---

Dungeons can include a final boss arena after room progression is complete.

You can configure:

• Final arena spawn point
• Boss entry button
• Boss mob
• Boss fight rewards
• Damage-top style reward logic
• Top-1, top-2 and top-3 reward commands

This is useful for servers that want dungeon runs to end with a clear final encounter instead of only basic room clearing.

---

MythicMobs support is optional.

If MythicMobs is installed, LixPlusDungeons can use custom MythicMobs mobs and bosses inside dungeon rooms and boss arenas.

Fallback logic is available if a MythicMob cannot be spawned. The plugin can also use fallback parsing for MythicMobs YAML values such as hp, damage and equipment.

This makes it useful for servers that already have custom mobs, custom bosses, skills, effects and RPG-style PvE content.

---

• Citizens: optional NPC support, including NPC handling for instance worlds.
• ZNPCsPlus: optional NPC support, including NPC handling for instance worlds.
• Vault / economy plugins: optional economy integration.
• NPC plugins: optional integration only, not required for the core dungeon system.

The plugin can be used without these integrations for basic dungeon setup, but they can be added if your server needs custom mobs, economy hooks or NPC-based interaction.

---

LixPlusDungeons includes built-in localization support.

Supported languages:

• English
• Ukrainian
• Russian
• Chinese
• Japanese
• Spanish
• Polish
• Kazakh

Available language codes:

---

• Paper/Spigot 1.21+
• Java 21

Paper is recommended.

---

• RPG servers
• Survival servers
• SkyBlock servers
• Progression-based servers
• Dungeon servers
• Boss fight servers
• Servers with MythicMobs content
• Servers that need repeatable PvE dungeon runs
• Servers that need custom boss fights and dungeon rewards
• Servers that need party-based dungeon sessions
• Servers that need instance-based dungeon gameplay from their own builds