# Mcast - SimpleZoneAction 1.0.1

Mcast - SimpleZoneAction is a small Paper plugin for cuboid 3D zones. Entering a zone can perform one action: give an item, spawn a living entity or activate TNT.

## Zone editor

Run `/zoneaction setZone <zoneName>` and select both corners with left click. The first point has its own colour, the current cuboid is outlined with particles and the action bar keeps the controls visible. Right click or `/zoneaction cancel` stops the selection.

Selecting the borders of an existing zone preserves its assigned action. Zone names are safe file names, the selected size is limited by config and particle previews have a fixed rendering budget.

## Commands

* `/zoneaction help`
* `/zoneaction reload`
* `/zoneaction setZone <zoneName>`
* `/zoneaction listZones`
* `/zoneaction deleteZone <zoneName>`
* `/zoneaction cancel`
* `/zoneaction setZoneEvent <zoneName> GIVE <material> <amount>`
* `/zoneaction setZoneEvent <zoneName> SPAWN_MONSTER <entityType> <x> <y> <z>`
* `/zoneaction setZoneEvent <zoneName> SPAWN_MONSTER <entityType> click`
* `/zoneaction setZoneEvent <zoneName> SPAWN_TNT <x> <y> <z>`
* `/zoneaction setZoneEvent <zoneName> SPAWN_TNT click`

Aliases: `/sza`, `/simplezoneaction`.

## Permissions

* `mcast.simplezoneaction.use` — use the plugin and its visual editor.
* `mcast.simplezoneaction.admin` — reload, delete zones and observe other editors. It includes `mcast.simplezoneaction.use`.

Both permissions default to OP. Players without the use permission do not see command completions.

## Safety

Zone names, zone size, item amount, action cooldown and click-selected spawn space are validated. Click targets must be in the zone's world. Leaving the world or server clears an unfinished selection.

Data is stored in `plugins/Mcast-SimpleZoneAction/Zones/` as editable YAML files.

Requires Paper 1.21.x and Java 21.
