Music & Beatmaps

Reverie supports NBS (Note Block Studio) files for background music during contests and as the backing track for rhythm minigames.

NBS Files

NBS is the standard format for Minecraft note block music. Place .nbs files in:

config/reverie/music/

These files are available for:

Phase background music
Rhythm minigame note patterns
Victory fanfares
Category-specific themes

Per-Phase Music

Each hall can assign different NBS tracks to different contest phases:

File: config/reverie/halls/<hall_id>/hall.conf

music {
  enabled = true
  volume = 0.6
  fade-in-duration = 1000
  fade-out-duration = 1000

  backing-track {
    enabled = true
    nbs-file = "contest_backing.nbs"
    loop = true
    pause-for-minigames = true
    volume = 0.6
  }

  phase-music {
    intro = "contest_intro.nbs"
    presentation = "contest_presentation.nbs"
    performance = "contest_performance.nbs"
    judging = "contest_judging.nbs"
  }

  category-themes = {}
}

Backing Track

The backing track plays continuously during the contest:

Field	Default	Description
`nbs-file`	`"contest_backing.nbs"`	File name in the music directory
`loop`	`true`	Whether to loop the track
`pause-for-minigames`	`true`	Pause backing track during minigames

Category Themes

Optionally assign themes per category:

category-themes {
  cool = "cool_theme.nbs"
  beauty = "beauty_theme.nbs"
  cute = "cute_theme.nbs"
  clever = "clever_theme.nbs"
  tough = "tough_theme.nbs"
}

Beatmaps

Beatmaps are note-timing patterns derived from NBS files, used by the rhythm minigame. They define when notes appear for players to hit.

Managing Beatmaps

/beatmap                              # Open beatmap browser GUI
/beatmap list                         # List all saved beatmaps
/beatmap create <nbs_file>            # Create beatmap from NBS file
/beatmap generate <nbs_file>          # Auto-generate with difficulty analysis
/beatmap generate <nbs_file> HARD     # Generate with specific difficulty
/beatmap test <name>                  # Play-test a beatmap
/beatmap delete <name>                # Delete a beatmap
/beatmap reload                       # Reload all beatmaps

Difficulty Levels

When generating beatmaps, difficulty determines note density and timing strictness:

Difficulty	Note Density	Timing Window
EASY	Low — only major beats	Wide
NORMAL	Medium — beats and melodies	Standard
HARD	High — all notes	Tight

Sound System

Beyond NBS music, Reverie has a configurable sound system for contest events. All sounds use standard Minecraft sound IDs.

Sound Categories

Category	Examples
Phase transitions	Intro start, performance begin, judging start
Countdown	3… 2… 1… GO!
Contest events	Appeal success, combo chain, crowd reactions
Minigame feedback	Perfect hit, good hit, miss
UI	Button click, menu open, confirm, error
Ambient	Crowd murmur, anticipation

Category Sound Character

Each contest category has its own audio character:

Category	Sound Style
Cool	Guitar, power chords, aggressive
Beauty	Harp, chimes, ethereal
Cute	Xylophones, bells, playful
Clever	Calculated tones, techy
Tough	Drums, deep bass, power

Next Steps

Minigames — How beatmaps drive the rhythm challenge
Hall Configuration — Music settings per-hall