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

Place the compiled InControlMob.jar into your server plugins/ folder for Paper 1.21
Start the server once to generate the config/incontrolmob/ folder and sample JSON files
Edit the JSON files to define your rules
Use /incontrolmob reload to apply changes instantly

Default config.yml

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 In Control! Mod.
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 License file for details.

InControlMob

📖About InControlMob