PlayMoreSounds is a very complete plugin that you can assign sounds for various occasions. The main goal of the plugin is to play a sound whenever a player triggers an event (an action).
For Minecraft 1.17 or newer, download latest version.
For Minecraft versions lower than 1.17, use 4.1.2.
→Sound Events←
PlayMoreSounds has many events, some may support different sounds for specific occasions.
Only the events you use are registered, so you can use this plugin if you want a sound for just one single event and don't worry about performance!
Ban player from server
Change Held Item - Supports holding specific items!
Change Level
Change Worlds
Chatting - Supports specific words in chat!
Craft Item
Drop Item
Edit Book
Entity Hit - Supports specific entities hitting each other holding specific items!
Entiy Jump (Requires Paper)
First Join
Furnace Extract
Game Mode Change - Supports changing to specific game modes!
Inventory Click - Supports clicking specific items!
Inventory Close
Join Server
Kick player from server
Leave Server
Lie in bed | Leave bed
Per Biome Enter and Leave - Supports looping sounds!
Player Death - Supports specific death types!
Player Jump (Requires Paper)
Player Kill or be Killed
Player Swing - Supports swinging specific items!
Portal Create
Region Enter and Leave - Supports looping sounds!
Respawn
Send Command - Supports specific commands!
Start Flying | Stop Flying
Swap Hands
Teleport by command
Toggle Sneak
Wake Up
Weather Rain | Weather Rain End
World specific time of day
To setup sounds, enter the file 'sounds.yml'. Here's a tutorial:
Code (YAML):
########################################################################################################### # Set a sound to play when an event is triggered. # # # # Create a section with the name of the event you want to play a sound, for example: # # # Teleport: # The event that when triggered, a sound will be played. # # Cancellable prevents the sound from playing if another plugin cancelled the event. This boolean helps # #sounds be compatible with other plugins. # Cancellable: true
# # Enables or disables a sound. In sounds.yml when this boolean is set to false the event is unregistered# #as well, so you can use this plugin if you want to play sounds just for one event and don't worry about# #performance being spent on things you don't use. # Enabled: true
# # This is a list of sounds that will be played. You can copy and paste the options below to play # #multiple sounds, each section must have a different name, here I numbered them just for organization. # Sounds: # '1': # # The category this sound will be played. # Category: MASTER
# # This is a delay in ticks the sound will wait before playing. Set to 0 for no delay. # Delay: 0
# # Sounds can have multiple options, all of them are optional. # Options: # # Even if a player has toggled their sounds off using "/pms toggle", the sound will be played. # Ignores Disabled: false
# # The sound will be only played if the player has this permission. # # In case the event is not triggered by a player, this option is ignored. # Permission Required: 'playmoresounds.reproduce.teleport'
# # The sound will be only listened by who have this permission. # # In case this is a Radius sound and the player has the Permission Required and not # #Permission To Listen, the sound will be played anyway, but only those in the Radius with the # #Permission To Listen will hear. # Permission To Listen: 'playmoresounds.listen.teleport'
# # A range of blocks the sound will be hearable. # # A distance in blocks is calculated to every player in the world if the value is greater than 0. # # If you want the sound to play only to the player who triggered the event, set this to 0. # # If you want the sound to play to everyone online in the server, set this to -1. # # If you want the sound to play to everyone in the event's world, set this to -2. # Radius: 15.2
# # A location is added to the event's final location. This will always respect where the player is # #looking, i.e. if you add blocks to right the sound will be played to the player's right ear. # # Relative location option consumes a lot of memory, I recommend you leave it disabled if your # #server has a lot of players. # # Set negative to add blocks to the opposite direction, for example: # Relative Location: # FRONT_BACK: 1.3
# This will be played relative to the back. # RIGHT_LEFT: -0.01
# This will be played relative to the right. # UP_DOWN: 0.13
# This will be played relative to up. # # What the sound pitch is, values greater than 2 have no difference. # Pitch: 1.0
# # You can set this to either a Sound Type or a Custom Sound. # # Custom sounds do not need to be listed anywhere in the plugin, just set this value to the name of # #custom sound you set in your resource pack's sounds.json. # # PlayMoreSounds' sound types are different than bukkit's sound types, PlayMoreSounds' sound types # #are always the same no matter which version of the server you are running, so sounds have the same # #names in 1.7 to 1.18. # Sound: ENTITY_ENDERMAN_TELEPORT
# # The volume of the sound. The way minecraft does it is by distance, volume 1 = ~15 blocks. # # If you are playing region sounds you might want to set this to a big number so it plays with the # #same volume the whole region. # # You will notice the volume go lower if you set it to a decimal lower than 1. # Volume: 0.9
# # # # Any of the above options are optional, here's an example of a sound that doesn't need to use all of # #these options: # Player Death: # Enabled: true
# Sounds: # '1': # Sound: ENTITY_WITHER_SPAWN
# # # # If you don't want to use a sound, you can either completely remove it from this configuration or set # #'Enabled' to false, like this: # Bed Leave: # Enabled: false
# Disabled sounds will be unregistered and not affect server performance. # ###########################################################################################################
→ Regions←
PlayMoreSounds has its own region system, each player can have their own region and add enter, leave and looping sounds to it.
You can select regions either by command or using the region tool.
Region Tool:
- Type in the command
/pms region wand to get the region selection tool.
- To select, click in the two ends of the area that you want to create a region. Left-click to select position 1, right-click to select position 2
Commands:
If you are in-game, use the command
/pms region set p1 or
/pms region set p2 to select to your current location.
If you are on console, use the command
/pms region set p1|p2 <world> <x> <y> <z> to select the positions.
To create the region use the command
/pms region create [name] [description] Currently the only way to set sounds to regions is by adding them to 'regions.yml' file inside 'Sounds' folder. Read that file for a tutorial on how to do it. In the future I intend to create a GUI to add sounds to regions more easily.
→ Plugin Hooks ← PlayMoreSounds supports addons, these addons can add compatibility to any plugin you want.
How to install Addons: To install addons, type in the command '/pms addons'. The addon management GUI will open, click on Install Addons:
The plugin will download the latest addons on
PlayMoreSounds' GitHub.
When it finishes, another inventory will pop up with the addons you wanna install:
After installing, click on
Done to close the inventory.
The addons will be loaded the next time your server restarts. When there's addons installed the addon management inventory looks like this:
PlayMoreSounds currently has 13 addons:
AuthMe Hook: Adds sounds to login and register events from AuthMe.
ChatReaction Hook: Adds sounds to reaction fail, start, and win from ChatReaction.
CMI Hook: Adds sounds to afk and vanish toggle events from CMI.
Custom Discs: Adds custom items that can be used as discs in jukeboxes to play custom sounds.
Essentials Hook: Adds sounds to afk, god and vanish toggle events from Essentials.
EssentialsChat Hook: Allows you to assign a sound when talking in local, shout and question channels.
Nature Sound Replacer: Replace or stop default minecraft sounds in your server from playing.
NBS Song Player: Plays .nbs songs using NoteBlockAPI.
Sound Commands: Execute commands when a sound is played.
Sound Factors: Prevents sounds from playing if the player is not in a range of height or time.
SuperVanish Hook: Adds sounds to vanish events from SuperVanish.
VentureChat Hook: Allows you to assign a sound when talking in a specific channel.
WorldGuard Regions: Allows you to play enter, leave and loop sounds to WorldGuard regions.
(Optional) Edit sounds.yml for default sounds or edit files inside Sounds folder for specific sounds.
(Optional) Add permissions to players.
→ Permissions ←
→ Commands←
/playmoresounds addons [list|uninstall] > Opens a GUI that helps you install or uninstall addons. /playmoresounds check [target] > Checks if sounds of target are enabled. /playmoresounds confirm [id|list] > Confirms something pending. /playmoresounds editor > Opens a GUI showing PlayMoreSounds data folder files which you can play or add sounds. /playmoresounds help [command] > Shows the description of a command. /playmoresounds list [page] [--gui] > Lists the sounds available on your version by GUI or text. /playmoresounds play <sound|path> [target] [vol] [pitch] > Plays the sound or config sound to the targets. /playmoresounds region <create|info|list|remove|rename|set|sound|teleport|wand> > Regions commands. /playmoresounds stopsound [target] [sounds] > Stops the sounds of the target. /playmoresounds toggle [target] [on|off] > Toggles the sounds of the target. /playmoresounds update [download [--force]] > Checks or downloads PlayMoreSounds updates.
→ Metrics←
PlayMoreSounds collects anonymous metrics using bStats, these metrics help me decide on how to develop the plugin. If you don't want to send metrics disable in bStats configuration. You can see a list of all data that is collected by clicking the image below: