Dungeon RPG

Turn Minecraft combat into a replayable action-RPG adventure. Open dungeon gateways, battle level-scaled monsters and bosses, hunt randomized equipment, summon material-powered Friends, discover named unique items, and recycle unwanted gear at a Salvage Station.

Current compatibility: Minecraft Java Edition 26.2 with Fabric Loader and Fabric API.

Features

• Seven themed dungeons with different rooms, enemies, bosses, and rewards
• Summon combat Friends using any Dungeon RPG material
• 19 material-specific companions, including skeletons, wolves, golems, knights, and elemental creatures
• Friends follow their owner and fight hostile creatures inside or outside dungeons
• A non-linear castle finale with an unlockable Keep Gate
• Fully movable, resizable RPG HUD with a built-in editor
• Dungeon and equipment levels from 1 to 100
• Random Common, Magic, Rare, and Unique equipment
• 65 named unique items with special abilities
• Level-scaled weapons, armor, monsters, XP, durability, and companions
• Treasure chests, boss rewards, Health Orbs, and crafting materials
• Salvaging and repairing through the Salvage Station
• Multiplayer dungeon and companion support

Installation

Singleplayer

1. Install the Fabric Loader for Minecraft 26.2.
2. Download the matching Fabric API.
3. Place both fabric-api and dungeonrpg .jar files in your Minecraft mods folder.
4. Start Minecraft using the Fabric profile.

Multiplayer server

1. Install the Fabric server for Minecraft 26.2.
2. Place Fabric API and Dungeon RPG in the server's mods folder.
3. Place the same mods on every player's client.
4. Restart the server.

Do not unzip the mod .jar file.

Quick Start

Dungeon commands require cheats in singleplayer or operator permission on a server.

1. Stand in a flat, open area in the Overworld.
2. Run:

/dungeonrpg dungeon 1

3. A purple gateway will appear nearby.
4. Enter the gateway and explore the dungeon.
5. Defeat enemies, search for treasure chests, and defeat the boss.
6. Use the return gateway to leave with your loot.

The number is the dungeon level and can be any value from 1 to 100:

/dungeonrpg dungeon <level>

Start at level 1 and increase the level as your equipment improves. Dungeon type is selected randomly from the dungeons available at that level.

Summoned Friends

Every Dungeon RPG material can now be used as a summoning catalyst.

Hold a material and right-click to consume one material and summon its matching Friend. No separate spell, staff, or unlock is required.

Each player may have up to three active Friends. Summoning a fourth Friend dismisses the oldest one to make room.

Friends:

• Follow the player who summoned them
• Teleport back when they fall too far behind
• Follow their owner through dimension changes
• Fight nearby hostile mobs and Dungeon RPG monsters
• Prioritize enemies recently attacked by their owner
• Defend their owner from attacking enemies
• Cannot hurt their owner or another Friend belonging to the same owner
• Scale their health, armor, and damage with their owner's experience level
• Do not drop duplicated equipment or normal creature loot when defeated
• Can assist both inside and outside dungeons

Creative-mode players can summon Friends without consuming the material.

Material summons

Material	Summoned Friend
Wood Scrap	Timber Wolf
Leather Scrap	Tracker Hound
Stone Scrap	Stone Guardian
Gold Scrap	Golden Sellsword
Copper Scrap	Copper Tinkerer
Iron Scrap	Iron Golem
Diamond Scrap	Diamond Knight
Netherite Scrap	Netherite Revenant
Magic Enchant Scrap	Arcane Skeleton
Rare Enchant Scrap	Runebound Stray
Unique Enchant Scrap	Bone Champion
Dungeon Coin	Dungeon Hound
Arcane Crystal	Crystal Skeleton
Echo Fragment	Echo Vex
Ember Dust	Cinder Blaze
Frost Essence	Frost Golem
Verdant Sap	Verdant Wolf
Tidal Pearl	Tidebound Drowned
Royal Seal	Royal Guard

Materials remain useful for crafting and equipment repair, so decide whether to spend them on a Friend, save them for a recipe, or use them at a Salvage Station.

Controls

RPG HUD Editor

