Configuration & ready presets

Understand nusa-global.yml and nusa-world.yml, and copy ready-to-use YAML profiles for SMP, Hub, and PvP servers.

On this page

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

FileScopeHow it works
nusa-global.ymlEntire serverMain configuration file in your server root folder. Any key omitted from the file automatically uses its built-in default.
nusa-world.ymlPer-world overridesLets you override feature-flags for specific worlds (for example, turning off a module in one minigame world).
nusa-license.propertiesLicense keyStores your private license key. See NusaCore & license.
nusacore.propertiesLoader optionsMinecraft version choice, auto-update and other NusaCore options.
nusa-cloud-bridge.propertiesCloud PanelCreated automatically when you link your server with /nusa link <token>.

Every change to nusa-global.yml or nusa-world.yml requires 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.0

2. 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: false

3. 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.0

Need details on a specific key or allowed range? Check the All settings reference.

Nusa product documentation · NusaSpigotPaper fork · Java 21 / 25

Loading the index…