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

1. Download the JAR file.
2. Place it inside the main server's mods folder.
3. Remove older versions of Dungeon Blocker Safety Manager.
4. Fully restart the server.
5. 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.