Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for nanjyasorya_z

Dynamic mob AI optimization based on TPS and player distance

Report AITPSControl?

Release
1.3.0

nanjyasorya_z released AITPSControl version 1.3.0 on June 8, 2026

AITPSControl reduces server load by limiting mob AI when TPS drops or when mobs are far from players. Safe zones are based on Paper's entity-activation-range from spigot.yml, so throttling follows the same distance logic your server already uses.

Features

TPS-based throttling with hysteresis and delay timers, or always-on distance control Paper safe zones per category (animals, monsters, villagers, raiders, etc.) safe-zone-max — only the nearest N mobs per player stay active (good for villager farms) Configurable effects: remove-ai, remove-random-movement, remove-awareness, disable-collisions, disable-breeding Global defaults with per-category overrides Gradual AI restore when players approach, on interaction, or when throttle turns off Protect named/tamed mobs, metadata keys, and specific entity types; exclude worlds Optional action bar alerts; tuned for 30–40+ player servers

Commands

/aic reload — reload config /aic status — TPS and throttle status /aic recover-stale — restore stuck NoAI mobs

Permissions (default: op)

aitpscontrol.reload, aitpscontrol.status, aitpscontrol.recover-stale, aitpscontrol.alert

Notes

Support: Discussion tab — include Paper version, config, and /aic status when reporting issues.

Information

Published onJune 8, 2026
Downloads8

Platforms

Paper Paper (1.21-26.1.2)