Press H in game to open the HUD Editor. The world stays running behind the editor, so you can position everything against a live HUD.

Control	Action
H	Open or close the RPG HUD Editor
Left-click + drag	Move the widget under the cursor
Mouse wheel	Resize the selected widget in 5% steps
Right-click a widget	Show or hide that widget
- / + buttons	Resize the selected widget in 5% steps
Show / Hide button	Toggle the selected widget
Reset All button	Restore every widget to its default position, size, and visibility
Done or Esc	Save and close

Widget size can be set anywhere between 45% and 150%. Positions are stored as a fraction of the screen, so your layout survives window resizing and resolution changes.

Nine widgets can be arranged independently:

Widget	Shows
Resources	Health, armor, hunger, and XP
Equipment	Currently worn armor and held items
Stats	Core combat statistics
Compass	Heading and direction
Target	The enemy you are currently looking at
Dungeon	Active dungeon name, level, and progress
Status Effects	Active potion and status effects
Breath / Mount	Air supply underwater and mount health
Item Details	Detail readout for the held item

The layout is saved to config/dungeonrpg-hud.json. To rebind the key, open Options → Controls → Key Binds and look for the Dungeon RPG HUD category.

Salvage Station

Control	Action
Sneak + right-click holding RPG gear	Salvage the item into scrap
Right-click holding damaged gear with matching scrap in the offhand	Repair 25% durability
Right-click with an empty hand	Show the station instructions in chat

Other

Control	Action
Right-click while holding a Dungeon RPG material	Consume it to summon its matching Friend
Hold right-click on a Health Orb	Consume it to recover health
Walk into a gateway	Enter or leave a dungeon

Dungeons

Dungeon	Available	Main material	What to expect
Hollow Crypt	Level 1+	Arcane Crystal	An undead crypt with rooms, treasure, and a boss encounter
Ember Sanctum	Level 1+	Ember Dust	A fire-themed stronghold filled with dangerous enemies
Verdant Ossuary	Level 3+	Verdant Sap	An overgrown jungle bone-temple with an optional branching loop
Frostbound Bastion	Level 5+	Frost Essence	An icy fortress with frozen hazards and enemies
Sunken Reliquary	Level 8+	Tidal Pearl	A half-flooded prismarine temple with waterlogged corridors
Echoing Depths	Level 10+	Echo Fragment	A large deep-dark dungeon culminating in a Warden encounter
Castle Nightspire	Level 20+	Royal Seal	A huge non-linear castle with three wings and a sealed keep

Dungeon Coins can be found in every dungeon. The other special materials only come from their matching dungeon.

Verdant Ossuary

A jungle temple slowly being eaten by the forest. Mangrove roots burst through the walls, shroomlights hang from the canopy, and jungle trunks punch straight through the ceilings.

The layout is not a straight line. Two alcoves branch off the Root Hall and both rejoin the Sunken Garden, so they can be cleared in either order or skipped entirely.

Enemies include Thorn Thralls, Mireborn Archers, Vine Stalkers, Spore Weavers, and Rootguards. The boss, The Bloomseer, is a caster rather than a bruiser and fights through summoned fangs and vexes.

Sunken Reliquary

A prismarine temple that never finished draining. Every corridor carries a water channel down its middle that slows you down, which is exactly what makes the ranged enemies dangerous.

Enemies include Tide Thralls, trident-throwing Tide Lancers, Reef Sentinels, Brine Hexers, and Deepwrought Husks. The boss, The Abyssal Sovereign, sits in a deep basin it cannot leave, so you choose between fighting from the dry rim or diving in after it.

Castle Nightspire

The largest dungeon in the mod and a deliberate break from the usual room-by-room layout.

A barbican and a raised causeway over a moat open into the Great Courtyard, which sits under a black sky pierced with lantern stars. From there, three wings branch in three directions on three different vertical levels:

• The Armory to the west, with a raised mezzanine
• The Cathedral to the east, a tall stained-glass vault
• The Black Cells far below, down a stairwell cut through the courtyard floor

The Keep Gate is sealed shut and cannot be mined. Each wing is guarded by a Sigil Warden, and killing one lights that wing's brazier. Clear all three in any order you like, the gate opens, and a grand staircase climbs to the throne room and Malachar, Sovereign of Nightspire — a wither-skeleton king fighting from horseback. A Royal Vault sits behind the throne.

Dungeon selection odds

Dungeon type is rolled randomly from everything unlocked at the requested level. Later dungeons appear more often as they unlock, but the earlier ones never disappear entirely.

Level	Odds
1-2	Hollow Crypt 50%, Ember Sanctum 50%
3-4	Hollow Crypt 33%, Ember Sanctum 33%, Verdant Ossuary 33%
5-7	Hollow Crypt 27%, Ember Sanctum 27%, Verdant Ossuary 27%, Frostbound Bastion 20%
8-9	Sunken Reliquary 22%, Verdant Ossuary 20%, Frostbound Bastion 20%, Hollow Crypt 19%, Ember Sanctum 19%
10-19	Echoing Depths 24%, Sunken Reliquary 19%, Frostbound Bastion 16%, Ember Sanctum 14%, Verdant Ossuary 14%, Hollow Crypt 13%
20-100	Echoing Depths 20%, Castle Nightspire 20%, Sunken Reliquary 16%, Frostbound Bastion 13%, Verdant Ossuary 11%, Hollow Crypt 10%, Ember Sanctum 10%

Gateway rules

• Gateways can only be opened in the Overworld.
• Move to a flatter, clearer area if the game cannot find room for the gateway.
• You cannot replace a dungeon while a player is still inside it.
• Defeat the boss before trying to close a completed gateway.
• The gateway remains available briefly after everyone leaves, allowing the group to return safely.

Loot and Progression

Equipment may appear as Common, Magic, Rare, or Unique. Higher rarity gear can have stronger stats and more valuable salvage rewards.

Generated loot includes weapons, bows, shields, and armor. Item stats and durability scale with the dungeon level where the item drops. Unique items keep their named identity and special power while scaling to the current dungeon level, up to level 100.

Useful tips:

• Compare the complete item tooltip, not only its vanilla material.
• Replace low-level equipment before attempting a large difficulty jump.
• Check ordinary and boss-room chests; boss rewards have better loot opportunities.
• Keep matching scraps for repairing favorite items.
• Save rare materials when you want stronger summoned Friends.
• Use a Friend to draw attention away from you during difficult encounters.
• Consume dropped Health Orbs when you need recovery during a run.
• In Castle Nightspire, the Sigil Wardens drop guaranteed high-quality chests, so no wing is optional if you want the full haul.

Salvage Station

Every dungeon includes a Salvage Station. You can also build one at your base.

Build your own

Place the following blocks:

• Crying Obsidian on the bottom
• Lodestone directly on top as the Salvage Core
• Anvil against one side of the Lodestone
• Grindstone on the opposite side
• Optional Crafting Table beside the station for recipes

The Anvil and Grindstone must face each other across the Lodestone. They may be placed east/west or north/south.

Scrap equipment

1. Hold an unwanted generated RPG weapon, armor piece, or shield in your main hand.
2. Sneak and use the Salvage Station (Shift + right-click).
3. The equipment is destroyed and converted into base scrap.
4. Magic or better equipment also gives an enchantment scrap matching its rarity tier.

Scrapping is permanent, so double-check the item first.

Repair equipment

1. Hold damaged generated RPG equipment in your main hand.
2. Put the matching base scrap in your offhand.
3. Use any block belonging to the Salvage Station without sneaking.

One matching scrap restores 25% of the item's maximum durability. For example, Iron Scrap repairs iron equipment and Diamond Scrap repairs diamond equipment.

Use the station with an empty hand to display its instructions in game.

Crafting Recipes

All Dungeon RPG recipes are shapeless, so the ingredients can be placed anywhere in a crafting grid.

Dungeon materials

