Cobblemon Dungeon

Cobblemon Dungeon adds configurable dungeon-style content to Cobblemon.

Build and edit dungeons directly in-game using the dungeon editor, including dungeon areas, gates, progression conditions, trainer encounters, boss battles, Join NPCs, and clear rewards.

Dungeon data can also be adjusted with JSON files, allowing server owners and map creators to create custom adventure content without hardcoding everything into the mod.

The mod is designed for multiplayer use with shared dungeon spaces and individual player progression. Multiple players can enter the same dungeon at the same time, while battle progress, gate unlocks, rewards, and completion status are handled separately for each player.

Features

• Build and edit dungeon directly in-game with the dungeon editor
• Create custom dungeon areas, progression routes, gates, and unlock conditions
• Add trainer battles, boss trainer battles, miniboss areas, and boss Pokémon encounters
• Configure boss Pokémon with stat scaling and multiple HP gauges
• Set join conditions, Join NPCs, and clear rewards
• Support shared multiplayer dungeon spaces with individual player progression
• Fine-tune dungeon data with JSON-based advanced customization

Dungeon Editor

Cobblemon Dungeon includes an in-game dungeon editor to make dungeon setup easier.

The editor is designed to help server owners configure dungeon areas, gates, bounds, dungeon flow, trainer slots, and other dungeon-related data without relying only on manual JSON editing.

This is useful when creating or adjusting dungeons directly inside the game world.

Debug Sample Dungeons

For testing and setup reference, Cobblemon Dungeon includes debug commands that can instantly generate sample dungeon structures.

These commands are useful for checking how the dungeon system works, testing battles, and using the generated dungeon as a reference when building your own content.

Debug commands:

• /dungeon debug instanttest
• /dungeon debug instantbosstest

/dungeon debug instanttest creates a basic test dungeon for checking normal dungeon progression.

/dungeon debug instantbosstest creates a boss-focused test dungeon for checking boss battle features.

These debug dungeons are mainly intended for testing, development, and learning how the mod works.

Boss System

Cobblemon Dungeon supports two main types of boss encounters.

Trainer Boss

A trainer boss works like a normal Cobblemon trainer battle, but is used as a boss encounter inside the dungeon.

This is useful when you want a traditional trainer-style boss battle with a full Pokémon party.

Single Boss Pokémon

A single boss Pokémon encounter allows you to spawn one powerful Pokémon as the boss.

This type is useful for raid-style or RPG-style boss battles where players fight against one strong Pokémon instead of a full trainer party.

Boss Pokémon can be configured with special battle settings, such as:

• Increased stats
• HP scaling
• Multiple HP gauges
• Boss-specific tuning

This makes it possible to create stronger and more dramatic boss encounters than normal wild Pokémon battles.

Multiplayer Progression

Cobblemon Dungeon is designed for shared dungeon spaces with individual player progression.

Multiple players can enter the same dungeon, but battle progress, gate unlocks, rewards, and completion status are handled separately for each player.

This allows a server to provide dungeon content that can be reused by many players without forcing everyone to share the same progress state.

Server Owner Guide

This mod is mainly designed for server owners and map creators.

Players usually enter dungeons through Join NPCs, while administrators create and configure dungeon content using commands, the dungeon editor, and JSON files.

Basic setup flow:

1. Create or prepare a dungeon definition.
2. Set the dungeon entry and exit positions.
3. Set the dungeon bounds.
4. Create dungeon areas such as EXPLORE, MINIBOSS, and BOSS.
5. Set each area's spawn point and bounds.
6. Create gates between areas.
7. Add gate conditions to control progression.
8. Add trainer pool entries for normal, miniboss, and boss encounters.
9. Configure trainer bosses or single boss Pokémon.
10. Place trainer NPCs or exploration encounter slots.
11. Spawn a Join NPC if players should enter through an NPC.
12. Use /dungeon reload after editing dungeon data.

Configuration

Cobblemon Dungeon supports multiple setup methods:

• In-game command-based setup
• Dungeon editor setup
• JSON-based editing for detailed dungeon data

You can configure:

• Dungeon entry and exit positions
• Dungeon bounds
• Heal count
• Join cooldown
• Join conditions
• Dungeon areas
• Gates and gate conditions
• Dungeon flow
• Trainer encounters
• Miniboss battles
• Trainer boss battles
• Single boss Pokémon battles
• Boss Pokémon stats and HP settings
• Clear rewards
• Join NPC behavior and UI text

Main Commands

Basic:

• /dungeon list
• /dungeon join <id>
• /dungeon leave

Dungeon setup:

• /dungeon set entry <id>
• /dungeon set exit <id>
• /dungeon set healcount <id> <count>
• /dungeon set pos1 <id>
• /dungeon set pos2 <id>

Areas:

• /dungeon area create <dungeon> <area> <type>
• /dungeon area setspawn <dungeon> <area>
• /dungeon area setpos1 <dungeon> <area>
• /dungeon area setpos2 <dungeon> <area>
• /dungeon area list <dungeon>

Gates:

• /dungeon gate create <dungeon> <gate> <fromArea> <toArea>
• /dungeon gate delete <dungeon> <gate>
• /dungeon gate setpos1 <dungeon> <gate>
• /dungeon gate setpos2 <dungeon> <gate>
• /dungeon gate list <dungeon>

Trainer pools:

• /dungeon pool addcurrent <dungeon> <type> <id> [name]
• /dungeon pool remove <dungeon> <type> <id>
• /dungeon pool list <dungeon> <type>

NPCs:

• /dungeon npc create <dungeon> <trainer> <role> <trigger>
• /dungeon npc slot create <dungeon> <area> <slot> <trigger>
• /dungeon npc join spawn <dungeon>
• /dungeon npc join remove <dungeon>

Debug:

• /dungeon debug instanttest
• /dungeon debug instantbosstest

Reload:

• /dungeon reload

Notes

• This mod does not automatically generate normal gameplay dungeons in your world.
• Dungeon content is intended to be created and configured by server owners or map creators.
• Debug commands can generate sample dungeons for testing and reference.
• The dungeon editor is useful for in-game setup and adjustment.
• JSON files are useful for advanced configuration and fine-tuning.
• If you edit dungeon data manually, use /dungeon reload to apply the changes.

Requirements

• Minecraft 1.21.1
• Fabric
• Cobblemon
• Fabric API
• RCT API

Please make sure the required dependencies are installed on the client and server when needed.