Configuration & ready presets
Understand nusa-global.yml and nusa-world.yml, and copy ready-to-use YAML profiles for SMP, Hub, and PvP servers.
NusaSpigot keeps all of its settings separate from paper-global.yml and spigot.yml so updates stay clean and easy to read.
Where configuration files live
| File | Scope | How it works |
|---|---|---|
nusa-global.yml | Entire server | Main configuration file in your server root folder. Any key omitted from the file automatically uses its built-in default. |
nusa-world.yml | Per-world overrides | Lets you override feature-flags for specific worlds (for example, turning off a module in one minigame world). |
nusa-license.properties | License key | Stores your private license key. See NusaCore & license. |
nusacore.properties | Loader options | Minecraft version choice, auto-update and other NusaCore options. |
nusa-cloud-bridge.properties | Cloud Panel | Created automatically when you link your server with /nusa link <token>. |
Every change to
nusa-global.ymlornusa-world.ymlrequires a full server restart (stop, then start again).
Per-world override structure (nusa-world.yml)
By default, nusa-world.yml inherits everything from nusa-global.yml:
defaults:
feature-flags: {}
worlds: {}Ready-to-copy profiles for nusa-global.yml
Only copy the sections you want to customize into nusa-global.yml, then restart your server.
1. Busy Survival SMP + Cross-Play (Java & Bedrock)
Balances vanilla farm compatibility, smooth Geyser/Floodgate play, and strong protection against entity/item lag spikes:
tuning-preset: DEFAULT
hopper-tick-spreading:
groups: 4
full-container-backoff-ticks: 8
entity-behavior:
ticking-mode: OPTIMIZED
skip-idle-goal-ticks: true
brain-distance-scaling:
enabled: true
near-radius: 12.0
max-interval: 20
sensor-cadence:
water-check-interval: 4
equipment-sync-interval: 4
line-of-sight-interval: 6
dolphin-treasure-seek: false
tick-budgets:
item-merge-scans-per-tick: 150
vehicle-collision-stack-limit: 10
bedrock-optimization:
enabled: true
moved-wrongly-multiplier: 2.5
max-chunks-per-tick: 2.02. High-Capacity Lobby / Auth Hub
Maximizes player count in static lobbies by pausing survival world ticking and batching distant visual updates:
tuning-preset: HUB
hub-networking:
near-distance: 8.0
far-interval: 6
waypoint-far-interval: 4
tab-window-millis: 250
world-mechanics:
advancement-criterion-triggers: false
visual-effects:
fall-impact-particles: false
water-splash-particles: false3. Competitive PvP / Practice / BoxPvP
Enables crisp 1-tick combat tracking, grouped death drops, Mace one-shot protection, and optional 1.8 combat mechanics:
combat-priority-override:
enabled: true
window-ticks: 100
world-mechanics:
compact-death-drops: true
advancement-criterion-triggers: false
pvp-mechanics:
allow-sprint-criticals: true
fishing-hook-knockback: true
ignore-netherite-kb-resistance: true
mace:
fall-distance-cap: 30.0Need details on a specific key or allowed range? Check the All settings reference.