Add background music and edit moods

Before you start

The Music panel must support your game’s engine. Save a checkpoint before adding music files.

Steps

1. Open Assets > Music.
2. If the project has no music, choose Add music.
3. Read the result. This adds the mood engine, a first mood and the required libraries when it can do so safely.
4. Open src/music.ts and follow its integration instructions. The panel describes calling startMusic() after llvls.ready(), then playMood('calm').
5. Include the file’s pause and mute handling in your integration.
6. In Music, choose Play to hear a mood or Edit to change it.
7. Use Start from, then adjust key, mode, tempo, chords and layers. Changes go into the displayed file as you make them.
8. Use New mood to add another named mood and connect it to the relevant gameplay state.
9. Run the actual game, check transitions, pause and mute, then save.

What happens next

The game generates music while it runs rather than loading a recorded music file. The designer preview helps audition a mood, but the game must call the music functions to use it.

If Add music changes nothing

Read the message about existing files, an unreadable manifest or an unsupported engine. Do not overwrite custom music files blindly. If the panel says your engine file differs, test in the game because its sound may differ from the designer preview.

Still stuck?

Email support@4rc4d3.com with the project or game name, if relevant, the action you tried and the exact error. Never include passwords, authenticator codes, backup codes or AI keys.