Ingredients	Result
8 Dungeon Coins	1 Golden Apple
2 Arcane Crystals + 1 Glass Bottle	4 Bottles o' Enchanting
4 Echo Fragments + 1 Compass	1 Recovery Compass
4 Ember Dust + 1 Stick	1 Blaze Rod
4 Frost Essence + 1 Packed Ice	2 Blue Ice
3 Verdant Sap + 1 Glass Bottle	2 Honey Bottles
4 Tidal Pearls + 1 Prismarine Shard	1 Heart of the Sea
6 Royal Seals	1 Block of Gold

Scrap recovery

Ingredients	Result
4 Wood Scrap	2 Oak Planks
4 Leather Scrap	1 Leather
4 Stone Scrap	2 Cobblestone
8 Gold Scrap	1 Gold Ingot
6 Copper Scrap	1 Copper Ingot
6 Iron Scrap	1 Iron Ingot
8 Diamond Scrap	1 Diamond
8 Netherite Scrap	1 vanilla Netherite Scrap

Enchantment scrap

Ingredients	Result
4 Magic Enchant Scrap	1 Rare Enchant Scrap
4 Rare Enchant Scrap	1 Unique Enchant Scrap
1 Unique Enchant Scrap	4 Bottles o' Enchanting

Commands

These commands are intended for opening dungeons or testing the mod and require command permission.

Command	Purpose
/dungeonrpg dungeon	Open a random level-5 dungeon
/dungeonrpg dungeon <1-100>	Open a dungeon at the chosen level
/dungeonrpg item	Generate a random level-5 RPG item
/dungeonrpg item <1-100>	Generate a random RPG item at the chosen level
/dungeonrpg unique	Generate a level-5 unique item
/dungeonrpg unique <1-100>	Generate a unique available at the chosen level

Troubleshooting

Minecraft says the mod is missing dependencies

Install the correct Fabric API version and confirm that Fabric Loader, Fabric API, Dungeon RPG, and Minecraft are compatible with version 26.2.

The mod does not appear in game

• Confirm the .jar is directly inside the mods folder.
• Do not place the downloaded ZIP or source project in the mods folder.
• Launch the Fabric profile rather than the vanilla Minecraft profile.
• Check latest.log for a dependency or version error.

The HUD editor will not open

• The H key only works while you are in a world with no other screen open.
• Check for a conflict in Options → Controls → Key Binds, then rebind under the Dungeon RPG HUD category.
• If a widget has vanished, open the editor and press Reset All.
• Deleting config/dungeonrpg-hud.json restores the default layout on the next launch.

A Friend will not summon

• Hold a registered Dungeon RPG material.
• Right-click while looking into an open area.
• Wait briefly before attempting another summon.
• If you already have three Friends, summoning another replaces the oldest.
• Confirm that the server and client use the same Dungeon RPG version.

A Friend has fallen behind

Friends automatically attempt to follow their owner and teleport back when separated by a large distance. Continue moving into an open area if a Friend is temporarily obstructed.

The dungeon command does not work

• Enable cheats in singleplayer or ask a server administrator for operator permission.
• Use a level from 1 through 100.
• Stand in the Overworld.
• Move to a flat, open area if gateway placement fails.

The Keep Gate in Castle Nightspire will not open

• All three Sigil Wardens must be dead: one in the west Armory, one in the east Cathedral, and one in the Black Cells below the courtyard.
• A wing only registers as cleared while a player is nearby, so walk back through any wing whose brazier is still dark.
• Braziers that are already lit stay lit through a relog or server restart.

Multiplayer players cannot join

Make sure the server and every player use the same Minecraft, Fabric Loader, Fabric API, and Dungeon RPG versions.

A new dungeon cannot be opened

Have every player leave the active dungeon through its return gateway. If the boss is still alive, complete the dungeon first.

Feedback and Bug Reports

When reporting a problem, include:

• Minecraft version
• Fabric Loader version
• Fabric API version
• Dungeon RPG version
• Whether the problem occurred in singleplayer or multiplayer
• The material and Friend involved, if reporting a summoning problem
• The relevant section of latest.log
• Fabric API version
• Dungeon RPG version
• Whether it happened in singleplayer or multiplayer
• Steps that reproduce the issue
• The relevant section of .minecraft/logs/latest.log

Have fun, prepare carefully, and see how far your build can climb toward level 100.