KS Dungeons

A complete procedural dungeon system for Hytale servers. Generate biome-themed dungeons with scaling difficulty, party up with friends, tackle randomized modifiers, defeat epic bosses, and earn personal loot — all fully configurable.

Main Command: /ksdungeon (Aliases: dungeon, dg)

---

Features at a Glance

Procedural Generation

Every dungeon run is unique. Rooms are assembled from configurable templates with randomized layouts, mob spawns, traps, and treasure placement.

Party System

Team up with other players before entering a dungeon:

• Create, invite, join, and leave parties
• Shared team lives pool
• Party leader controls dungeon entry
• Automatic voice channel integration (with VoiceHub)

Difficulty System

Dungeons scale in challenge across multiple tiers:

Difficulty	Description
Normal	Standard enemies, baseline rewards
Hard	Increased mob health and damage, better loot
Nightmare	Elite mobs, reduced lives, rare drops
Mythic	Maximum challenge, exclusive rewards, leaderboard scoring

Modifiers

Each run can apply random modifiers that change gameplay:

• Thorns — mobs reflect a percentage of damage
• Haste — mobs move and attack faster
• Darkness — reduced visibility
• Fragile — players take increased damage
• Bounty — increased loot but fewer lives
• Fully configurable — add, remove, or create custom modifiers

Boss Encounters

Each biome features a unique boss fight with mechanics:

• Multi-phase encounters with health thresholds
• Arena-based fights with environmental hazards
• Guaranteed boss loot table with rarity scaling

Personal Loot

Loot is generated per player — no fighting over drops:

• Configurable loot tables per biome and difficulty
• Rarity scaling with difficulty tier
• Bonus loot for modifier challenges
• Token rewards for the dungeon shop

Scoring & Leaderboards

Performance is tracked and scored:

• Time-based scoring with bonuses
• Kill count and death penalty tracking
• Modifier multipliers
• Server-wide leaderboards per biome and difficulty

---

Biomes

Biome	Theme	Boss
Caverns	Underground tunnels, lava pits, rock traps	Stone Golem
Jungle	Dense vegetation, poison traps, vine bridges	Ancient Treant
Frost	Ice platforms, freezing debuffs, sliding floors	Frost Wyrm
Void	Floating platforms, gravity shifts, void zones	Void Sentinel
Undead	Crypts, bone piles, resurrection mechanics	Lich King

Each biome has its own room templates, mob pool, trap set, and loot table.

---

Quick Start

1. Install the KS Dungeons JAR in your server's mods/ folder
2. Start the server — default config, biomes, and room templates are created
3. Place a Dungeon Portal block or configure an NPC to open the dungeon menu
4. Players use /ksdungeon play to browse available dungeons
5. Create a party with /ksdungeon party create, invite friends, and enter!

---

Requirements

• Hytale Server (Update 3+)
• Java 25
• KyuubiSoft Core required (citizens, loot, UI framework)
• Optional: VoiceHub (automatic party voice channels)
• Optional: Season Pass (dungeon token rewards as challenge objectives)