HyperFactions

⚔️ HyperFactions v0.9.0

The biggest update yet — HyperProtect-Mixin integration with 20 protection hooks, granular friendly fire, OrbisGuard compatibility, terrain map modes, create faction redesign, configurable death power loss, JitPack publishing, and 8 bug fixes.

🛰️ Server Version: 2026.02.19-1a311a592

Closes: #10, #13, #14, #46, #50, #51, #52, #53, #55, #56, #57

🛡️ HyperProtect-Mixin Integration

• 🔌 20 protection hooks — Our new recommended mixin system, designed specifically for HyperFactions. Includes explosion damage, fire spread, block placement, builder tools, transport control, keep inventory, durability protection, and more
• 📥 Auto-download & auto-update — Enable autoDownload in config or install from in-game with /f admin update mixin
• 🔄 Dual-provider mode — Runs alongside OrbisGuard-Mixins when needed — HyperFactions auto-detects and routes hooks to the right provider
• 🚪 7 new zone flags — explosion_damage, fire_spread, block_place, hammer_use, builder_tools_use, teleporter_use, portal_use
• 🚀 New "Transport" category — Groups teleporter and portal flags with unified faction permission

⚔️ Granular Friendly Fire

• 🎯 3-level combat hierarchy — pvp_enabled → friendly_fire → friendly_fire_faction / friendly_fire_ally
• ⚙️ Per-zone control — Allow allies to fight in WarZones but not in SafeZones, or let same-faction members duel while protecting allies
• 🔗 Backward compatible — Existing zones work unchanged — children default to true when friendly_fire is ON

🗺️ OrbisGuard Compatibility

• 🚫 Claim blocking — Factions cannot claim chunks overlapping OrbisGuard-protected regions
• 🌍 World map rendering — OG regions shown as colored overlays with priority-based stacking and border detection
• 🗺️ Territory GUI rendering — Protected chunks shown as dark orange cells with click suppression
• 🔗 Hook chaining — All 11 OG-Mixins hooks chain with existing OG hooks instead of overwriting

💀 Configurable Death Power Loss

• 🐾 Mob death toggle — powerLossOnMobDeath in config (default: true)
• 🌋 Environmental death toggle — powerLossOnEnvironmentalDeath in config (default: true)
• ⚔️ PvP deaths always incur power loss — zone flag power_loss=false overrides all

✨ New Player & Admin Experience

• 🏗️ Create faction redesign — Single-page form with name, tag, color picker, description, recruitment, and territory permissions with live preview
• 🗺️ Terrain map mode — Admin zone maps and new player maps now show terrain imagery behind claim overlays
• 🛡️ OG rendering on all maps — Protected regions visible on admin, new player, and faction territory maps
• 📋 Block Interact as parent flag — Moved into Interaction category with Door, Container, etc. as children

📦 Developer & Integration Updates

• 📦 JitPack publishing — com.github.HyperSystemsDev:HyperFactions:v0.9.0 via Maven/Gradle with no auth required
• 🪦 GravestonePlugin v2 integration — Now fully functional with faction-aware protection, per-zone access control, and death announcements
• 📝 Hytale Logger migration — All logging now uses HytaleLogger (Google Flogger) for proper server log routing
• 🔧 Maven build — Server API resolved from maven.hytale.com instead of local JARs

🔧 Changes

• 🔄 Settings UI redesign — Permission grid rotated — permissions as rows, roles as columns. Fixes truncation and makes adding flags trivial
• 📊 Faction permissions — Reduced from 49 to 45 flags by merging teleporter/portal into unified transport permission
• 📜 Members list — Now uses TopScrolling layout with scrollbar for overflow
• 🛡️ Admin zone settings — Updated for 31 total flags (was 24) with mixin provider indicator

🐛 Bug Fixes

• 🔧 Permission toggle children — Toggling a parent ON now immediately enables children without requiring page reopen
• 🔧 OG region claim blocking — Fixed 16-block vs 32-block chunk size mismatch in protection checks
• 🔧 New player map terrain crash — Fixed selector targeting element only present in flat template

⚠️ Migration: Switch to HyperProtect-Mixin

We recommend switching from OrbisGuard-Mixins to HyperProtect-Mixin — it provides 20 hooks (vs 11) designed specifically for HyperFactions.

1. Download Hyxin + HyperProtect-Mixin from CurseForge
2. Place in earlyplugins/ (NOT mods/)
3. Remove OrbisGuard-Mixins (optional but recommended)
4. Restart the server

Or use /f admin update mixin to install from in-game.

⚠️ OrbisGuard Note: We recommend not running OrbisGuard alongside HyperFactions — both implement protection systems that can conflict. If you need OG for non-faction worlds, keep both OG + OG-Mixins installed for dual-provider mode.

📖 Full Changelog: GitHub