RestrictMob

# RestrictMob > Protect your world. Keep mobs out. RestrictMob is a lightweight, high-performance plugin that allows server administrators to define Safe Zones where hostile and neutral mobs cannot spawn or enter. Built for **Paper 1.21+** with **Java 21**. Fully event-driven with **zero per-tick overhead**. --- ## Features - **Zone Creation** – Select two corners with a wand item to create named rectangular zones. - **Spawn Prevention** – Blocks all hostile and neutral mob spawns inside zones, including natural, spawner, egg, and custom sources. - **Entry Prevention** – Prevents mobs from walking or teleporting into protected zones. - **Knockback** – Mobs attempting to cross a zone boundary are pushed back. Strength is fully configurable. - **Async Persistence** – Zones are saved asynchronously. No file I/O on the main server thread. - **Fully Configurable** – Wand item, check radius, knockback multiplier, teleport blocking, and messages are all customizable. --- ## Requirements - **Server:** Paper 1.21+ (or compatible forks like Purpur) - **Java:** 21 or newer --- ## Installation 1. Download or build the plugin `.jar` file. 2. Place it in your server's `plugins/` folder. 3. Restart (or reload) the server. --- ## Commands & Usage All commands require the `titanzones.admin` permission *(default: OP)*. | Command | Description | |---------|-------------| | `/zones wand` | Gives you the selection wand. | | `/zones create <name>` | Creates a zone from your selected positions. | | `/zones delete <name>` | Deletes an existing zone. | | `/zones list` | Lists all active zones. | ### How to Create a Zone 1. Run `/zones wand` to receive the selection tool. 2. **Left-click** a block to set Position 1. 3. **Right-click** a block to set Position 2. 4. Run `/zones create <name>` to finalize the zone. > Both positions must be in the same world. --- ## Configuration All settings can be adjusted in `config.yml`: ```yaml wand-item: BLAZE_ROD check-radius: 5.0 knockback-multiplier: 1.5 block-teleport: true