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?

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

Support

Discord: https://discord.gg/AjKBwSbVjf

Information

CategoryAdmin Tools
Published onJune 8, 2026
LicenseMIT
Downloads8
Stars0
Watchers0

Pinned Versions

Members