Entity, mob, and hopper settings
Snapshot limits, gameplay switches, presets, and goal-selector cadence.
Separate tuning from gameplay policy
AI/tracking queues operate on snapshots; live mob behavior stays on main. Behavior switches explicitly permit or stop native mechanics. Do not disable AI or ticking on the assumption that it is a free optimization.
HUB overrides five switches in memory. An individual true value cannot override that preset restriction. Disabling the behavior master restores native behavior for this module. Read behavior effects first.
Option reference
All options below belong in nusa-global.yml and require a full restart. Missing keys use defaults. Ranges include both ends unless marked >.
| Complete key | Type / default | Range / unit | Purpose, effects, and when to change |
|---|---|---|---|
ai-precompute-queue.threads | integer0 | 0..256 threads | Zero selects min(4, max(1, JVM processors / 2)). Increase only with evidence; workers calculate detached snapshots.Applies when: feature-flags.ai-precompute-queue |
ai-precompute-queue.max-queued | integer256 | 1..65536 jobs | Optimization queue capacity. Full queues fall back to native handling; larger values can retain more memory.Applies when: feature-flags.ai-precompute-queue |
entity-tracking-culling.threads | integer0 | 0..256 threads | Zero selects min(4, max(1, JVM processors / 2)). Worker snapshots do not change live state.Applies when: feature-flags.entity-tracking-culling |
entity-tracking-culling.max-queued | integer256 | 1..65536 jobs | Visibility job capacity. Full queues use native fallback; raising it increases possible retained work.Applies when: feature-flags.entity-tracking-culling |
ai-precompute-queue.max-candidates | integer128 | 1..4096 candidates | Snapshot target-candidate cap. Changes capture/computation cost, not the allowed number of mobs.Applies when: feature-flags.ai-precompute-queue |
ai-precompute-queue.exclude-mob-types | list[] | namespaced IDs, e.g. minecraft:zombie | Listed types keep native target selection. Use for isolating a specific mob interaction; this does not stop its AI.Applies when: feature-flags.ai-precompute-queue |
entity-tracking-culling.max-ray-blocks | integer128 | 1..1024 blocks | Line-of-sight capture bound. Incomplete snapshots fall back; larger captures can cost more main-thread work.Applies when: feature-flags.entity-tracking-culling |
entity-tracking-culling.max-snapshot-boxes | integer1024 | 1..16384 boxes | Maximum captured collision boxes. Retain the default unless profiling supports a change.Applies when: feature-flags.entity-tracking-culling |
hopper-tick-spreading.groups | integer4 | 1..64 groups | Idle retry groups. One retains native frequency. Active transfers and related inventory-event ordering remain native.Applies when: feature-flags.hopper-tick-spreading |
entity-behavior.mob-tracker | booleantrue | true / false | False stops displaying mobs to clients while retaining them on the server. It does not delete mobs.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.entity-collision | booleantrue | true / false | False stops entity pushing/collision, cramming, and automatic boarding. Block/border collision, manual mounts, hits, and contact damage remain.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.mob-ai | booleantrue | true / false | False stops goals, Brain, navigation, and controls. Physics and despawning continue.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.mob-item-pickup | booleantrue | true / false | False stops native mob item seeking/pickup and automatic equipment changes. Player pickup remains.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.baby-mob-spawn-from-spawners | booleantrue | true / false | False rejects baby mobs and baby passengers from ordinary/trial spawners. Adult mobs remain allowed.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.mob-spawning | booleantrue | true / false | False stops natural/periodic runtime spawning. Worldgen, breeding, commands, plugin spawning, and spawners retain separate rules.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.chunk-ticking | booleantrue | true / false | False pauses scheduled block/fluid ticks, block events, block entities, and random ticks. Farms and automatic spawners may stop.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.weather-ticking | booleantrue | true / false | False freezes weather progression, sleep resets, lightning, rain/ice/snow effects. Explicit plugin/command changes remain allowed.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.villager-ticking | booleantrue | true / false | False freezes active/inactive/passenger villager ticks including physics, Brain, aging, and restocking. Villagers remain present.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
tuning-preset | stringDEFAULT | DEFAULT / HUB | DEFAULT follows individual switches. HUB forces collision, natural spawning, chunk ticks, weather, and villager ticks off in memory. Use only for an intended static lobby.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.ticking-mode | stringVANILLA | VANILLA / OPTIMIZED / EXTRA_OPTIMIZED | VANILLA keeps native cadence. Optimized modes delay distant goal reevaluation; EXTRA doubles the interval. Brain/movement stay on main.Applies when: feature-flags.entity-behavior-switches; HUB overrides five switches |
entity-behavior.goal-selector-throttle.enabled | booleantrue | true / false | False preserves native goal cadence in every mode. True permits throttling in optimized modes only.Applies when: behavior master enabled, optimized mode selected, eligible distant native goal |
entity-behavior.goal-selector-throttle.interval | integer4 | 1..600 tick | Distant goal reevaluation interval; EXTRA_OPTIMIZED doubles it. Running goals retain native action ticks.Applies when: behavior master enabled, optimized mode selected, eligible distant native goal |
entity-behavior.goal-selector-throttle.min-player-distance | number32 | >0..4096 blocks, finite | Distance from every living non-spectator player required for throttling. A larger value affects fewer mobs.Applies when: behavior master enabled, optimized mode selected, eligible distant native goal |
Test on staging
Check visibility, movement, targeting, pickup, collisions, villager restocking, and your inventory-plugin hopper workflows. Stale snapshots and custom goals can use native fallback. Worker counts alone do not prove a benefit.
Restore previous values and restart if mechanics change beyond your intention. Do not delete entities or worlds as an initial diagnostic step.