OrbisGuard | Region Management

[0.6.0] - 2026-01-20

Added

Third-Party Claim Hook - Faction and claiming plugins can now check if chunks overlap with OrbisGuard regions before allowing claims. Access via System.getProperties().get("orbisguard.claim.hook") - just 5 lines of code, no compile dependency required. Methods: canClaim(worldName, chunkX, chunkZ), canClaimAtBlock(worldName, blockX, blockZ), getDenialMessage().

API: canCreateClaim - New API method OrbisGuardAPI.getInstance().getRegionContainer().canCreateClaim(worldName, min, max) for checking if a claim area overlaps with any protected region.

KEEP-INVENTORY flag (requires OrbisGuard-Mixins) - When set to allow, players keep their inventory on death within the region. Default: deny (normal death behavior). Usage: /rg flag <region> keep-inventory allow

RESPAWN-LOCATION flag (requires OrbisGuard-Mixins) - Override where players respawn when they die in a region. Format: world,x,y,z or world,x,y,z,yaw,pitch. Usage: /rg flag <region> respawn-location world,100,65,200

ITEM-DURABILITY flag (requires OrbisGuard-Mixins) - When set to deny, tools and weapons don't lose durability in the region. Default: allow (normal durability loss). Usage: /rg flag <region> item-durability deny

FLY flag - Control whether players can fly in regions. When denied, flying players are knocked out of flight upon entering. Default: allow. Usage: /rg flag <region> fly deny

WALK-SPEED flag - Modify player walk speed in regions. Value is a multiplier (1.0 = normal, 2.0 = double speed, 0.5 = half speed). Range: 0.1-10.0. Usage: /rg flag <region> walk-speed 1.5

FLY-SPEED flag - Modify player fly speed in regions. Value is a multiplier. Range: 0.1-50.0. Usage: /rg flag <region> fly-speed 2.0

LocationFlag type - New flag type for location-based values. Supports format: world,x,y,z or world,x,y,z,yaw,pitch. Used by RESPAWN-LOCATION flag.

Chunk Selection Mode - New selection mode for defining regions by chunks instead of individual blocks. Use /rg selmode chunk to enable. Left-click adds chunks, right-click removes chunks. Visual chunk borders follow your Y position as you fly. Perfect for large area protection.

Movement Control System - New ECS ticking system that tracks player movement and applies speed modifiers and flight restrictions based on region flags. Saves/restores player movement state when entering/exiting regions.

Selection Visualizer Tick System - New ECS ticking system that updates chunk selection visualization Y position as players move vertically, keeping the selection border at player level.

DeathItemDropMixin (OrbisGuard-Mixins) - Intercepts DeathSystems.DropPlayerDeathItems to check keep-inventory flag and prevent item drops.

RespawnLocationMixin (OrbisGuard-Mixins) - Intercepts HomeOrSpawnPoint.respawnPlayer to override respawn position based on region flag.

ItemDurabilityMixin (OrbisGuard-Mixins) - Intercepts Player.canDecreaseItemStackDurability to prevent durability loss when flag is set.

Fixed

Major: Crop harvesting bypass - Fixed a bug where players could harvest crops in protected regions even when block-break was denied. Thanks to @urn for reporting.

Changed

Mixin hooks now use @Redirect instead of @Inject for Hyxin compatibility (Hyxin doesn't include mixin runtime classes).

Player movement state (fly ability, walk/fly speeds) is now saved when entering a region and restored when leaving.

Startup summary now shows Keep Inventory, Respawn Location, and Item Durability hook status.

Removed

UseBlockInteractionMixin - Removed as the block interaction desync fix is now handled by ChangeStateInteractionMixin.