Configuration index | NusaSpigot Docs

Reference scope

The reference follows bundled configuration and parser source audited on October 18, 2026. Every listed key belongs in nusa-global.yml. AI service settings identifying provider/model/credential configuration are managed privately and excluded from the public build. Secret defaults remain empty.

Search for a key or select a group below. YAML basics explains how to merge partial examples. Configuration examples cover small changes you can test and reverse.

All public options

122 public bundled options. Select a key for its full reference.

Key	Default	Group
`feature-flags.async-chunk-io`	`true`	Feature flags
`feature-flags.region-file-compression`	`true`	Feature flags
`feature-flags.async-playerdata-save`	`true`	Feature flags
`feature-flags.ai-precompute-queue`	`true`	Feature flags
`feature-flags.entity-tracking-culling`	`true`	Feature flags
`feature-flags.hopper-tick-spreading`	`true`	Feature flags
`feature-flags.entity-behavior-switches`	`true`	Feature flags
`feature-flags.nbt-packet-validation`	`true`	Feature flags
`feature-flags.crash-pattern-guard`	`true`	Feature flags
`feature-flags.packet-flood-detection`	`true`	Feature flags
`feature-flags.tick-starvation-guard`	`true`	Feature flags
`feature-flags.redstone-abuse-limiter`	`true`	Feature flags
`feature-flags.miscellaneous-security`	`true`	Feature flags
`feature-flags.netty-native-transport`	`true`	Feature flags
`feature-flags.chunk-compression-batching`	`true`	Feature flags
`feature-flags.netty-tuning`	`true`	Feature flags
`feature-flags.pre-generation`	`true`	Feature flags
`feature-flags.shared-packet-encoding`	`true`	Feature flags
`feature-flags.tiered-entity-updates`	`true`	Feature flags
`feature-flags.batch-tab-list`	`true`	Feature flags
`feature-flags.pooled-broadcast-buffers`	`true`	Feature flags
`feature-flags.tuning-wizard`	`true`	Feature flags
`feature-flags.live-dashboard`	`true`	Feature flags
`feature-flags.discord-webhook`	`false`	Feature flags
`feature-flags.external-ai-advisor`	`false`	Feature flags
`async-chunk-io.threads`	`0`	Storage
`region-file-compression.level`	`3`	Storage
`async-playerdata-save.threads`	`0`	Storage
`async-playerdata-save.warn-queued-players`	`1024`	Storage
`async-playerdata-save.warn-queued-mib`	`64`	Storage
`ai-precompute-queue.threads`	`0`	Entities
`ai-precompute-queue.max-queued`	`256`	Entities
`entity-tracking-culling.threads`	`0`	Entities
`entity-tracking-culling.max-queued`	`256`	Entities
`ai-precompute-queue.max-candidates`	`128`	Entities
`ai-precompute-queue.exclude-mob-types`	`[]`	Entities
`entity-tracking-culling.max-ray-blocks`	`128`	Entities
`entity-tracking-culling.max-snapshot-boxes`	`1024`	Entities
`hopper-tick-spreading.groups`	`4`	Entities
`entity-behavior.mob-tracker`	`true`	Entities
`entity-behavior.entity-collision`	`true`	Entities
`entity-behavior.mob-ai`	`true`	Entities
`entity-behavior.mob-item-pickup`	`true`	Entities
`entity-behavior.baby-mob-spawn-from-spawners`	`true`	Entities
`entity-behavior.mob-spawning`	`true`	Entities
`entity-behavior.chunk-ticking`	`true`	Entities
`entity-behavior.weather-ticking`	`true`	Entities
`entity-behavior.villager-ticking`	`true`	Entities
`tuning-preset`	`DEFAULT`	Entities
`entity-behavior.ticking-mode`	`VANILLA`	Entities
`entity-behavior.goal-selector-throttle.enabled`	`true`	Entities
`entity-behavior.goal-selector-throttle.interval`	`4`	Entities
`entity-behavior.goal-selector-throttle.min-player-distance`	`32`	Entities
`hub-networking.shared-cache-entries`	`8192`	Network
`hub-networking.near-distance`	`8`	Network
`hub-networking.far-interval`	`4`	Network
`hub-networking.waypoint-far-interval`	`1`	Network
`hub-networking.snapshot-interval`	`4`	Network
`hub-networking.max-snapshot-players`	`1024`	Network
`hub-networking.tab-window-millis`	`200`	Network
`hub-networking.max-tab-entries`	`4096`	Network
`combat-priority-override.enabled`	`true`	Network
`combat-priority-override.window-ticks`	`80`	Network
`networking.flush-consolidation`	`true`	Network
`networking.ip-tos`	`24`	Network
`networking.tcp-fastopen`	`true`	Network
`networking.tcp-fastopen-backlog`	`256`	Network
`networking.chunk-batch-max-packets`	`32`	Network
`networking.chunk-batch-max-bytes`	`2097152`	Network
`networking.chunk-batch-delay-millis`	`1`	Network
`pre-generation.minimum-tps`	`18`	Pregen
`pre-generation.resume-tps`	`19`	Pregen
`pre-generation.max-average-mspt`	`40`	Pregen
`pre-generation.max-in-flight`	`2`	Pregen
`pre-generation.requests-per-tick`	`1`	Pregen
`pre-generation.progress-interval-ticks`	`200`	Pregen
`pre-generation.max-radius-chunks`	`256`	Pregen
`pre-generation.player-buffer-chunks`	`2`	Pregen
`security.warning-interval-ticks`	`200`	Security
`security.max-warnings-per-interval`	`32`	Security
`security.max-log-value-length`	`128`	Security
`security.nbt-packet-validation.action`	`SKIP`	Security
`security.nbt-packet-validation.max-bytes`	`2097152`	Security
`security.nbt-packet-validation.max-depth`	`512`	Security
`security.nbt-packet-validation.max-nodes`	`2097152`	Security
`security.crash-pattern-guard.action`	`SKIP`	Security
`security.crash-pattern-guard.max-payload-bytes`	`2097152`	Security
`security.crash-pattern-guard.patterns`	`[]`	Security
`security.packet-flood-detection.action`	`SKIP`	Security
`security.packet-flood-detection.rate-per-second`	`300`	Security
`security.packet-flood-detection.burst`	`600`	Security
`security.tick-starvation-guard.action`	`SKIP`	Security
`security.tick-starvation-guard.max-packets-per-tick`	`64`	Security
`security.tick-starvation-guard.max-processing-micros`	`2000`	Security
`security.redstone-abuse-limiter.max-updates-per-chunk-per-tick`	`4096`	Security
`security.redstone-abuse-limiter.max-deferred-per-chunk`	`8192`	Security
`security.redstone-abuse-limiter.max-deferred-total`	`65536`	Security
`security.redstone-abuse-limiter.warning-interval-ticks`	`200`	Security
`security.miscellaneous-security.disable-placed-block-nbt-reading`	`false`	Security
`security.miscellaneous-security.downloader-request-channels`	`["wdl:request"]`	Security
`security.miscellaneous-security.downloader-request-rate-per-second`	`2`	Security
`security.miscellaneous-security.downloader-request-burst`	`8`	Security
`security.miscellaneous-security.downloader-action`	`SKIP`	Security
`management.dashboard.update-interval-seconds`	`3`	Management
`management.dashboard.max-subscribers`	`16`	Management
`management.dashboard.json-endpoint-enabled`	`false`	Management
`management.dashboard.json-port`	`9240`	Management
`management.dashboard.json-token`	`''`	Management
`management.discord.webhook-url`	`''`	Management
`management.discord.low-tps-threshold`	`15`	Management
`management.discord.low-tps-duration-seconds`	`60`	Management
`management.discord.cooldown-seconds`	`300`	Management
`management.discord.repeated-security-threshold`	`10`	Management
`management.discord.repeated-security-window-seconds`	`60`	Management
`management.discord.queue-capacity`	`32`	Management
`management.discord.request-timeout-seconds`	`5`	Management
`management.discord.notify-fatal-exceptions`	`true`	Management
`management.discord.notify-low-tps`	`true`	Management
`management.discord.notify-module-disabled`	`true`	Management
`management.discord.notify-repeated-security`	`true`	Management
`management.ai.timeout-seconds`	`20`	Management
`management.ai.max-output-tokens`	`1024`	Management