OrbisGuard 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.