Atmo | Ambient Sounds & Music [1.20.6+]

Atmo is a Paper plugin that plays custom ambient sounds and background music depending on where a player is standing. Zones are cuboid regions created directly in-game (menu + click selection), each linked to an ambient profile and a music track defined in simple YAML files.
Atmo can also trigger sounds based on what is around the player (such as a decorative Armor Stand or a piece of ItemsAdder furniture) or from fixed coordinates.


[Preview Video Under construction]

• ✓ Create cuboid zones in-game by selecting two corners, without any dependencies (no WorldGuard needed).
• ✓ Each zone has a priority, a linked ambient profile and/or background music, editable through `area.yml`.
• ✓ Ambient profiles (`ambient.yml`) combine a looping ambient sound with a set of random one-off sounds, each with its own probability, delay range, volume and pitch variation.
• ✓ Background music per zone.
• ✓ A default/fallback ambience and music (`config.yml → general_area`) applies to configured worlds when a player is outside any zone.
• ✓ Block-bound sounds: detect a nearby entity (e.g. an Armor Stand identified by CustomModelData) and play a sound as if it came from it.
• ✓ Optional ItemsAdder integration: bind sounds to ItemsAdder custom furniture the same way (`type: ITEMSADDER`).
• ✓ Position-bound sounds: play a sound when a player enters the radius around one or several fixed coordinates, addable in-game with `/atmo addloc`.
• ✓ Per-player controls: players can toggle background music and ambient sounds on/off, and set their own music/ambient volume (0–100%).
• ✓ Built-in menu displaying the list of zones, showing the world, positions, priority, music and ambience for each zone, as well as options for teleportation, redefinition and deletion.

• Option to disable/re-enable a sound zone/ambient/music per player.

1. [Paper] 1.20.6+
2. Java 17+
3. [ItemsAdder - optional, only needed if you want to bind sounds to ItemsAdder furniture.

1. Download the Atmo plugin JAR file.
2. Place the JAR in your server's plugins folder.
3. Restart your server; Atmo will generate `area.yml`, `ambient.yml`, `blockSound.yml` and `config.yml` in `plugins/atmo/`.
4. Edit `ambient.yml` (and `config.yml` for the default ambience) to design your soundscapes, then create zones in-game with `/atmo menu`.

Atmo generates four configuration files, each with a specific function:

config.yml - Global player permissions (`AllowPlayerDisableMusic`, `AllowPlayerDisableAmbient`) and the default ambience/music applied per-world when a player isn't inside any zone.
area.yml - The zones file: world, the two corner positions, priority, and the linked ambient/music settings.
ambient.yml - The ambient profiles: a background sound and a list of random sounds, referenced by name from ` area.yml` and ` config.yml`.
blockSound.yml - Entity-bound and position-bound sound triggers.

config.yml - default ambience example

area.yml - zone example

ambient.yml - ambient profile example

blockSound.yml - entity & position example

• atmo.use - Base permission required to use `/atmo` (default command permission).
• atmo.admin - Grants access to every subcommand.
• atmo.menu - Use `/atmo menu`.
• atmo.editor - Use `/atmo editor`.
• atmo.info - Use `/atmo info`.
• atmo.reload - Use `/atmo reload`.
• atmo.addloc - Use `/atmo addloc <name>`.
• atmo.music - Use `/atmo music` (not required if `AllowPlayerDisableMusic` is true in `config.yml`).
• atmo.ambient - Use `/atmo ambient` (not required if `AllowPlayerDisableAmbient` is true in `config.yml`).
• atmo.volume - Use `/atmo volume`.

Creating a Zone

1. Run /atmo menu and click "Create an area".
2. Type the zone's name in the anvil GUI and confirm.
3. Left-click a block to set Position 1, then right-click another block to set Position 2.
4. The zone is instantly saved to `area.yml` with default settings (priority 1, music/ambient disabled). Edit the file to link it to an ambient profile and/or music track, then run `/atmo reload`.

Browsing Zones

Adding a Position-Bound Sound Location




If you run into any issue or have a suggestion for Atmo, feel free to open the Discussion tab below.

Credits
Atmo Plugin developed by @omijica.