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

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.