Background Music

You can add, edit and remove background music (BGM) resources using the audio manager accessible via Naninovel -> Resources -> Audio or just store the audio clips at Resources/Audio folder.

Managing BGM

You can use any audio formats supported by Unity.

Background music playback behavior can be configured using Naninovel -> Configuration -> Audio context menu; for available options see configuration guide.

Use @bgm action followed by the clip name to control the music playback in novel scripts:

; Fades-in a music track with the name `Sanctuary` over default fade duration and plays it in a loop
@bgm Sanctuary

; Same as above, but fade-in duration is 10 seconds and plays only once
@bgm Sanctuary time:10 loop:false

; Changes volume of all the played music tracks to 50% over 2.5 seconds and makes them play in a loop
@bgm volume:0.5 loop:true time:2.5

Music tracks are looped by default. When music track name is not specified in @bgm action, all the currently played tracks will be affected. When invoked for a track that is already playing, the playback won't be affected (track won't start playing from the start), but the specified parameters (volume and whether the track is looped) will be applied.