HyperProtect-Mixin

🛡️ HyperProtect-Mixin v1.0.0

Server-level event interception for Hytale — 20 protection hooks via a lock-free bridge API that any mod can consume, no compile-time dependency required.

🛰️ Server Version: 2026.02.19-1a311a592

⚡ Lock-Free Bridge

• 🔗 AtomicReferenceArray — 24-element array stored in System.getProperties() for zero-contention cross-classloader hook communication
• ⚙️ MethodHandle caching — Eagerly-resolved handles with volatile identity-checked caching for minimal overhead
• 📡 No compile-time dependency — Consumer mods register hooks via reflection-only contracts

🔒 20 Protection Hooks

• 🏗️ Building (7 hooks) — Block break, explosions, fire spread, builder tools paste, block placement, hammer cycling, block use and interactions
• 🎒 Items (3 hooks) — Proximity pickup, keep-inventory-on-death, durability loss prevention
• 📦 Containers (2 hooks) — Crafting bench access, storage container opening
• ⚔️ Combat (1 hook) — Player-initiated damage (PvP and PvE)
• 🐾 Entities (2 hooks) — Mob/NPC spawn control, respawn location override
• 🚀 Transport (3 hooks) — Teleporters, portals (6 interaction types), seating
• 💬 Commands (2 hooks) — Command execution filtering, desync log suppression

✨ Key Features

• 🔧 22 mixin interceptors — Consolidated interaction gates covering 24 interaction types via runtime class dispatch
• 🛡️ Fail-open safety — Errors, missing hooks, or negative verdicts always allow actions — never locks players out
• 🤝 OrbisGuard-Mixins compatibility — Auto-detects OG, disables 17 conflicting mixins, keeps 5 unique
• 📋 System property detection — Per-interceptor hyperprotect.intercept.* properties for consumer mod feature detection
• 🐣 Spawn startup protection — Configurable spawn blocking during server initialization via flag slots
• 🎨 Built-in message formatting — &-code colors, hex colors (&#RRGGBB), named colors, bold, italic, monospace
• 📊 FaultReporter — Sampled error logging (first + every 100th) to prevent log flooding

🔌 Verdict Protocol

• ✅ 0 — ALLOW — Action proceeds normally
• 🚫 1 — DENY_WITH_MESSAGE — Blocked with formatted deny reason
• 🔇 2 — DENY_SILENT — Blocked, no message
• 🔀 3 — DENY_MOD_HANDLES — Blocked, consumer mod handles messaging

🔀 OrbisGuard Comparison

• 📊 Hook Count — 20 hooks (22 interceptors) vs OG's 11 hooks
• ⚡ Bridge Type — AtomicReferenceArray (lock-free) vs ConcurrentHashMap
• 🛡️ Safety Model — Fail-open (errors = allow)
• 🎨 Message Formatting — Built-in &-code + hex colors
• 🤝 OG Coexistence — Auto-detects OG, disables conflicting mixins

📖 Full Documentation: GitHub Docs • Hook Reference • OG Migration Guide