ai.interactive.fiction/public/music/README.md

Music

Story music paths resolve relative to this directory.

Block music markup:

#music[track-name.ogg](crossfade, loop, lead=4)

Supported modes:

• queue: start the new track after the current track ends.
• crossfade: fade from the current track into the new track.
• cut: stop the current track and start the new track immediately.

Supported playback flags:

• loop: repeat the track.
• once: play the track one time.
• lead=<seconds>: for block music, let the music play alone for this many seconds before the next text/TTS paragraph starts.

Music volume is controlled by master volume and music volume in the options menu. While TTS is playing, music is ducked to 70% of its configured volume and restored when TTS playback is idle.

Browsers require a user interaction before audio can play, so music should begin after new game or load, not during passive page load.

Document third-party source and license information here or next to the file.