OrbisGuard

Region protection for Hytale. Define areas, set rules, control who can do what.

Think WorldGuard but for Hytale.

Features

Mob Spawning Control - Block natural mob and NPC spawns in regions
Block Protection - Prevent breaking, placing, and hammer cycling
Container Locks - Protect chests, barrels, and storage
PvP Zones - Enable or disable player combat per region
Entry Control - Restrict who can enter or leave areas
Custom Messages - Welcome titles and farewell messages
Minimap Integration - Regions render on the world map with labels
Polygonal Regions - Create non-rectangular areas
LuckPerms Groups - Add entire groups as members (g:vip)
Public API - Other plugins can query and modify regions

Quick Start

/rg wand                     - Enable selection mode
Left-click: set pos1         - Break a block to mark corner 1
Right-click: set pos2        - Place a block to mark corner 2
/rg define myregion          - Create the region
/rg flag myregion build deny - Block building
/rg addmember myregion Steve - Add a member who can build

Extended Protection (Hyxin)

Some Hytale mechanics aren't exposed through the plugin API. Without Hyxin, players can bypass protection using:

Exploit	What happens
Auto-pickup	Items fly into inventory automatically
F-key harvesting	Pressing F to harvest crops/ores
Hammer cycling	Changing block variants with hammer
Fluid placement	Placing water/lava with buckets
Explosions	TNT/bombs destroying protected blocks
Command bypass	Using /home to escape regions

OrbisGuard is the only protection plugin that blocks ALL of these.

Setup with Hyxin:

Hytale/
├── earlyplugins/
│   ├── Hyxin-x.x.x.jar             <- Mixin loader
│   └── OrbisGuard-Mixins-0.3.0.jar <- Extended protection
└── mods/
    └── OrbisGuard-0.3.0.jar        <- Main plugin

All Commands

Command	Description
`/rg wand`	Toggle selection wand mode
`/rg selmode cuboid\|poly`	Switch between cuboid and polygon selection
`/rg define <name>`	Create region from selection
`/rg definepoly <name>`	Create polygonal region
`/rg remove <name>`	Delete a region
`/rg flag <region> <flag> <value>`	Set a flag
`/rg addmember <region> <player>`	Add member
`/rg addowner <region> <player>`	Add owner
`/rg info [region]`	Show region details
`/rg list`	List all regions
`/rg bypass`	Toggle admin bypass

See all 20+ commands in the full docs →

Flags

Protection

Flag	Default	Description
`build`	deny	Master toggle for all block changes
`block-break`	deny	Breaking blocks
`block-place`	deny	Placing blocks
`hammer`	deny	Hammer cycling (requires Hyxin)
`explosions`	deny	TNT/bomb damage (requires Hyxin)
`chest-access`	deny	Opening containers

Combat & Movement

Flag	Default	Description
`pvp`	allow	Player vs player combat
`damage`	allow	All damage (master toggle)
`fall-damage`	allow	Fall damage only
`entry`	allow	Entering the region
`exit`	allow	Leaving the region

Items & Interaction

Flag	Default	Description
`use`	allow	Doors, buttons, levers
`item-pickup`	allow	F-key item pickup
`item-pickup-auto`	allow	Auto-pickup (requires Hyxin)
`item-drop`	allow	Dropping items
`crafting`	allow	Using crafting stations

Messages & Minimap

Flag	Description
`greet-title`	Title shown when entering
`farewell-title`	Title shown when leaving
`deny-message`	Custom message when action is blocked
`blocked-cmds`	Commands to block (requires Hyxin)
`allowed-cmds`	Only these commands work (requires Hyxin)
`minimap-color`	Region color on world map (hex)
`minimap-label`	Text label on minimap

Plugin Integrations

LuckPerms - Add permission groups as members: /rg addmember spawn g:vip
SimpleClaims - Party claims render on world map alongside regions
EasyClaims - Player claims render on world map

Patched versions of SimpleClaims and EasyClaims are available on our Discord. These prevent players from claiming chunks that overlap with protected regions.

For Developers

OrbisGuard has a public API for querying and modifying regions:

OrbisGuardAPI api = OrbisGuardAPI.getInstance();
IRegionManager manager = api.getRegionContainer().getRegionManager("world");

// Query regions at a location
Set<IRegion> regions = manager.getRegionsAt(100, 64, 200);

// Create a region
manager.createRegion("shop", BlockVector3.at(0, 0, 0), BlockVector3.at(100, 256, 100));

// Listen for events
api.getEventBus().register(RegionCreatedEvent.class, event -> {
    System.out.println("Region created: " + event.getRegion().getId());
});

Full API documentation →

Support

Questions or issues? Join the Discord server or contact w1fl0w.

OrbisGuard | Region Management