HyperFactions

⚔️ HyperFactions v0.8.0 — Our Biggest Release Ever

The largest update since HyperFactions launched — 8 major features, 10 bug fixes, and a complete codebase refactor touching 85+ files. This release also lays the groundwork for upcoming modules: Raids, Wars, Faction Shops, Ecotale Integration, Faction Vaults, and Faction Levels.

Closes: #30, #31, #32, #34, #36

💰 Faction Treasury & Economy

• 🏦 Treasury page (/f treasury) — Full GUI with balance display, deposit/withdraw buttons, transfer system, transaction log, and treasury settings
• 💳 Deposit/Withdraw modals — Amount input with live preview, fee calculation, and balance validation via VaultUnlocked player wallets
• 🔄 Transfer system — Search factions by name, confirm with fee preview, complete inter-faction treasury transfers
• 📊 Admin economy page (/f admin economy) — Server economy overview with sortable/searchable faction treasury list
• ⌨️ Economy CLI — /f balance, /f deposit, /f withdraw, /f money for quick access without GUI
• ⚙️ Economy config (economy.json) — Starting balance, treasury limits, transfer fees, upkeep settings

🗺️ Terrain Map Mode

• 🌍 Terrain imagery — Territory map now renders actual terrain behind claim overlays using ChunkWorldMap data — see rivers, biomes, and elevation when claiming
• 🎨 Semi-transparent overlays — Own (green), ally (blue), enemy (red), other (gold), safe zone (teal), war zone (purple)
• 🖱️ Clickable cells — Claim/unclaim actions work in terrain mode (officers only)
• ⚙️ Config toggle — terrainMapEnabled in GUI section (default: true)

👤 Player Info & History

• 📋 Player info page (/f who [player]) — Faction membership, power stats, combat stats (kills/deaths/KDR), and membership history
• 📜 Membership tracking — Records all faction joins, leaves, kicks, and disbands with timestamps and highest role
• 🔧 Admin tools — /f admin clearhistory <player> to clear a player's history

⚡ Admin Power Management

• 🎛️ Admin power command (/f admin power) — Set, adjust, reset, per-player max override, power loss bypass, claim decay exemption
• 👤 Admin Player Info page — GUI with power controls, bypass toggles, and member actions
• 🔄 Bulk operations — Reset All / +/-1/5 All buttons on faction info page

🧭 Map & Compass Visibility

• 👁️ Faction-aware filtering — Only faction members and allies visible on world map and compass by default
• ⚙️ Per-relation config — Toggle visibility for each relation type in worldmap.json
• 🔑 Bypass permissions — hyperfactions.bypass.mapfilter and hyperfactions.bypass.mapvisibility

❓ Help Center Redesign

• 📖 Guide-first format — Complete rewrite with 7 colored categories and 22 topics organized by concept
• 🗂️ Wide sidebar layout (750x650) — Colored category sidebar with scrollable card-based content
• 🔗 Deep-linking — /f claim help opens directly to Power & Land
• 🌐 i18n foundation — All content uses message key lookups for future locale support

🤝 Relations Redesign

• 📑 Streamlined layout — Merged 3-tab layout into 2 tabs (Relations + Pending) with collapsible entries
• ⚡ Inline quick actions — View, Set Neutral, Set Enemy, Request Ally, Accept, Decline, Cancel

🔍 Admin GUI Improvements

• 👥 Admin players page (/f admin players) — Browse all server players with search, sort, power stats, and quick actions
• 🔎 Search on all list pages — Added search bars to admin factions, members, and zones pages
• 📊 Sort dropdowns — Zones (Name/Type/Chunks/World), members (Role/Online/Name/Power)
• 📄 Admin faction members overhaul — Full admin tool with search, sort, pagination (8/page), and 700x500 layout

🐛 Bug Fixes

• 🔧 Zone power loss flag ignored on death — Double coordinate conversion caused wrong chunk lookup
• 🔧 Zone flags reset on server restart — Migration code unconditionally stripped admin customizations
• 🔧 Terrain map lag on claim/unclaim — Page regeneration replaced with overlay-only update
• 🔧 Membership history gaps — Faction creation and admin kicks now properly recorded
• 🔧 Navigation fixes — Player info back button, faction info back from profile, invite tab state
• 🔧 Relations UI fixes — Set Relation view, ally request tab, pending cancel tab routing
• 🔧 Members page search position — Search bar moved above header for consistency

🏗️ Refactored

• 🧹 MessageUtil & UuidUtil — Replace ~200 hardcoded color/prefix/UUID patterns across ~85 files
• 📦 Class decomposition — HyperFactions.java (1,177→906), HyperFactionsPlugin.java (997→440), AdminSubCommand.java (2,462→306)
• 📂 Package reorganization — GUI packages (gui/<subsystem>/page/), integration packages (permissions/, protection/, placeholder/)

🔄 Changed

• 🎨 Faction info redesigned — Card-based stat layout with Power/Claims/Members cards, Treasury card, Leadership section
• 🎨 Player info redesigned — Card layout with online indicator, faction card, stat cards, power bar, scrollable history
• 🎨 Admin faction info redesigned — 700x640 container with Economy Management section
• 📊 Dashboard expansions — Economy stats on admin and faction dashboards (conditionally visible)
• 🗂️ Relations 2-tab layout — Relations combining allies+enemies, Pending combining incoming+outgoing

📖 Full Changelog: GitHub