OrbisGuard Mixins
- By
Companion module for OrbisGuard that closes all protection bypasses through server-level mixins.
OrbisGuard-Mixins
Companion mixin module for OrbisGuard - closes all known protection bypasses.
OrbisGuard-Mixins hooks into server internals that aren't exposed by Hytale's plugin API, providing complete region protection coverage. Without this module, players can bypass certain protections through game mechanics like auto-pickup, hammer cycling, and F-key harvesting.
Requirements
OrbisGuard - The main region protection plugin (0.9.0+, use the matching release)
Hyinit - Mixin bootstrapper/launcher for Hytale
Installation
1. Download OrbisGuard-Mixins-x.x.x.jar
2. Place it in your server's earlyplugins/ folder (NOT mods/)
3. Launch your server through Hyinit instead of starting HytaleServer.jar directly. Hyinit boots the server and applies everything in earlyplugins/. For example:
java -jar Hyinit-x.x.x.jar --assets="<Hytale install>/Assets.zip"
4. Start the server.
OrbisGuard will automatically detect the mixins module and display [+] Mixins loaded in the startup banner.
What It Protects
| Protection | Without Mixins | With Mixins |
|---|---|---|
| Auto item pickup (walk-over) | Bypassed | Blocked |
| F-key crop / block harvesting | Bypassed | Blocked |
| Hammer block cycling | Bypassed | Blocked |
| Explosion block damage | Bypassed | Blocked |
| Fire / flamethrower spread | Bypassed | Blocked |
| Command blocking | Limited | Full coverage |
| Mob spawning control | Limited | Full coverage |
| Mob / NPC death loot | Bypassed | Controlled |
| Portal & teleporter use | Bypassed | Blocked |
| Crafting & workbench access | Limited | Full coverage |
| Builder tools | Bypassed | Blocked |
| Keep inventory on death | Not possible | Works |
| Durability loss prevention | Not possible | Works |
| Custom respawn location | Not possible | Works |
Mixin List
| Mixin | Purpose |
|---|---|
| PlayerItemEntityPickupSystemMixin | Blocks walk-over auto item pickup |
| CycleBlockGroupInteractionMixin | Prevents hammer block cycling |
| HarvestCropInteractionMixin | Blocks scythe crop harvesting |
| BlockHarvestUtilsMixin | Blocks F-key harvesting |
| CommandManagerMixin | Full command blocking (blocked-cmds / allowed-cmds) |
| ExplosionBlockDamageMixin | Protects blocks from explosions |
| FireFluidTickerMixin | Blocks fire / flamethrower spread |
| SpawnMarkerEntityMixin | Controls marker-based mob spawning |
| WorldSpawnJobSystemsMixin | Controls natural mob spawning |
| NPCPluginSpawnMixin | Controls NPC / plugin spawns |
| NPCDeathItemDropMixin | Controls NPC death loot (mob-loot flag) |
| DeathItemDropMixin | Enables keep-inventory flag |
| ItemDurabilityMixin | Enables item-durability protection |
| RespawnLocationMixin | Custom respawn location (respawn-location flag) |
| CraftingManagerMixin | Crafting protection |
| BenchWindowMixin | Workbench chest-access filtering |
| BuilderToolsPacketHandlerMixin | Builder tools protection |
| FloodFillPositionSelectorMixin | Selection-wand flood fill protection |
| InteractionEntryMixin | Core interaction protection |
| InteractionChainMixin | Chained interaction protection |
| StoreAddEntityMixin | Entity spawn tracking |
| EnterPortalInteractionMixin | Portal entry protection |
| ReturnPortalInteractionMixin | Return portal protection |
| HubPortalInteractionMixin | Hub portal protection |
| TeleporterInteractionMixin | Teleporter protection |
| TeleportConfigInstanceInteractionMixin | Instance teleport config protection |
| TeleportInstanceInteractionMixin | Instance teleport protection |
| ExitInstanceInteractionMixin | Instance exit protection |
Flags Enabled by Mixins
These OrbisGuard flags depend on the mixins module for full enforcement:
item-pickup-auto - Block walk-over auto-pickup
hammer - Block hammer block cycling
blocked-cmds / allowed-cmds - Full command blocking
mob-spawning - Control all mob spawns
mob-loot - Control mob / NPC death loot
crafting - Crafting & workbench access
use-portals / use-teleporters - Control portal & teleporter use
keep-inventory - Keep items on death
item-durability - Prevent durability loss
respawn-location - Set a custom respawn point
Support
Issues: GitHub Issues
Discord: WiFlow's Discord
OrbisGuard-Mixins is optional but highly recommended for production servers. Without it, knowledgeable players can bypass certain protections.
The OrbisGuard Mixins Team
