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:

wand-item: BLAZE_ROD
check-radius: 5.0
knockback-multiplier: 1.5
block-teleport: true