🏷 MysticNameTags v1.1.7-hotfix

🧩 Server Compatibility

• Target Server Version: >= 2026.1.0
• Tested against Hytale server builds 2026.1.x
• Fully compatible with v1.1.7 configs, storage, tags, and integrations

No config or data migrations are required.

🚨 Hotfix Release

This hotfix resolves a critical server boot issue affecting setups that use HyperPerms alongside MysticNameTags.

🐛 Fixed HyperPerms Startup Dependency Conflict

Resolved an issue where MysticNameTags could create a cyclic plugin dependency with HyperPerms, preventing the server from starting.

Fixed behavior

Under certain environments, the server could fail during boot with an error similar to:

Found cyclic dependency between plugins:
com.hyperperms:HyperPerms waiting on: [MysticHorizons:MysticNameTags]
MysticHorizons:MysticNameTags waiting on: [com.hyperperms:HyperPerms]

This caused the server startup process to abort before the universe could initialize.

Root cause

MysticNameTags declared HyperPerms as an optional manifest dependency while HyperPerms also depended on MysticNameTags in its own load graph, creating a circular dependency chain.

Resolution

MysticNameTags no longer declares HyperPerms as a manifest-level optional dependency.

Instead, HyperPerms support is now handled entirely through MysticNameTags’ runtime integration detection system, which safely probes for the API only when available.

Result

Servers using HyperPerms should now boot normally without plugin load-order conflicts.

⚙ Integration Adjustment

HyperPerms detection remains supported

HyperPerms integration has not been removed.

MysticNameTags still supports:

• HyperPerms
• LuckPerms
• PermissionsPlus
• Native server permissions

The difference is that HyperPerms is now detected safely at runtime instead of being enforced through the plugin manifest.

This keeps compatibility intact while avoiding server boot failures.

Permission backend behavior

MysticNameTags continues to probe available permission systems and select the best supported backend automatically.

Supported providers remain:

1. HyperPerms
2. LuckPerms
3. PermissionsPlus
4. Native server permissions

If a provider is unavailable, MysticNameTags safely falls back to the next available system.

🛠 Internal Fixes

Safer optional integration loading

Improved how optional integrations are declared and initialized to reduce the chance of load-order conflicts with third-party plugins.

Improved startup stability

Resolved a critical startup edge case where plugin dependency resolution could fail before full server initialization.

No functional changes to tags or storage

This hotfix does not change:

• tag formats
• permissions syntax
• storage backends
• config structure
• API behavior for existing tags

📦 Summary

MysticNameTags v1.1.7-hotfix is a stability release focused on one critical fix:

• fixed HyperPerms-related cyclic dependency boot failure
• preserved full HyperPerms integration support
• improved plugin startup stability
• required no config or data migration