Dungeon Blocker Safety Manager

Overview

Dungeon Blocker Safety Manager is designed for Hytale server networks that run their main world and dungeon content on separate servers.

On the main server, the mod prevents players from activating portal and dungeon keys. This stops unwanted dungeon instances from being created in the background.

The keys remain normal inventory items and can still be crafted, traded, stored, and transferred to a separate dungeon server through an existing inventory synchronization system.

Important: Install this mod only on the main server.
Do not install it on the dungeon server, or the keys will also be disabled there.

Features

Prevents portal and dungeon keys from being activated on the main server
Stops unwanted instance-* dungeon worlds from being created
Keeps keys inside the player's inventory
Preserves item IDs, names, rarities, icons, and stack amounts
Allows keys to remain craftable, tradable, and storable
Supports different dungeon mods and multiple portal key systems
Allows players to carry their keys to a separate dungeon server
Prevents broken or unfinished dungeon instances
Helps protect the main server from restart loops and startup problems
No portal stones or dungeon keys need to be removed from the server

Why This Mod Exists

Blocking a dungeon only when its world is already being created can be too late.

Some dungeon systems begin creating an instance in the background before the player is transferred. If that process is interrupted, an unfinished dungeon world may remain saved on the server.

This can cause problems such as:

The server becoming stuck during startup
Players being unable to join
Broken dungeon instances loading again after every restart
Plugins waiting for an instance that never finished loading
Watchdogs repeatedly restarting the server

Dungeon Blocker Safety Manager prevents the key from starting the dungeon process on the main server.

Example

Main Server:
PortalKey_Shivas_Ice_Cave x1

Key activation is blocked.
The key remains in the player's inventory.

Server Transfer:
The inventory synchronization system transfers the key.

Dungeon Server:
The original dungeon mod is installed.
Dungeon Blocker Safety Manager is not installed.
The key works normally and the dungeon can be started.

Installation

Download the JAR file.
Place it inside the main server's mods folder.
Remove older versions of Dungeon Blocker Safety Manager.
Fully restart the server.
Do not install the mod on the dungeon server.

The dungeon server must still contain the original dungeon mods and key assets.

Server Setup Requirements

This mod does not connect servers by itself.

For a complete multi-server setup, you need a separate system for:

Inventory synchronization
Server transfers
Proxy or portal connections
Player data synchronization

The same dungeon key item IDs must exist on both servers.

Main Server Behavior

On the main server:

Dungeon and portal keys cannot be activated
Keys are not removed
Keys can still be crafted
Keys can still be traded
Keys can still be stored
Keys can be transferred to the dungeon server

Dungeon Server Behavior

On the dungeon server:

Do not install Dungeon Blocker Safety Manager
Install the original dungeon mods
Install all required dungeon assets
Keep the same key item IDs
Keys will work normally

Compatibility

Developed for Hytale Server 0.5.7
Designed for multi-server networks
Intended for setups with a separate main server and dungeon server
Supports different dungeon mods and portal key systems
Does not rely on a single dungeon name

Endless Leveling

The Endless Leveling dungeon tab is separate from the portal key protection.

A customized Endless Leveling build can redirect the dungeon tab and display a message instead of opening the dungeon menu.

The general Dungeon Blocker Safety Manager JAR handles the key protection. The customized Endless Leveling build handles the menu redirect.

What This Mod Does Not Do

It does not synchronize inventories
It does not connect servers
It does not configure a proxy
It does not transfer levels, money, skills, or classes
It does not install dungeon mods
It does not remove keys or recipes
It does not automatically configure the dungeon server
It does not block keys on servers where the mod is not installed

Important Notes

Use this mod only on the server where dungeon keys must be disabled.

The original dungeon mods must still be installed on the dungeon server.

Test the setup with one key before making it available to all players.

Credits

Originally developed for the Tale-World Hytale server network.

❤️ Support

If you enjoy this mod, consider leaving a ⭐ on CurseForge!

You can also support my work here:

🔗 Check Out My Other Hytale Projects

Take a look at my other Hytale mods and projects here:

👉 DerFriesn CurseForge Projects

Tale-World German Community

Tale-World is my German Hytale community server project.

IP: play.tale-world.com
Website: https://tale-world.com/
Discord: https://discord.gg/qJqGKBMgM8

Come join the community, test the mod, give feedback and help shape the future of Tale-World.