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 zero per-tick overhead with zero per-tick overhead. Fully event-driven with zero per-tick overhead.

---

Features

- Fully Configurable – Select two corners with a wand item to create named rectangular zones. - Fully Configurable – Blocks all hostile and neutral mob spawns inside zones, including natural, spawner, egg, and custom sources. - Fully Configurable – Prevents mobs from walking or teleporting into protected zones. - Fully Configurable – Mobs attempting to cross a zone boundary are pushed back. Strength is fully configurable. - Fully Configurable – 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

- Java: 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. Right-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