RegionMusic lets you play custom sounds or music when players enter or leave specific WorldGuard regions, fully configurable and lightweight!
For support/suggestions, please join my discord:
https://discord.gg/D8y7JQP4dN
✨ Features
- Play music/sounds on region enter or leave
- Supports all WorldGuard regions
- Configurable via regions.yml and musics.yml
- One-time trigger per enter/exit (no spam!)
- Supports vanilla and custom sound strings (e.g., ItemsAdder)
- Lightweight & optimized for performance
- Prevents overlapping music from different regions
- ✅ / ❌ Player toggle support for music
What Makes Us Different from OpenAudioMC and WorldGuardExtraFlags?
- OpenAudioMC
- No need to open external links or browser windows
- Music plays directly from your Minecraft server, no 3rd party client needed!
- No need to open external links or browser windows
- WorldGuardExtraFlags
- Skip the hassle of setting up flags in-game
- Includes a built-in /togglemusic command so players can choose whether they want music or not!
- Skip the hassle of setting up flags in-game
Configuration
regions.yml – Assign music to regions
Code (YAML):
regions:
spawn:
regionname : spawn # Your WorldGuard region name
music : spawn # Refers to an entry in musics.yml
dungeon1:
regionname : boss_area
music : boss
spawn:
regionname : spawn # Your WorldGuard region name
music : spawn # Refers to an entry in musics.yml
dungeon1:
regionname : boss_area
music : boss
Code (YAML):
musics:
spawn:
sound : MUSIC_DISC_CAT # The sound to play. Use a Bukkit Sound enum (e.g. MUSIC_DISC_CAT) or a custom string (e.g. records.cat for ItemsAdder, etc.)
interval : 185 # Loop interval in seconds. Set this to the duration of the sound so it loops seamlessly.
category : MASTER # Sound category. Controls which volume slider in Minecraft settings affects this sound. Options: MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
volume : 999 # Volume of the sound. 999 makes it audible from anywhere in the world regardless of distance.
pitch : 1.0 # Pitch of the sound. 1.0 is normal speed. Range: 0.5 (slower/lower) to 2.0 (faster/higher).
custommusic:
sound : records.cat # The sound to play. Use a Bukkit Sound enum (e.g. MUSIC_DISC_CAT) or a custom string (e.g. records.cat for ItemsAdder, etc.)
interval : 185 # Loop interval in seconds. Set this to the duration of the sound so it loops seamlessly.
category : RECORD # Sound category. Controls which volume slider in Minecraft settings affects this sound. Options: MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
volume : 999 # Volume of the sound. 999 makes it audible from anywhere in the world regardless of distance.
pitch : 1.0 # Pitch of the sound. 1.0 is normal speed. Range: 0.5 (slower/lower) to 2.0 (faster/higher).
spawn:
sound : MUSIC_DISC_CAT # The sound to play. Use a Bukkit Sound enum (e.g. MUSIC_DISC_CAT) or a custom string (e.g. records.cat for ItemsAdder, etc.)
interval : 185 # Loop interval in seconds. Set this to the duration of the sound so it loops seamlessly.
category : MASTER # Sound category. Controls which volume slider in Minecraft settings affects this sound. Options: MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
volume : 999 # Volume of the sound. 999 makes it audible from anywhere in the world regardless of distance.
pitch : 1.0 # Pitch of the sound. 1.0 is normal speed. Range: 0.5 (slower/lower) to 2.0 (faster/higher).
custommusic:
sound : records.cat # The sound to play. Use a Bukkit Sound enum (e.g. MUSIC_DISC_CAT) or a custom string (e.g. records.cat for ItemsAdder, etc.)
interval : 185 # Loop interval in seconds. Set this to the duration of the sound so it loops seamlessly.
category : RECORD # Sound category. Controls which volume slider in Minecraft settings affects this sound. Options: MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
volume : 999 # Volume of the sound. 999 makes it audible from anywhere in the world regardless of distance.
pitch : 1.0 # Pitch of the sound. 1.0 is normal speed. Range: 0.5 (slower/lower) to 2.0 (faster/higher).
- /regionmusic reload
Reloads the plugin configuration files.
- /togglemusic
Toggles music playback on/off for the player.
- /regionmusic playmusic <musicname> <category(optional)> <volume(optional)> <pitch(optional)>
▶️ Plays a specific music once (for testing purposes).
- /regionmusic stopmusic <musicname>
⏹ Stops a specific music that is currently playing (for testing).
Requirements
- ✅ WorldGuard (v7.0.9+ recommended)
- ✅ PaperMC (for best compatibility)
- Java 21 or newer
- Perfect for RPG servers, adventure maps, or immersive spawn areas
- Tested on Minecraft 1.20.2 and 1.21.5
- Toggle music with /togglemusic
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
RegionMusic | Make your regions more entertaining! is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21. Downloaded 393 times (via Spigot). Download it and open it directly in the game.