EasySafeZone

EasySafeZone

EasySafeZone provides straightforward region protection for your server. It allows you to define 3D areas where you can strictly control player behavior, making it perfect for Spawns, Hubs, giving players their own plots, or custom Arenas.

It is designed to work out of the box with Hytale's native tools—just select your area, create the zone, and set your flags.

Core Features

• Native Workflow Uses the built-in Selection Tool for selection.
• Granular Control Toggle PVP, building, breaking, or block interactions individually per zone.
• Visual Debugging Render zone borders in-game to verify your boundaries.
• Hot Updates Resize or flag zones instantly without restarts.
• Edit existing zones: Easily load a saved Zone into the Selection Tool using a single command.
• Management UI Open a full in-game panel with /sz to manage all your zones visually—toggle flags, edit messages, and more without memorizing commands.
• Custom Player Messages Set per-zone, per-flag messages that players see when an action is blocked. Supports color formatting with ${RED}, ${#FF5555}, etc.
• Player Feedback Players are notified when an action is blocked (with a smart cooldown to prevent spam).

---

📚 How to Use

All commands function with the prefix /safezone or the alias /sz.

1. Management UI

The easiest way to manage your zones is through the in-game UI. Just run:

/sz

This opens a panel where you can:

• Browse all zones in the current world (with search).
• Toggle protection flags with checkboxes.
• Edit custom messages per flag.
• Show bounds, update bounds, or delete zones—all from one screen.

2. Creating a Zone

The plugin uses your current Selection Tool's selection to define boundaries.

1. Equip the Selection Tool (from Creative Menu).
2. Select your volume.
3. Run the command:

/sz create [zone_name]

Example:

/sz create Spawn

3. Managing Protection Flags

By default, creating a zone locks most things down. You can customize what is allowed inside using flags.

Command:

/sz flag [zone_name] [flag] [true/false]

Available Flags:

• PVP: Allow or block player damage.
• BLOCK_BREAK: Allow or block destroying blocks.
• BLOCK_PLACE: Allow or block placing new blocks.
• BLOCK_USE: Allow or block interactions (Chests, Doors, Lamps, etc.).

Examples:

Create a PVP Arena but stop griefing:

`/sz flag Arena PVP true`

4. Custom Player Messages

Customize what players see when an action is blocked. Each flag can have its own message per zone, with color support.

Set a custom message:

/sz message set [zone_name] [flag] [message]

Example:

/sz message set Spawn PVP ${RED}No fighting in the hub!

Reset to default:

/sz message reset [zone_name] [flag]

View current message:

/sz message [zone_name] [flag]

Color Presets: RED, GREEN, BLUE, WHITE, YELLOW, GOLD, ORANGE, PURPLE, PINK, CYAN, GRAY, DARK_RED, DARK_GREEN, DARK_BLUE, DARK_GRAY, LIGHT_BLUE, AQUA, BLACK, or any hex code like ${#FF5555}.

Examples:

Set a custom message with colors for block placing.

/sz message set Spawn BLOCK_PLACE "${RED}No building in the ${BLUE}spawn ${RED}area!"

Note: When using the command form you need to use "" to wrap the message, otherwise command will fail. This is not necesary when using the UI input field.

5. Visualizing Zones

You don't need to guess where a zone starts or ends. You can render the boundaries physically in the world. Show specific zone:

/sz show [zone_name] Find closest zone:

/sz show (without arguments) will highlight the nearest zone within 100 blocks.

Color Guide:

• 🟩 Green Box: Safe Zone (PVP is Disabled)
• 🟥 Red Box: Danger Zone (PVP is Enabled)

6. Editing & Resizing Zones

If you built something new and need to expand a zone coverage:

1. Load the zone: This puts the zone's current boundaries into your selection tool.

/sz edit [zone_name]

1. Adjust your selection: Use your wand or builder tools to resize the area.

2. Save changes:

/sz update [zone_name]

Note: This only updates the boundaries. Your flags and custom messages remain saved.

7. Listing & Deleting

See all zones:

/sz list

Remove a zone:

/sz delete [zone_name]

---

🔐 Permissions

You will need the following permissions to manage or bypass zones.

Admin Management

• easy-safezone.admin - Required to use any /sz commands.

Bypass Permissions Give these to staff to let them work inside protected zones without restrictions.

• easy-safezone.bypass.all - Ignores all restrictions.
• easy-safezone.bypass.pvp - Can attack in safe zones.
• easy-safezone.bypass.break - Can break blocks in protected zones.
• easy-safezone.bypass.place - Can place blocks in protected zones.
• easy-safezone.bypass.use - Can interact with objects in protected zones.