2.2 Creating Your First Region

SoundBounds is for making sound within bounds!

There are two important spatial concepts to understand in SoundBounds. First up we have regions, and next we have volumes. A region defines a 3D area , and allows you to associate that area with a playlist. For instance, you could have a region named castle associated with a playlist full of medieval music. We'll get into playlists later but for now here are the details on that "3D area".

Each region contains a list of volumes. A volume is just a box, comprised of two corners (block positions). If you've used WorldEdit before, you're probably familiar with this idea! A region does not have to be a single, contiguous shape, as this constraint would prevent you from splitting a region across a warp point.

Your first region

Creating a region is easy! There's an in-game item for defining volumes called the Bounds Baton. You can find it in the "Tools" tab of the creative menu, or run /give <Player> soundbounds:bounds_baton. Use your left- and right-click to select the two corners of your region's initial volume. Then, run /sb create <name> <priority>, providing a region name and a priority value (an integer greater than or equal to zero, higher numbers are considered higher priority).

And there you have it! Now you have a region that... makes no sounds.

Filling your playlist

Now that you have a region, you can start using the /sb edit command! Try /sb edit <name> playlist append <song-id> to add your first song. If all goes well, you should be hearing music from your resource pack! But wait: there's a whole lot more you can do your playlists.

A note on Y coordinates

The player's Y position in-game refers to the position of their feet, not their head. When assigning regions, keep in mind that in order for the sound not to fade out when the player jumps, the bounding box must be a minimum of three blocks tall.