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!
- 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!
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
musics.yml – Define music properties
Code (YAML):
musics:
spawn:
sound
: MUSIC_DISC_CAT
interval
: 185
# How long is the music in seconds? put the duration here, it's the loop interval, may it be your custom music or vanilla music
custommusic:
sound
: records.cat
# supports string versions for custom music such as itemsadder, etc.
interval
: 185
RegionMusic Commands
- /regionmusic reload
Reloads the plugin configuration files.
- /togglemusic
Toggles music playback on/off for the player.
- /regionmusic playmusic <musicname>
▶️ 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)
Notes
- Perfect for RPG servers, adventure maps, or immersive spawn areas
- Tested on Minecraft 1.20.2 and 1.21.5
- Toggle music with /togglemusic