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 command followed by the clip name to control the music playback in naninovel 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 command, 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.

It's possible to play an intro followed by a loop with intro parameter, eg:

; Playes `BattleThemeIntro` once and then immediately `BattleThemeMain` in a loop.
@bgm BattleThemeMain intro:BattleThemeIntro

To stop a playing music track, use @stopBgm command followed by clip name. When clip name is not specified, the command will stop all the currently played tracks.

; Fades-out the `Promenade` music track over 10 seconds and stops the playback
@stopBgm Promenade time:10

; Stops all the currently played music tracks
@stopBgm