HyperFactions

⚔️ HyperFactions v0.12.0

Massive update — in-game config editor, backup manager, update checker, two new data importers, 10-language localization, and a greatly expanded API.

🛰️ Server Version: 2026.02.19-1a311a592

💬 Built-in Localization (i18n)

• 🌍 10 languages out of the box — English, German, Spanish, French, Italian, Dutch, Polish, Portuguese, Russian, Filipino
• 📝 ~467 translation entries per locale covering all commands, GUI labels, and help content
• 🎯 Player language auto-detection with configurable default and per-player override
• 📖 Markdown-based help content system with translation guide

⚙️ Admin GUI: Runtime Config Editor

• 📋 11-tab config editor — Server, Chat, Announcements, Economy, Factions, Faction Perms, Worldmap, Worlds, Backup, Debug, Gravestones
• 📐 Size-adaptive layouts: narrow (520px, 1-col), standard (780px, 2-col), wide (1020px, 4-col)
• ✏️ Inline editing — boolean toggles, integer/double steppers, text fields, color pickers, enum dropdowns, locale selectors
• 🔐 Faction permissions editor with parent/child toggling and Default/Lock checkboxes per flag
• 🌐 World overrides editor with add/remove worlds and tri-state per-world settings
• 📊 Upkeep scaling tiers modal with add/remove/reorder, promote/demote buttons, and live cost example
• 💾 Edit session caching — pending changes survive page close/reopen and modal round-trips
• ⚠️ Input validation with per-field error highlighting and save-blocked-on-invalid state

💾 Admin GUI: Backup Manager

• 📄 Paginated backup list with expand/collapse detail view per entry
• ➕ Create manual backups with optional custom name
• 🔄 Restore backups with two-click confirmation and automatic safety backup
• 🗑️ Delete backups with two-click confirmation
• 🔍 Filter by type: All / Hourly / Daily / Weekly / Manual / Migration

🔄 Admin GUI: Updates Page

• 📊 Two-column layout: HyperFactions (left) and HyperProtect-Mixin (right)
• 📦 Shows current version, latest version, channel, build date, and update status
• ⬇️ Download buttons appear when updates are available
• ⏪ Rollback support with two-click confirmation

📦 Data Importers

• 🔄 SimpleClaims Importer — /f admin import simpleclaims [path] converts claim data to HyperFactions territory
• 🔄 FactionsX Importer — /f admin import factionsx [path] converts factions, claims, and player data

🗺️ World Map & Territory

• 🌊 BetterMap compatibility — per-world WorldMap enable/disable, claims and zones render correctly
• 📏 Per-world max claims — limit how many claims a faction can hold in each world via worlds.json
• 🎨 Configurable announcement colors — 7 per-event color settings with Admin GUI color pickers
• 🌿 Wilderness notifications — configurable text and visibility per exit context

⚡ API Expansion

• 📡 Comprehensive event system — 20 post-events and 11 cancellable pre-events covering all major faction operations
• 🔗 HyperEssentials integration — faction home APIs, ESSENTIALS_BACK zone flag, teleport events
• 🌐 Language/i18n, chat color, manager accessor, and extended query APIs
• ⚙️ Config persistence API: ConfigManager.saveConfig() and reloadConfig()
• 🗺️ World settings API — register, get, remove world settings programmatically
• 🏰 Zone & power query methods, hardcore mode API

✨ Improvements

• 🛡️ Specific protection denial messages — exact action descriptions with territory context instead of generic "no permission"
• 🔇 Centralized denial message debounce prevents chat spam
• ⚡ Eliminated double protection checks in harvest/pickup and block use systems
• 📝 Consistent "You can't ..." phrasing across all denial messages

🔧 Changes

• 💪 Hardcore power storage consolidated into per-faction data files (with auto-migration)
• 🗺️ World map config consolidated into worldmap.json
• 📂 MessageKeys split into 6 focused domain files (from 2,789-line monolith)
• 🌿 Progressive claim decay replaces all-at-once removal for inactivity
• 🏷️ Zone flag categories consolidated (Entity Interaction merged into Interaction)

🐛 Bug Fixes

• 🔧 Faction claims in water/ocean nearly invisible on world map — overlay now renders after fluid color
• 🔧 Water/lava disappearing in own faction claims — fluid spread no longer tied to fire spread config
• 🔧 World map player visibility — admin bypass now requires both permission AND toggle
• 🔧 Zero power on faction creation — race condition during server startup fixed
• 🔧 Gravestone enemy loot in own territory — config option now properly enforced
• 🔧 Backup file walk and cleanup race conditions fixed
• 🔧 Mob spawn after restart — zone loading completes before spawn suppression
• 🔧 SpawnSuppressionManager hostile group name corrected to "aggressive"
• 🔧 Door parent check, mount use flag, light use flag, and admin bypass fixes

📖 Full Changelog: GitHub