DungeonRPG

Minecraft 版本： 26.2

平台： fabric

标签： adventure equipment minigame

Dungeon RPG

Turn Minecraft combat into a replayable action-RPG adventure. Open dungeon gateways, battle level-scaled monsters and bosses, hunt randomized equipment, 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
• 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, and durability
• Treasure chests, boss rewards, Health Orbs, and crafting materials
• Salvaging and repairing through the Salvage Station
• Multiplayer dungeon 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.

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.

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:

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

Other

Dungeons

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.

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.
• 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

Scrap recovery

Enchantment scrap

Commands

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

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.

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 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.