> For the complete documentation index, see [llms.txt](https://frinn.gitbook.io/custom-machinery-1.18/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://frinn.gitbook.io/custom-machinery-1.18/creating-custom-machines/machine-appearance/sound-ambient.md).

# Sound (Ambient)

Customize the sound the machine makes when running/idling/erroring.

You can define a sound that will play when the machine is in a specific status (corresponding of where you put the property in the appearance json).

The sound must be a OGG file and must be loaded in-game. Sounds are different than models and textures and must be registered to be usable so for using custom sounds you will have either to use a mod that let you add sounds to the game or replace an existing sound with a resource pack and use it's name in the property.

The property must be defined as such :

```json5
{
    "appearance": {
        "ambient_sound": "namespace:sound_location"
    }
}
```

{% hint style="info" %}
If no sound property is set the machine will just make no sound.
{% endhint %}
