Region protection for Hytale. Define areas, set rules, control who can do what.
Think WorldGuard but for Hytale.
Features
- 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 (Hyinit)
Some Hytale mechanics aren't exposed through the plugin API. Without Hyinit and OrbisGuard-Mixins, 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 Hyinit:
Hytale/
├── earlyplugins/
│ └── OrbisGuard-Mixins-0.3.0.jar <- Extended protection
└── mods/
└── OrbisGuard-0.3.0.jar <- Main plugin
Launch the server with Hyinit-X.X.X.jar next to HytaleServer.jar; keep OrbisGuard-Mixins in earlyplugins/.
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 Hyinit) |
explosions |
deny |
TNT/bomb damage (requires Hyinit) |
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 |
Workbenches, anvils, tables, generic fallback interactions |
door-access |
allow |
Doors, gates, trapdoors |
light-access |
allow |
Campfire, torch, lantern, lamp toggles |
seat |
allow |
Sitting on benches and chairs |
item-pickup |
allow |
F-key item pickup |
item-pickup-auto |
allow |
Auto-pickup (requires Hyinit) |
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 Hyinit) |
allowed-cmds |
Only these commands work (requires Hyinit) |
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.
