Orbis & Dungeons (RPG class mod)

Version 2026.2.9 - Unified Commands, Mod Integration, Smart Resets & UI Modernization

🎮 Unified Command System (Complete Overhaul)

All legacy commands have been replaced with a clean, unified structure using 4 base commands with subcommands:

Old → New Command Migration

/race — Race Management

/class — Class Management

/build — Combined Race + Class (NEW)

/language — Language Management (NEW)

Architecture: Each command extends AbstractPlayerCommand with withOptionalArg("player", ...) for admin targeting.

🔄 Smart Reset Commands with Auto-UI

Reset commands now automatically open the corresponding selection UI, eliminating the need for players to manually re-open the UI after a reset.

Technical Implementation:

• RaceSelectionPage now has a raceOnly mode:
  • Normal mode (/build select, /build reset): confirm → opens ClassSelectionPage
  • Race-only mode (/race reset): confirm → applies race + saved class directly → this.close()
• /race reset: Saves the player's current class before resetting, then opens RaceSelectionPage(targetRef, true, savedClass). After race selection, the saved class is reapplied automatically.
• /class reset: Keeps the race, sets class to "none", opens ClassSelectionPage(targetRef, currentRace).

Translation Keys Added:

• command.race.reset.opening_ui / command.race.reset.ui_failed
• command.class.reset.opening_ui / command.class.reset.ui_failed
• command.build.reset.success_self / command.build.reset.success_other / command.build.reset.by_admin
• command.build.reset.failed / command.build.reset.opening_ui / command.build.reset.ui_failed

🔌 Mod Integration System (NEW)

RPGLeveling Integration

Automatic stat synchronization with RPGLeveling mod:

• Event-Driven Sync: Listens for level-up events and reapplies race/class bonuses
• Additive System: Race bonuses stack with RPGLeveling stats (no conflicts)
• Zero Dependencies: Uses reflection — works with or without RPGLeveling installed

Architecture:

• ModIntegration.java — Main facade with auto-detection
• RPGLevelingIntegration.java — Event handling and stat sync (all output via System.out to avoid SEVERE log issues)
• HardcoreModeIntegration.java — Difficulty scaling API

HardcoreMode Integration

Dynamic difficulty scaling based on race and class:

Spawn Rate Modifiers: Orc/Dwarf +20% spawns, Elf/Tiefling -20% spawns.

⚖️ Balance Changes

Orc — Major Buff (Pure Tank Role)

Design: Orc is now the ultimate tank with the highest HP pool in the game (200). Trades stamina for raw survivability.

Dwarf — Resistance Adjustment

Slightly toned down physical resistance for better balance. Fall resistance remains at 50%.

🎨 UI System Modernization

Complete UI Redesign (850×600px)

• Modern Aesthetic: Gradient backgrounds, rounded corners (6-8px), hover/pressed animations
• Color Palette: #1a1a1a backgrounds, #d4af37 gold accents, #4d8ac0 selection borders
• Enhanced Layout: 300px list panel, 60px auto-width buttons, clear section separation
• Reusable Components (Common.ui): @PageOverlay, @DecoratedContainer, @Title, @Subtitle, @BackButton, @TextButton, @SecondaryTextButton, @CancelTextButton, @DefaultScrollbarStyle, @SelectionCard

Fixed: UTF-8 BOM Encoding

• .ui files must be UTF-8 without BOM — fixed all UI files to remove BOM bytes that prevented Hytale from parsing them.

Fixed: Invalid Template References

• Replaced @PageButton (does not exist) with @SecondaryTextButton across all UI files.
• Fixed #Title and #Content — these are Group slots in @DecoratedContainer, not Labels.

🐛 Critical Bug Fixes

Fixed: Mod Not Loading (SEVERE Log Issue)

Problem: After adding mod integrations, the plugin loaded but never "Enabled" — commands and UI didn't work.

Root Cause: RPGLevelingIntegration.java used System.err.println() and e.printStackTrace() which output as SEVERE in the Hytale log. The PluginManager treats SEVERE output during start() as a plugin failure.

Solution: Changed all System.err.println → System.out.println, removed e.printStackTrace(), made error messages indicate non-fatal status.

Rule Discovered: Never use System.err or e.printStackTrace() in Hytale plugins — always use System.out.println for all mod logging.

Fixed: Hardcoded Translation Keys

• Race UI now dynamically reads strengths/weaknesses from RaceConfig instead of hardcoded translation keys.
• Empty slots no longer show raw keys like "race.finstermensch.strength.3".

Fixed: Race Descriptions Not Updating from Config

• Race UI now reads descriptions from config file (like class UI already did).

Fixed: CustomUI Selector Mismatches

• Fixed cmd.set() selectors that referenced non-existent UI element IDs.
• Added missing IDs to .ui files: #StrengthsHeader, #WeaknessesHeader, #PrevPageButton, etc.

🌐 Translation System

Spanish Translation Added

Complete Spanish (es.json) translation — 127+ keys covering all commands, UI, races, and classes.

Supported Languages (4 total)

Usage: /language set es (replaces old /racesetlanguage --confirm --language=es)

📚 New Documentation

• docs/UI_SYSTEM.md — Complete UI system reference (components, colors, Java integration, events)
• docs/MOD_INTEGRATION.md — Mod integration guide (RPGLeveling, HardcoreMode)

📝 Files Modified/Created

Java Files (New):

• commands/RaceCommands.java — /race command with 5 subcommands
• commands/ClassCommands.java — /class command with 4 subcommands
• commands/BuildCommands.java — /build command with 4 subcommands
• commands/LanguageCommands.java — /language command with 3 subcommands
• integration/ModIntegration.java — Integration facade
• integration/RPGLevelingIntegration.java — RPGLeveling integration
• integration/HardcoreModeIntegration.java — HardcoreMode integration

Java Files (Modified):

• ui/RaceSelectionPage.java — Added raceOnly mode, dynamic config loading, fixed templates
• ui/ClassSelectionPage.java — Fixed templates, consistent with RaceSelectionPage
• RaceMod.java — Registers 4 unified commands + ModIntegration.initialize()
• RaceManager.java — Updated stat application for Orc balance changes

UI Files (Modified):

• Common/UI/Common.ui — Added 10 reusable components
• Custom/Pages/race_selection.ui — Complete redesign (850×600), BOM removed
• Custom/Pages/class_selection.ui — Complete redesign (850×600), BOM removed

Translation Files (Modified):

• en.json, pt_br.json, ru.json — Added 20+ new keys for unified commands and reset UIs
• es.json — NEW complete Spanish translation

Java Files (Removed):

• commands/RaceSelectCommand.java — Replaced by /race select
• commands/TradeClassCommand.java — Replaced by /class change
• commands/ResetClassCommand.java — Replaced by /class reset
• commands/SetLanguageCommand.java — Replaced by /language set

🚀 For Server Admins

Breaking Changes:

• ⚠️ All old commands (/racetrade, /resetclass, /tradeclass, /racereset, /raceselect, /racesetlanguage) are removed
• Use the new unified commands: /race, /class, /build, /language
• If coming from pre-2026.2.9, delete races_config.json to get updated Orc stats (200 HP, -2 Stamina)

Update Steps:

1. Replace JAR file
2. Delete old races_config.json (to get Orc balance update)
3. Restart server
4. Verify with /race info and /build info

What Players Will Notice:

• ✅ New cleaner commands (/race, /class, /build)
• ✅ Reset commands auto-open selection UI (no manual /race select needed)
• ✅ Modern, polished UI with hover effects
• ✅ Spanish language available
• ✅ Orc is now 200 HP (massive tank buff)