Configuration

All NeroNotes settings live in one file, config/neronotes.properties, managed through Neroland Core's config framework (validated, hot-reloadable, synced).

Server-authoritative vs. client-local. Every gameplay key is server-authoritative: in multiplayer the server's values win, and clients never decide what they may play, publish or own. The only client-local keys are the four audio-comfort/privacy ones at the bottom — those are yours on your own machine and the server never overrides them.

Server-authoritative keys

The resonance signal

KeyDefault (range)Meaning
signal.emit_range_blocks64 (16–128)Range in blocks within which emitters broadcast resonance (note/transport) events.
signal.max_playing_channels_per_chunk_radius3 (1–16)Audio-spam cap: concurrently playing channels per chunk radius; further play requests are quietly refused.

Synchronised playback

KeyDefault (range)Meaning
sync.drift_threshold_ms100 (20–1000)Measured playback drift beyond which a client hard-seeks to the server anchor. Playback rate is never adjusted.
sync.max_latency_compensation_ms500 (0–2000)Clamp on the latency compensation applied when scheduling against the server timeline anchor.

The Harmonic Gate

KeyDefault (range)Meaning
gate.energy_capacity16000 (1000–1000000)Energy buffer capacity (NE) of the Harmonic Gate. Applies to gates placed after a change.
gate.teleport_energy_cost8000 (0–1000000)Energy one crossing into the Soundforge consumes. Returning is always free. Set it to 0 to make entry free too — the energy charge is the Soundforge's only requirement (NeroNotes has no progression gates).

Disks and moderation

KeyDefault (range)Meaning
disk.score_budget_bytes16384 (1024–65536)Hard cap in bytes on a serialised score, enforced at press time and on the wire. Over-budget scores are refused with both byte counts named — never truncated.
disk.name_max_length48 (8–128)Maximum length of a player-chosen disk/composition title, validated server-side at press and publish time.
moderation.blocked_words(empty)Comma-separated, case-insensitive words refused in player-chosen titles. Empty disables the list.

The shared library and the Disk Exchanger

KeyDefault (range)Meaning
library.publishing_enabledtrueWhether players may publish compositions to the shared library at all.
library.size_cap1000 (10–100000)Maximum number of published entries the library holds server-wide.
library.per_player_quota25 (1–1000)Maximum published entries a single player may hold.
library.op_approval_requiredfalseIf true, a published disk only becomes visible after an operator runs /neronotes library approve <id>.
library.page_size50 (10–100)Page size for library listings (paginated from the first release).
exchanger.enabledtrueWhether the Disk Exchanger machine is enabled.

Data protection

KeyDefault (range)Meaning
data.retention_days365 (0–3650)Days of player inactivity after which NeroNotes purges that player's stored data (authorship severed, sessions, channels). 0 disables the automatic sweep.
data.action_logging_enabledfalseWhether non-essential action logging (press/publish/download events) is enabled. Player-authored strings are never logged at info level regardless.

Companion module

KeyDefaultMeaning
link.module_enabledtrueWhether NeroNotes registers its companion (NeroLink) module. When false, companion clients see no NeroNotes data and can perform no NeroNotes actions.

Client-local keys

Exactly four kinds, and no more — audio comfort and the telemetry opt-out:

KeyDefault (range)Meaning
client.telemetry_opt_outfalseSet true to opt out of anonymous error reporting entirely. See Privacy and your data.
client.volume.deep_bass1.0 (0–1)Volume multiplier for the Deep Bass voice family.
client.volume.sub_pad1.0 (0–1)Volume multiplier for the Sub Pad voice family.
client.volume.low_drone1.0 (0–1)Volume multiplier for the Low Drone voice family.
client.volume.high_lead1.0 (0–1)Volume multiplier for the High Lead voice family.
client.volume.glassy_pluck1.0 (0–1)Volume multiplier for the Glassy Pluck voice family.
client.volume.percussion1.0 (0–1)Volume multiplier for the Percussion voice family.
client.volume.synth_texture1.0 (0–1)Volume multiplier for the Synth Texture voice family.
client.glow_intensity1.0 (0–1)Intensity of the neon edge-light flare on Resonant Blocks and Resonators.
client.mute_other_basesfalseMute playback from channels owned by other players — the shared-server comfort switch. A local audio preference only; it grants and removes no permissions.

Search across every Nero mod wiki.