InControlMob

### Overview **InControlMob** is a Spigot/Paper plugin for **Minecraft 1.21** that gives server admins a powerful, rule‑driven system to control mob spawning, spawner behavior, summoned entities, loot, and experience. Rules are plain JSON files stored in `config/incontrolmob/`, hot‑reloadable, and validated on load so you can safely customize server behavior without code changes. --- ### Key Features - Rule‑driven control for spawn, spawner, summon, loot, and experience events - JSON rules with schema validation and clear error reporting - Hot reload with `/incontrolmob reload` — no server restart required - Rich conditions: entity type, world, biome, light level, spawn reason, time of day, difficulty, nearby players, NBT match, WorldGuard region checks, and more - Powerful actions: allow/deny spawn, change health, set equipment, add potion effects, replace entity type, modify drops and XP, set entity flags (noGravity, invulnerable, glowing, persistent), velocity/passenger changes - Priority and control: rule `priority`, `enabled` flag, `continueOnMatch` option, and file order semantics - Safe and performant: asynchronous rule loading, atomic swap of rule sets, caching and indexing by entityType/spawnReason, debug logging controlled by config - Optional WorldGuard integration: region checks when WorldGuard is present; graceful degradation when absent - Admin tools: list rules, test rules, and export rules for sharing --- ### Installation 1. Place the compiled `InControlMob.jar` into your server `plugins/` folder for Paper 1.21 2. Start the server once to generate the `config/incontrolmob/` folder and sample JSON files 3. Edit the JSON files to define your rules 4. Use `/incontrolmob reload` to apply changes instantly **Default config.yml** ```yaml enabled: true debug: false default-action: allow max-rule-load-time-ms: 5000 rule-cache-size: 1024 ``` --- ### Commands - `/incontrolmob reload` — reload all JSON rules and report errors - `/incontrolmob rules list` — list loaded rules with id, priority, and enabled state - `/incontrolmob rule test <ruleId> <entityType>` — simulate rule evaluation at your location - `/incontrolmob export` — export current loaded rules to a single archive **Permissions** - `incontrolmob.reload` — allow reload - `incontrolmob.manage` — manage rules and export - `incontrolmob.test` — run rule tests --- ### Examples - **Block pigs**: add `deny_pigs_global` to `spawn.json`, reload, pigs will no longer spawn - **Strong zombies**: add `strong_zombies_plains_night`, reload, zombies in Plains at night spawn with 40 HP, iron sword, and speed effect - **Spawner replacement**: add a `spawner.json` rule to replace zombies with skeletons --- ### Troubleshooting - Enable `debug: true` in `config.yml` for detailed logs - On reload, check console for schema validation errors; invalid rules are skipped and reported - If WorldGuard checks fail, confirm WorldGuard is installed and compatible - For performance, ensure `rule-cache-size` is reasonable and avoid overly broad rules --- ### Credits This plugin was inspired by the (https://modrinth.com/mod/in-control). **InControlMob** is an independent server‑side plugin built for Paper/Spigot, bringing similar rule‑based mob control features to multiplayer servers. --- ### License Released under the **Creative Study Lab License.** (MIT‑style permissive). See the **(https://github.com/mahadimdinfo-rgb/InControlMob/blob/main/LICENSE)** file for details.