Music

"One track. It loops. If they notice it looping, the scene was too long." — Composer Ryn Halvo

/setscore plays one music track to everybody in the server, and keeps playing it until you stop it.

While a director is active, /setscore is locked to the director by default. With nobody in the chair it falls back to your admin rank. See director mode.


What it does

The track replaces whatever music the map was playing. A player joining part way through starts hearing it as soon as they connect. Only one track plays at a time, so starting a second one replaces the first. Nothing resets the track when the map changes, so it keeps going until you stop it.


Starting a track

/setscore <path>

Running /setscore music/theme.mp3 starts the track for everyone. Nothing prints in chat, so listen rather than watch. The track loops, fading down and back up at each restart.

music/ is added for you when the path does not already start with it, so /setscore theme.mp3 and /setscore music/theme.mp3 do the same thing.

Add once to play the track a single time instead of looping:

/setscore <path> once

A path with anything other than letters, numbers, _, -, . and / in it is refused, and so is any path containing ..:


Stopping the music

The track fades out rather than cutting, so this doubles as the end-of-scene cue.


Checking what is playing

Run /setscore with no arguments for the command list and the current track:

Now playing: none means nothing is set.


Things to note

  • Starting a track prints nothing. Only none, a bad path and the bare form reply at all.
  • The path is not checked against the file system. A track nobody has plays silence for them, with no warning to you.
  • One track at a time. There is no layering, no cross-fade and no volume control from the command.
  • A scene save stores the current track, so loading that scene starts the music again.
  • /prepmap stops the music, as does loading any scene.
  • An opening crawl can start its own track. /crawl music fires when the crawl ends and always loops, whatever you set here. See transitions.

Next

  • Transitions: pair the score with a fade or an opening crawl
  • Scenes: save the set and the track together, so a load restarts both