HyperFactions

⚔️ HyperFactions v0.11.0

Territory upkeep, mob clearing zones, Sentry error tracking, world map hiding, mount enforcement, and 20+ bug fixes. The biggest release yet.

🛰️ Server Version: 2026.02.19-1a311a592

⚠️ Important: Auto-update will not work for this release due to the GitHub organization rename. Please download and install both HyperFactions and HyperProtect-Mixin manually.

💡 Upkeep Onboarding: This release introduces territory maintenance costs. Use /f admin economy → "Bulk Add/Remove" to give all factions starting money, and fine-tune costs in config/economy.json → upkeep section.

💰 Faction Upkeep System

• 🏗️ Automated Territory Costs — flat or progressive tiered pricing (e.g., first 10 chunks at $2, next 15 at $3, rest at $5)
• 🎁 Free Chunks — configurable number of chunks exempt from upkeep (default: 3)
• ⏰ Grace Periods — configurable grace window before claim forfeiture (default: 48h), with progressive edge-first decay
• 🔔 Upkeep Warnings — notifications before collection, auto-pay toggle per faction
• 📊 Treasury Upkeep Section — cost breakdown, progress bar (green/yellow/red), cost projections (7d/14d/30d), runway calculator
• ⚙️ Admin Tools — /f admin economy upkeep manual trigger, "Trigger Upkeep" button in admin GUI, "Bulk Add/Remove" for all faction treasuries

🐾 Mob Clearing Zone Flags

• 🧹 4 New Flags — mob_clear, hostile_mob_clear, passive_mob_clear, neutral_mob_clear
• 🔄 Periodic Sweep — removes existing mobs from zones — complements spawn suppression which only blocks new spawns
• ⚡ Conflict Enforcement — if a spawning flag is enabled, the corresponding clear flag automatically resolves to false

🔍 Sentry Error Tracking

• 📡 Automatic Reporting — errors sent to Sentry dashboard with source context — non-blocking async delivery
• ⚙️ Admin Commands — /f admin sentry (status/toggle)
• 🛡️ Global ErrorHandler — ~190 catch blocks across ~50 files now route through centralized error handling
• This can be opted out if you wish, we do ask that you keep it enabled to assist us in fixing bugs faster

🗺️ World Map Player & Marker Hiding

• 👁️ Relation-Based Visibility — hide enemy/neutral players and shared markers on the world map
• 🏷️ Zone Flag — show_on_map with 3 levels: Faction Only, Faction + Allies, All Players
• 🔌 SharedMarkerFilter — via HyperProtect-Mixin, filters user-placed markers by creator faction

💬 Specific Denial Messages

• 🎯 Action-Specific Text — "You can't open containers in enemy territory." instead of generic "You don't have permission"
• 🏰 Territory Context — messages include Ally/Enemy/Claimed territory or SafeZone/WarZone
• 🔇 Debounce System — eliminates duplicate denial messages when ECS and mixin both fire

🐴 Mount Entry Enforcement

• 🚫 Zone Blocking — mounted players blocked from entering zones with mount entry disabled
• 🔄 Safe Push-Back — 2 blocks from zone boundary with ground detection and cardinal fallbacks

🔗 More in This Release

• 🤖 KyuubiSoft Core Integration — citizen NPC zone protection with auto-detection
• 🛡️ HyperProtect-Mixin v1.2.0 — 7 new hook wrappers (mount, barter, fluid, prefab, projectile, crafting, map markers)
• 🌿 Configurable Wilderness Notifications — separate text and toggle per exit context (leaving zone vs leaving claim)
• 💾 Hardcore Power Consolidated — moved from standalone file into per-faction data files with auto-migration
• 📉 Progressive Claim Decay — inactivity removes edge claims first instead of all-at-once

🐛 Bug Fixes (20+)

• 🔧 SafeZone mount bypass — tamed horses/donkeys were classified as NPC_INTERACT instead of MOUNT
• 🔧 Light use flag — lanterns/campfires have null stateId; now falls back to blockId pattern matching
• 🔧 Spawn suppression timing — zone loading now completes before spawn suppression initializes
• 🔧 Gravestone enemy loot — enemiesCanLootInOwnTerritory was declared but never checked
• 🔧 Backup race conditions — fixed crashes from concurrent file operations during backup and orphan cleanup
• 🔧 World map visibility — admin bypass now requires both permission AND per-player toggle
• 🔧 Zero power on creation — race condition during startup that gave new players 0 power
• 🔧 Door parent check — recursive flag check now correctly inherits from BLOCK_INTERACT parent
• 🔧 Double denial messages — debounce prevents duplicates when ECS and mixin both fire
• 🔧 Hostile spawn suppression — fixed group name from "hostile" to "aggressive" matching Hytale's naming

📖 Full Changelog: GitHub