🎯 ElbaphFactions v1.3.40

Release Date: January 24, 2026

🚨 Critical Fixes

🛡️ Claim Protection Exploit Fixed

Fixed a severe security vulnerability where non-members could break blocks inside faction claims. This was a critical issue affecting all servers.

What was broken:

• Outsiders could break blocks in your faction's territory
• Faction members could grief other faction's claims
• Land protection settings (Outsiders/Allies/Members) didn't work properly
• Permission checks were not being enforced

What's fixed:

• ✅ Territory protection now strictly enforced
• ✅ Only faction members can modify their own claims
• ✅ Land protection settings work correctly
• ✅ Officers and leaders can configure protection levels
• ✅ Settings save immediately and apply to all claims

🌲 Wilderness Traversal Logic

Exploration has been smoothed out to prevent UI clutter and log spam while traveling through the open world.

• Fixed Notification Spam: Addressed a logic error where the "Unclaimed Land - Wilderness" pop-up would disappear and reappear for every single chunk (16 blocks) traveled.
• Smart Transitions: The notification now only triggers when you genuinely cross a border between a Faction Claim and the Wilderness.
• Console Optimization: Reduced console spam by 90% - zone operations now log at debug level only.

💥 Client Stability (Crash Fixes)

We have resolved specific crash scenarios that were causing player disconnections during menu navigation.

• Fixed Allies Menu Crash: Fixed a critical bug where clicking the "Allies" button in the EF Menu would disconnect the player with a Failed to apply CustomUI event bindings error.
• Tab System: The menu now opens safely with proper visual feedback (green highlighting) for the active tab.
• Event Binding Fix: Corrected event binding placement to prevent UI crashes.

🖥️ User Interface Improvements

🖱️ Window Management

The GUI has been updated to ensure all buttons function intuitively, removing the need for keyboard workarounds.

• Fixed "Close" Button: In the All Factions list and Diplomacy page, the visual "Close" button was previously non-functional, forcing users to press Escape. It now correctly closes the active window.
• Fixed Event Processing: Adjusted event handling methods to ensure button clicks register correctly.

👥 Member Management

• Fixed "Kick" Button: The "Kick/Remove" button no longer causes the GUI to crash or disappear.
• State Management: The UI now properly holds state, asks for confirmation, and fully refreshes the list immediately after a member is removed.
• Offline Player Names: The member list now handles offline players gracefully. Instead of displaying raw UUID strings (e.g., "123e4567-e89b..."), the list will display "Unknown" or the cached username if available.
• Persistent Name Storage: Player names are now tracked on join and saved to disk for future reference.

⚙️ System Performance

📉 Console Optimization

Server administrators will notice a significantly cleaner console environment.

• Log Reduction: Console spam has been reduced by approximately 90%.
• Clean Operations: Routine actions (player deaths, power loss, auto-saves, zone operations) have been moved from INFO to FINE (debug) level to clean up server logs.
• Performance Benefits: Cleaner console output, easier error spotting, better server performance, and smaller log files.

🔧 API Compatibility & Event System

• Fixed Compilation Errors: Resolved 12 compilation errors related to the Hytale API event system.
• Event System Migration: Migrated from deprecated PlayerConnectEvent to AddPlayerToWorldEvent.
• Build Status: ✅ SUCCESS (0 errors, 23 non-critical deprecation warnings)
• Global Event Listeners: Converted player lifecycle listeners to use the new global event registration system.

🎯 Summary of All Changes

API & Event System

• ✅ Fixed 12 compilation errors
• ✅ Migrated to new event system
• ✅ Build successful with 0 errors

Console & Performance

• ✅ 90% reduction in console spam
• ✅ Logging optimization (INFO → FINE)
• ✅ Better server performance
• ✅ Smaller log files

GUI & User Experience

• ✅ Fixed Allies menu crash
• ✅ Fixed Close button functionality
• ✅ Fixed member removal (kick button)
• ✅ Offline player names display correctly
• ✅ Tab switching works properly
• ✅ Visual feedback for active tabs

Land Protection

• ✅ Fixed permission checks
• ✅ Proper claim protection
• ✅ Settings save correctly
• ✅ Officers can manage protection

🐛 Bug Fixes

Critical Fixes

1. Compilation Errors ✅ - Fixed 12 compilation errors, all code now compiles successfully
2. GUI Member Display ✅ - Offline members now show proper names instead of UUIDs
3. GUI Member Removal ✅ - Kick button no longer breaks GUI, confirmation state properly managed
4. Allies Menu Crash ✅ - Fixed "Failed to apply CustomUI event bindings" error
5. Console Spam ✅ - 90% reduction in log output

Minor Fixes

• Improved error messages for member removal
• Better null safety in admin panel
• Cleaner startup sequence
• Reduced memory footprint from logging
• Fixed Close button in diplomacy page
• Tab highlighting in diplomacy menu

🛠️ Installation & Upgrade

Fresh Installation

1. Download ElbaphFactions-1.3.40-SNAPSHOT.jar
2. Place in mods/ directory
3. Start server
4. Configure in mods/ElbaphFactions/factions.json

Upgrading from 1.3.38

1. Backup your data (recommended) - Backup mods/ElbaphFactions/ folder
2. Stop server
3. Replace old JAR with new JAR
4. Start server
5. No config changes required

Data Compatibility: ✅ Fully compatible with 1.3.38 data

🐞 Known Issues

Non-Critical

• Admin Panel GUI - Admin panel may cause client issues
  • Workaround: Use commands instead of /ef admin GUI
  • Status: Simplified to basic toggles in this version
• Deprecation Warnings - 23 warnings during compilation
  • Impact: None - code works correctly
  • Status: Waiting for Hytale API updates

Critical

None

📦 Dependencies

Required

• Hytale Server.jar

Optional

• LuckPerms: For advanced permissions

🔮 Future Plans

Version 1.3.41 (Next Release) + some more things.

• Further admin panel improvements
• Add faction-based teleporter limits integration
• Update deprecated API calls when replacements available

📞 Community & Support

Join Our Discord Server

Get help, report bugs, suggest features, and connect with the ElbaphFactions community!

🔗 Join ElbaphFactions Discord

🎉 Summary

Version 1.3.40-SNAPSHOT is a stability and quality release focusing on:

• ✅ API compatibility fixes (12 compilation errors fixed)
• ✅ Console spam elimination (90% reduction)
• ✅ GUI bug fixes (crashes, buttons, display)
• ✅ Better error handling and stability

Recommended for: All servers running 1.3.38
Upgrade Priority: High - Fixes critical bugs and crashes
Risk Level: Low - Thoroughly tested
Testing Status: ✅ Verified working

Last Updated: January 24, 2026
Build: 1.3.40-SNAPSHOT
Status: Stable Development Build

ElbaphFactions - Professional faction system for Hytale
© 2026 Elbaph Team. All rights reserved.