> For the complete documentation index, see [llms.txt](https://help.craftsmanplus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.craftsmanplus.com/play/settings/background-music.md).

# Background Music

Background Music lets you add a single audio track that plays across your entire playable. The track is continuous, surviving scene transitions, and runs as a project-wide layer rather than something attached to any individual scene.

Use it for ambient loops, soundtrack beds, or any audio you want present throughout the experience.

### Enabling Background Music

Background Music is configured from the **Settings Panel**, accessible by clicking the gear icon in the top-right corner of the editor.

In the Settings Panel, find the **Background Music** module. Toggle it ON to enable the feature. With the module enabled, click anywhere on the module to open the **Background Music** popup, where you'll select your audio file and configure playback.

The module itself displays the current state: when no audio is selected, you'll see a placeholder; once an audio file is assigned, the module updates to show the selected file.

### Selecting an Audio File

Inside the Background Music popup, the **Audio Selector** is where you choose your track.

Click **Select Audio…** to open the Asset Library, filtered to audio files. Pick the file you want and confirm.

Hover the thumbnail to reveal a playback button. Click it to preview the track directly in the editor without leaving the popup.

To remove the selected file, click the trash icon. The selector returns to its empty state and you can pick a different audio file.

### Volume

Once an audio file is selected, the **Volume** input and slider appear.

Volume ranges from **0** to **200**, with **100** as the default (the track's original volume). Values below 100 lower the volume; values above 100 boost it. Use the slider or type a value directly into the input field. The change applies during playback.

### Exclude Scenes

The **Exclude Scenes** dropdown lets you choose specific scenes where Background Music should *not* play. Useful when you want the soundtrack present during gameplay but silent on, for example, your end card.

Click the dropdown to open the menu. Every scene in your project is listed with a checkbox. Check the scenes you want to exclude — Background Music will pause on those scenes and resume on any scene not excluded.

### Playback Behavior

In most instances, background music starts playing as soon as the playable begins and continues across scene transitions. It does not restart between scenes, so loops and long tracks play through naturally.

On excluded scenes, the track pauses. When the user reaches a non-excluded scene again, playback resumes from where it left off.

{% hint style="info" %}
In some cases, environments do not allow auto playing audio until a single tap occurs anywhere on the screen. For more info, visit your provider's documentation.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.craftsmanplus.com/play/settings/background-music.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.