This version only works with java 17! And it was meant to be run on minecraft 1.18 or newer, all previous measures to support lower versions were removed in order to achieve better performance.
The plugin might work as low as 1.17, but if you find any error that's in this version and not in 1.18, I won't be fixing it.
Use EpicPluginLib v2.2.1 or the plugin won't start!

All classes in the plugin were taken a look at and changed, in order to use java 17 features and fix bugs found on the way. This was really hard to do in a short time period, if you appreciate my work consider donating or leaving a review.
Addons are currently unavailable for this version, they will be back as soon as I update them.

General sound playing improvements:

• Spectators and players with invisibility effect were not able to hear sounds. Now they can hear all sounds, but the sounds are treated as if you set the Radius option to 0.
• Add error messages when a configuration sound has an invalid namespaced key, previously an ugly error would be thrown to console.
• Players will be cached when checking for toggle state, previously the plugin would access the player persistent data everytime it played a sound.
• Improve sound playing performance significantly by removing support to versions lower than 1.10 and 1.7, which had their own way of playing sounds. Also by removing some unused features, check Removals below.

Death sounds improvements:

• Last death cause will only be recorded in case any sound in 'death types.yml' is enabled, which previously was recorded on every hit.
• Player Kill and Player Killed will play even when 'Player Death' or 'death types' sounds are disabled, which previously wouldn't.

Addon Updates:

• Addons will now only load after its dependencies were loaded, to fix issues.
• Improved error messages sent to console.
• Changed the Regions Handler code SEVERELY: Now all region sounds are cached on load saving performance when playing them, plus the wait for resource pack load before playing sounds was generalized in this addon.
  This is a really recommended update for WorldGuard Regions addon, it improves performance significantly.
• Create RedProtect Regions addon: Since regions handler had a big update, I decided to update this addon too, which previously was abandoned.
• Created VentureChat Hook, UltimateChat Hook and EssentialsChat Hook addons: They can hook into these plugins and play different sounds for each channel.
• Created Extra Options addon: This addon brings some extras to the Options section in a sound, like Relative Location that was removed.
  You can install or update addons through the command /pms addons.

Regions:

• Improve region saving and deleting performance.
• Native region sounds were changed severely to keep up with Regions Handler and cache region sounds on load.
• Basically, the sounds are now cached everytime the plugin is reloaded, instead of getting the sound from config everytime it should play.
• Players were able to set a description on 'create' command, even if they didn't have permission 'playmoresounds.region.description'.

Sound Events:

• Removed checks to prevent listeners from being registered in older versions.
• Events will be more precise when checking if a sound is enabled.
• Cache world time triggers sounds on load instead of getting it everytime.
• Fix weather sounds giving errors if you disable one of the two sounds.
• Fix flight sounds giving errors if you disable one of the two sounds.

Commands:

• List command will page default to 1 if you specify a number lower than 1.
• Play command will play even when players have sounds toggled off.
• Added new 'dev' command: Special Arguments
  • Use them as /pms dev <argument>
  • register addons: In case you just installed addons, this will register them and allow you to start them with the argument below. (This command only works once, and if there are no addons installed)
  • experimental addon commands: Enables /pms addons stop and start commands, allowing you to stop and start addons.
    
  • stop all addons: Stops all addons that are currently loaded.
    
  • log sounds: All sounds will be logged to console when played, along with the player name.
    
  • get confirmations <player|uuid>: Lists confirmations of another player, can be someone offline or console if you use "null".
    
  • confirm <id> <player|uuid>: Allows you to confirm someone elses confirmation (null to console).
  • rgnew <player|uuid>: Allows you to create a region with someone else as owner (null to console), if you want to create for someone offline, specify an uuid. All limits for region amount/max area/overlapping regions are bypassed.

Removals:

• Removed Relative Location option: This option would make some impact on performance even when you didn't use it, so it was removed because the majority of users don't use it.
• Removed World Black List feature: This feature showed absolutely no use in bStats, so it was removed to save performance.
• Removed Enable Sounds On Login.
• Removed PrePlaySoundEvent: This event was called before the sound had parsed the Permission Required, and since it has no use in current addons it was removed to save performance.
• Removed all sounds from SoundType that's below 1.17.
  
  
• I'm creating Extra Options addon: Brings back Relative Location and World Black List. This addon should be coming out soon.

What to expect of 5.0:

• Several classes will be renamed.
• The folders and configurations will be renamed.
• A proper stop sound method will be added to the Playable interface, so sounds with delay can be stopped before they're played.
• Addon loading code will be completely rewritten in order to add commands for starting and stopping addons without restarting server.
• The entire yaml configuration api will change, while also making use of new SnakeYAML 1.30 features.
• Radio feature: You will be able to play a sound infinitely in a specific location, or the whole world, without needing to create a region.

This update will be the last to support versions lower than 1.18, so I decided to make it big and fix all sorts of bugs and bring cool features.

Make sure to update to EpicPluginLib v2.2 or the plugin won't start!

Changelog:

• Add sound list when you try to tab complete /pms play command.

• Add sound categories to 'available sounds.txt'

• Add "/pms update download [--force]" command to allow downloads of new updates through api.spiGET.org.

• Add 1.18 sounds that were missing.

• Add way of uninstalling addons through Addon Management Inventory or the command /pms addons uninstall.

• Addons descriptions will break lines if the description is too long in Addon Management Inventory.

• Improve performance considerably when checking for region wand when the player left or right clicks.

• Improve resource packer feature:
  • If a player is trying to join and constantly failing to download the resource pack (when Force is on), admins with the permission 'playmoresounds.resourcepacker.administrator' will be prompted to type "/pms confirm" to allow this player to join without a resource pack.
  • In supported versions, the "accept resource pack" message will be shown in the prompt rather than chat. Also removed PlayMoreSounds prefix from this message.
  • You can specify a hash to improve resource pack loading.
  • Players with permission 'playmoresounds.resourcepacker.force.bypass' will be able to decline even when Force is on.
  • The kick message will be different if resource pack failed to download.

• Made addons start and stop on main thread to fix some synchronization issues.

• Made Custom Discs feature an addon due to low usage on bStats. Use "/pms addons" to download the addon and use this feature again.

• Made biome sounds take login event into account.

• Made so Addons and List GUIs use the same way of handling inventories. This means List GUI is now compatible with all versions, has better performance and less bugs.

• Made so when you type region removal command multiple times, the confirmation will no longer repeat on "/pms confirm list".

• Made update checker reload on "/pms reload", plus huge changes and simplification of update checker code.

• Renamed multiple configuration keys for List and Addon GUIs.

• Rewrote "wait for resource pack load before playing sound" code, also add support for biome sounds feature. This fixes minecraft sounds not playing at login in case the player declines the resource pack.

• Update chinese language thanks to AndyYu.

A small bugfix update before 4.2

Changelog:

• Fix Addon Management Inventory trying to send titles while downloading addons in unsupported minecraft versions, making it impossible to download addons.
• Fix FurnaceExtractEvent listener playing "Craft Item" sound instead of "Furnace Extract".
• Fix Swap Hands sound being registered on 1.9 even tho it was added on 1.9.2.

Known issues:

• Region events are not triggered when you enter or leave regions in a minecart.
• Teleporting to a region plays the region sound in the location the player was before teleporting.

Attention: This is the last major version of PlayMoreSounds to support older versions! As of 4.2, PlayMoreSounds will support only Minecraft 1.18 and Java 17. I made this decision because supporting a single version allows me to improve PlayMoreSounds performance drastically, plus it makes updating the code much easier.

Changelog:

• Add Sound Category feature: if you are on version 1.11+ you can choose a sound category to play the sound in.
• Add a notice message for when 4.2 update is available and your server is not in 1.18.
• Add support for 1.18 sounds.
• Add support for old craftbukkit versions, I tested as low as 1.5.2, but PlayMoreSounds might work on older versions.
• Fix ChatReaction Hook addon giving errors when playing sounds.
• Fix Regions Handler addon not stopping NBS Song Player songs on exit.
• General performance improvements with the introduction of EpicPluginLib 2.1.
• Made so if you use Resource Packer feature and a player that joined the server is inside a region with a custom sound, the sound will be played after the resource pack has loaded.
• Nature Sound Replacer was turned into an addon and removed from PlayMoreSounds base plugin, this decision was made because the usage of this feature was pretty low in bStats. Use /pms addons to download the addon and use this feature again. You can expect this happening to Custom Discs feature in the next update.
• Players on spectator mode will no longer play radius sounds.

A few addons were updated, please download the latest version of the following addons using /pms addons:

• ChatReaction Hook
• WorldGuard Regions

Known issues:

• Region events are not triggered when you enter or leave regions in a minecart.
• Teleporting to a region plays the region sound in the location the player was before teleporting.

Upcoming in next update:

• Way of choosing the location where the sound will play in a region.
• Echoey Nether addon: Plays all sounds in the nether with an echo.
• Custom Discs addon: Adds new forms of discs to jukeboxes.

If you find any unknown bugs, feel free to contact me on PMS discord.

Fixing some issues that were introduced in last update, if you haven't read it yet go check it out: https://www.spigotmc.org/resources/37429/update?update=409110

• Disable Portal Create sound for versions lower than 1.14 due to API changes

• Disable Swap Hands sound from being registered on versions lower than 1.9

• Fix Addons Management Inventory not working on version 1.12 or lower

• Fix Radius value not being converted from config, resulting in a Radius not in blocks

• Fix subtitle of downloading addon files saying "Key Not Found"

• Make bStats message only show up if bStats is enabled

• Prevent Swap Hands sound from playing if the player is holding air

PlayMoreSounds is 4 years old!

A lot has changed since the first version back in 2017, firstly intended to be an updated version of the plugin MoreSounds by filoghost for my personal server, PlayMoreSounds has grown a lot and we've reached 19k downloads recently! Thank you everyone that stick with me, motivating me to update this wonderful plugin!

Warnings:
- Before updating PlayMoreSounds, make sure to download the latest version of EpicPluginLib.
- Once you restart your server, a few of your configurations will be renamed to "outdated ....yml" so you can manually convert your settings from v3.3.0 to this one.
- Make sure to delete all of your addons that you had previously installed.

Notice: Supporting multiple minecraft versions consumes much more performance than supporting just one version, so this is the last version that supports Minecraft down to 1.7! The next version (4.1) will support only Minecraft 1.17+ and Java 16, the plugin might work on older versions but I will not be providing any support to the errors thrown.

Now to the new features!

Nature Sound Replacer:
Now you can replace ANY nature sound in your server. You can replace zombie sounds with skeleton sounds, creeper sounds with spiders, add delay, radius or relative location to nature sounds, you name it! All nature sounds can now be be replaced with a PlayMoreSounds sound.
To use this, install ProtocolLib and edit the file 'nature sound replacer.yml' inside 'Sounds' folder.

New Events:

• Player Kill and Player Killed: Play sounds when a player kills another player or is killed by another player.

• Portal Create: Play sounds when a player creates a nether portal.

• World Change: Play sounds when players teleport to a different world.

• Weather Rain and Weather Rain End: Play sounds when the weather of the world changes.

• Swap Hands: Play sounds when a player changes the hand they're holding the item.

• Edit Book: Play sounds when a player edits or signs a book and quill.

Addons:
Once you update, all addons will stop working.
All addons are open source now and they are available in PlayMoreSounds' github.
In order to get the compatible addons use the command "/pms addons", it downloads the addons from PlayMoreSounds' github and installs the addons you select in a GUI.

Full Changelog:

• Add Edit Book event sound
• Add Player Kill and Player Killed event sounds
• Add Portal Create event sound
• Add Swap Hands event sound
• Add Weather Rain and Weather Rain End event sounds
• Add World Change event sound
• Add a list of sounds that generates everytime the server starts, this list is just so you can tell which sounds are available in your version and does not add in anything
• Add addon management GUI: Download and see which addons you have installed.
• Add invalid sound message when you use an invalid sound on /pms play command
• Add all 1.17 sounds
• Add nature sound replacer: Replace any sound that plays in your server for one of your choice (ProtocolLib Required)
• Addons were moved to github: All addons are open source, and their downloads are available under PlayMoreSounds' releases
• Cache Login, Quit and Teleport sounds for optimization
• Change license to GNU GPLv3
• Fix a bug that made so some sounds were missing on non-major versions (1.8.1, 1.12.1 etc)
• Fix error when using "/pms region info" as console.
• Fix resource pack sounds with custom namespaces not being stopped
• Major changes to the API
• Optimize Relative Location calculator
• Optimize how regions are loaded, saved and how the enter/leave events are called
• Remove cache from addons when they are disabled
• Update to EpicPluginLib v2.0

Other Notes:
If you feel like this plugin helps you, consider donating. It helps me a lot!

Some strings for chinese language were missing for this update, if you would like to contribute to the plugin translation, please contact me!

Addons:

Custom discs:

Added more specific sounds:
Changes:

• Add 'Addon Hooks' and 'Plugin Hooks' settings to addon description.

• Add 20w46a sounds and change the way sounds are stored.

• Add better support for older versions: PlayMoreSounds will load on any version, but if you are on 1.7.2 or lower, radius -1 will throw errors due to changes in bukkit API.

• Add custom discs: Set a custom sound to play when a player uses a specific item on a jukebox.

• Add disc command: Get a disc from custom discs configuration.

• Add Player Jump and Entity Jump sounds. (Only works on PaperMC)

• Add Player Swing sounds: Play sounds when player swings their hand or specific items.

• Add specific item click sounds: Play sounds if you click on specific items on an inventory.

• Add specific item held sounds: Play sounds if you hold specific items on your hot bar.

• Change way of ordering addons based on dependency.

• Fix Null Pointer on stop sound command.

• Make region wand cache so it does not need to get from config everytime a player clicks.

• Make so region enter/loop sounds only stop if you are leaving the region you entered. Before it used to stop if you left any region.

• Rename 'chat' config to 'chat sounds'.

• Rename 'hurt sounds' config to 'hit sounds', and renamed the key 'hurt' to 'hit' on all conditions.

• Rename 'world times' config to 'world time triggers'.

Changes:

• Add 'Check' command: Check if your sounds are enabled or disabled.

• Add 'Stop Sound' command: Stop the sounds that are currently playing.

• Add 1.17 snapshot 20w45a sounds.

• Add addon loading queue system: Addons will load after their required dependencies were loaded. If one addon depends on each other, this will throw a StackOverFlow so beware.

• Add biomes sounds: Play sounds of enter, leave, or loop when you are on a specific biome.

• Add limit for currently appearing region borders.

• Add new smarter and optimized Relative Location calculator.

• Add persistent sound state toggler for 1.14+: Your sounds toggle state will remain even after the server restarts.

• Add setting on config to set region border appearing time.

• Critical Fix: regions not being loaded when the plugin starts/reloads.

• Make region events register only when there are region sounds enabled.

• Optimize initialization and reload.

• Remove Hook Addons and Hook Plugins setting from addon descriptions.

• Rename 'Ignores Toggle' sound option to 'Ignores Disabled'.

• Rename 'Stop Other Sounds' setting from most specific sounds configurations to 'Prevent Other Sounds' for better understandment. Most of your configurations will be restored so you can update it.

• Rename Relative Location directions: Use positive or negative numbers to add blocks to the direction respectively LEFT_RIGHT, FRONT_BACK and UP_DOWN.

• Update to EpicPluginLib v1.6.5.

Changes:

• Critical Fix: sounds not playing globally when radius is -1 or -2.

• Update to EpicPluginLib v1.6.4: Updater is now completely asynchronous to improve server performance.

Changes:

• Add Piglin Brute sounds from 1.16.2.

• Add a special halloween event: Random scary sounds for events and creeper sounds on random times of the day. You can disable it in config by the setting 'Halloween Event'.

• Add bStats data collection: bStats will anonymously collect data used for debug and optimization, if you don't want to contribute you can disable that in bStats configuration in your plugins folder.

• Add particles to show region border when using region info command: Colored note block particles will appear if you are seeing info of one region, if you are inside multiple nested regions each region will have its own color for the note block particle.

• Add support for specific entity hit sounds for 1.8.8.

• Fix error when trying to list someone else's regions.

• Fix minor issues with language strings, restoration is not necessary.

• Fix null pointer when Wake Up sound was disabled and Bed Leave sound was enabled or vice-versa.

• Fix prefix appearing in entries of pending confirmations list.

• Fix teleport sounds not playing when teleporting long distances.

• Overall optimization on addon registration and loading.

• Remove Eye Location option of sounds as it was not used by many people.

• Remove Hook Plugins option from addons as it was useless and buggy.

• Rename addon start times: BEFORE_CONFIGURATION to BEFORE_CONFIGURATIONS and BEFORE_EVENTS to BEFORE_LISTENERS.

• Rename 'World-BlackList' setting to 'World Black List'.

• Rename 'deathtypes' config to 'death types'.

• Rename 'time triggers' config to 'world times'.

• Update sponge initialization and add addon support to sponge platform.

• Update to EpicPluginLib v1.6.2.

This update fixes some critical issues, this should be the last update before the addons update. The addons update will add 23 addons to PlayMoreSounds and will be available on the next weeks.

Changes:

• Add chinese language, thanks to AndyYu.
• Add spanish language.
• Add Language Locale setting to config.yml.
• Add future proof sounds: If your server is running on a version greater than 1.16, PlayMoreSounds will use 1.16 sounds, unlike the previous version that didn't play any sounds if the version was unsupported.
• Disabled download function of update command temporarily since api.spiget.org is not updating PlayMoreSounds for some reason, but the updater is working fine and will alert you when new updates are available.
• Fix region sounds not playing at all.
• Fix errors that occurred when you set a specific event sound but disabled the default sound on sounds.yml.
• Fix Game Mode Change sounds not checking for Cancellable before playing.
• Fix errors that occurred when you had Bed Leave enabled and Wake Up disabled or vice-versa.
• Fix Stop On Exit function of region sounds only working for loops.
• Fix addon api not properly checking for addon version before enabling the addon.
• Removed EpicPluginLib version checker, please use the latest EpicPluginLib to avoid errors.

Warning: EpicPluginLib has just updated, make sure you are using the latest version before using this update.

Changes:

• Fixed error message appearing when a player moved and you had any regions on your server.
• Fixed a few permissions that were not working properly.
  
• Addons will now check for required plugins before starting.
• Updated to EpicPluginLib v1.6.

PlayMoreSounds has been recoded from zero. After almost 2 years, I finally could make a stable release with a lot of cool features.
If you didn't know I've been dropping snapshots on PlayMoreSounds discord every once in a while bringing back the old PlayMoreSounds features one at a time.
This release is stable, however addons are still not included. They will come back tho, I'm currently updating every single one of them and will drop a zip containing all. It should probably be out on the next week. Pay attention to PMS updater it should notify you more frequently.

PlayMoreSounds now depends on EpicPluginLib to work, make sure you have that installed before running the plugin.

New features:

• Resource Pack sounds support: Play any sound in your resource pack, just put the name of the resource pack sound in the place where the regular sound would be and PlayMoreSounds will play it.
• Resource Pack asker: When a player joins the server you can ask them to download a resource pack.
• New events: Inventory Close, Toggle Sneak, and Wake Up.
• A new filter system for Commands and Chat triggers: You can check if the messages starts with, ends with, is equal, and if contains the word.
• Entity hit trigger system: Play a sound whenever a specific entity hits another entity holding a specific item.
• A per player region system: Players can make their own regions (with limitations so they don't abuse) to play their own loop sounds. If you configure the limitations correctly you can make a fair system of sound playing regions for any player on your server.
• A huge optimization with a fancy API: Sounds and regions are now cached whenever you reload configurations.
• Smarter event disabling system: Don't consume memory on events that you don't use, this disabling system got smarter and will do more checks on reload so the checks don't need to be done when playing the sound.
• Added a new radius: -2 - Plays sounds for everyone in the world.
• A fancy list of sounds GUI. (1.14+)
• 1.16 support: It didn't fully come out yet but the sounds were already added to PlayMoreSounds api, so they will work.
• Specific death types trigger: Play different sounds for different kinds of death. (1.14+)
• Region loop sounds: Play sounds in loop while the player is standing on the region.

Changes:

• Delay is now an option, the section is used as name instead of delay now.
• All messages and config options were renamed.
• PlayMoreSounds now uses a new optimized yaml-handling api made by me.

Removals:

• Spanish and Chinese languages: Had no time to translate them, they should be coming back soon.
• Sounds enabled check command, but should be added back as well.
• Old "Hit" events.
• Cross Worlds option.
• Achievement and Advancement events.
• Toggle command cooldown (Why did I add that?).

Upcoming:

• Sound creating and editing GUI: You can navigate through PMS folder and edit or add sounds. The code is already in this release but there is no way use it. When the code is stable I'll make a new command to use it.
• Biomes enter, leave, and loop sounds. It was added but removed due to stability.
• ProtocolSupport, ViaVersion, and ViaRewind addons: Sounds will play even if player are in different versions than the server.
• WorldGuard, RedProtect, Lands addons: Play enter, leave and loop sounds for regions of these plugins.
• UltimateChat, Legendchat, UltraChat addons: Play different sounds for different channels.
• NoteBlockAPI addon: Play nbs sounds with PMS.
• Essentials, CMI addons: Play sounds for AFK, Vanish, God, sounds.
• ChatReaction addon: Play sounds when you win or loose.
• SuperVanish, VanishNoPacket addons: Play sounds when you vanish and hide radius sounds when you are vanished.
• Height Factor addon: Play sounds only if you are on a specific range of Y level.
• Specific Item swing addon: Play a sound when you swing an item (not hurting an entity).

- Removed PlayerJump debug messages.

Changes:

• Added CrossWorlds boolean to radius.
  
• Added PlayerBan event: Plays a sound when a player is banned.
• Added PlayerJump event: Plays a sound when a player jump.
• Added PlayerKicked event: Plays a sound when a player is kicked from the server.

• BugFix: Addons was generating config everytime it was enabled.
• BugFix: Critical bugs on Updater.
• BugFix: Languages were being reloaded even if /pms reload command wasn’t executed.
• BugFix: PerRegionSounds can only be loaded if RegionEnter or RegionLeave is enabled.
• BugFix: String not found when you create a new region.
• Finally rewrite and updated internal language. (No more String not found.)

• [API] Added getInterval() to ReproduceSoundEvent.
• [API] Added getListeners() to ReproduceSoundEvent. (Requires UseHardMethods enabled)
• [API] Added setSound(String), setVolume(Float), setPitch(Float) and setLocation(Location) to ReproduceSoundEvent to change the sound values.
• [API] EnterRegionEvent and ExitRegionEvent are now being called on teleport.

Changes:

• Added PerWorldTimeSounds: set a sound to play when the world reaches a specific time.

• BugFix: Region Selection Tool was not selecting positions.
• BugFix: Region commands was throwing incorrect syntax errors.
• BugFix: Sound command was not checking the sound of other players.
• BugFix: Toggle command was not playing config sounds.

• Changed the file customsounds.yml to addons.yml.
• Configuration now loads before addons.
• Finished compatibility addons: EssentialsAddon, VanishNoPacketAddon, RedProtectAddon and JobsRebornAddon.
• Moved commands.yml, gamemodes.yml, regions.yml, chatwords.yml, addons.yml to the folder “sounds”.
• Optimized Regions: If your server was lagging/crashing before, now it’s not.

• [API] Added getAddonName() to return the addon’s jar file name.
• [API] Added getFile() to return the addon’s jar file.
• [API] Added getLanguageRestrictorLanguages() to change language restrictor options.
• [API] Added getVersionRestrictorVersions() to change version restrictor options.
• [API] Added hasEnabledBefore() to check if the addon has loaded before.
• [API] Added setAddonName() so you can set a name to your addon.
• [API] Added setCancelledThisRound() and isCancelledThisRound() to ReproduceSoundEvent so you can stop the sound from playing only at this time.
• [API] Added stringToFile(File, String) to create a file based on the data.
• [API] Added toggleCommands(boolean) to cancel the registration of commands on the plugin startup.
• [API] Added toggleTabCompleter(boolean) to cancel the registration of tab completers on the plugin startup.
• [API] Moved toggleVersionRestrictor(boolean) and getVersionRestrictorStatus() to SoundAddon class, because only addons can change PlayMoreSounds startup settings.

• Added compatibility to Minecraft 1.13.
• Added PerChatWordSounds: You can now play a sound when a specific word is said on chat. You can also highligh the word in the config.
• Added more DebugOutput developer logs.
• Added regions.yml and chatwords.yml to /pms restore command.
• Added version-independent sounds: now you do not need to search sounds for each version. You can use one sound for all minecraft versions.
• Added ‘Enabled’ boolean to disable the event from playing a sound and consuming memory.
• Added ‘Ignore Toggle’ option to sound format – The sound will play even if the player has disabled his sounds with /pms toggle.
• Added ‘Location’ option to sound format – You can choose what location should the sound be played. EYE – Player’s eye location (Changes when crouching) or DEFAULT – The default location that is around player's feet.
• Added ‘Permission Listen’ option to sound format – Only players that have permission to listen to the sound will be able to hear it. If you won’t use this function, you don’t need to add it to the sound format.
• Added ‘Permission Required’ option to sound format – Only players with the specified permission can reproduce the sound. If you won’t use this function, you don’t need to add it to the sound format.
• Added ‘Radius’ per interval that before was only one radius to all intervals.
• Added ‘Sound Position’ option to sound format – You can change the original sound location by adding blocks to right, left, up, down, front and back. If you won’t use this function, you don’t need to add it to the sound format.
• Addons will now be enabled earlier, so you can change the properties of PlayMoreSounds’s startup.

• BugFix: If a player used /pms restore, any other player could confirm the restoration of this player request.
• BugFix: Noteblock notes was being recognized as a sound instead of a note.
• BugFix: The sound was not being disabled by ‘None’.
• BugFix: ‘CN’ was being recognized as an available language.

• Changed Noteblock notes separator from : to ;
• Changed the Sound Error Messages format to be more understandable.
• Changed the sound format configuration – not messed up as the older one... I think. Now you don’t need to add every single option to the sound format, if you won’t use it, you can just remove it. Currently the removable sound options are: PermissionListen, PermissionRequired, SoundPosition.

• Modified the place of some things in the default configuration.

• Removed teleport particles. (Sorry)
• Removed the worldsettings.yml code that was not suposed to be generated in this version.
• Removed ‘None’ sound.

• Sound Unregister Memory Saver rewritten.
• Sounds.yml configuration is now generated by code due to events available per minecraft version.
• Switched Global radius to Private radius. Now -1 will be considered to all players online and 0 to the private sound. – This was done because -1 in all plugins is considered as ‘infinite’ or ‘all’ and 0 means nothing (no radius, just the event maker can hear it and anyone else) so new people can understand easily. (It can be confusing at first but in the end we get used to it.)
• The plugin was 99% rewritten and 99% optimized.
• Updated spanish language file.

• [API] Added getPMSConfig(), getSoundsConfig(), getCustomConfig(), getCommandsConfig(), getRegionsConfig(), getGamemodesConfig() FileConfigurations that returns you to the respective configuration (if available).
• [API] Added getPostionsOf() to PlayMoreSounds api that returns the positions set to the respective sound.
• [API] Added getVersionRestrictorStatus() boolean so you can check if the version restrictor is enabled or not.
• [API] Added Interval object so yoy can get the options of an interval more easily.
• [API] Added SoundConfig object to api so you can create sounds more easily.
• [API] Added the integer final to getSoundOf(), getVolumeOf(), getPitchOf(), getRadiusOf(), isCancellableEnabled() to indicate what interval section’s thing that they want to get.
• [API] Added toggleErrorMessages() to the API so addons developers can make a new type of sound without any trouble.
• [API] Added toggleVersionRestrictor() void to the API – now you can disable the version check code that disables the plugin when a version is not compatible.
• [API] Changed some docs lines.
• [API] Changed the final of getSoundOf(), getVolumeOf(), getPitchOf(), getRadiusOf(), isCancellableEnabled() from EventName to String so can support Addons’s custom sounds that are not on the EventName enum – the EventName enum is pretty useless now but who knows in the future I add something to it.
• [API] Changed the getSound() from Sound to String on ReproduceSoundEvent.
• [API] Changed the old v2.3.1 code of getSoundOf(), getVolumeOf(), getPitchOf(), getRadiusOf(), isCancellableEnabled() to match the new sound format.
• [API] Removed getListeners() from the ReproduceSoundEvent from API – was dumb coded.
• [API] SoundAddon reloadConfig() void was actually reloading sounds.yml instead of customsounds.yml.
  ‘Sound player’ code rewritten again. – lighter... kind of – Now it can match to the new sound format and supports absent player events (Events that aren’t triggered by a player, like PerWorldTime event, RainStartsEvent etc.).

Warning: You are about to download an ALPHA build of the plugin. This build may not be stable and bugs may show up or even damage your previous settings. It is recommended that you backup your settings before installing this version on your bukkit server. Remembering: this version contain new additions that are still incomplete, so as not to mess up your server it is recommended that you disable all the new stuff on config.

Alpha versions are a preview of how the full release will behave.

Resume:

• A bunch of bugfixes.
• A lot of new features.
• A lot of new commands.
• Plugin all rewritten.
• New developers API.

Additions:

• Added regions system.
• Added addons feature.
• Added FirstJoin event.
• Added interval sound format.
• Added /pms edit command.
• Added /pms region command.
• Added command syntax helper.
• Added pages to /pms help.
• Added multiple sounds for each event feature.

Changes:

• All plugin features have been rewritten.
• Error detector now can detect more errors.
• Language files can now be found on the plugin folder.
• language_en have been all rewritten.
• Now the events that you are not using or putting the sound "NONE", will not consume the server performance.
• Now languages are separated from the jar.

Bug Fixes:

• BedLeave was not recognizing "NONE" sound.
• Cancellable was not working at all.
• GamemodeChange was not working properly.
• Updater was not recognizing numbers in order. (The dot remover was organizing 2.3.0 greater than 2.4).

Changes:

• Added compatibility with the last version of UltimateChat;
• Added CraftingExtract event;
• Now the configurations will only reload when you type the "/pms reload" command;
• Changed "ListCMD_SoundsColor" string to "ListCMD_Color";
• Fixed PerGamemodeSounds which was working very strangely;
• BugFix: BedLeave event was not recognizing the "NONE" sound;
• BugFix: Channels.yml was not being generated when the Chat Plugin was Legendchat;
• BugFix: PlayerTeleport event was throwing errors when player was teleported to another world.

Changes:

• Updated resource icon;
• Updated plugin API (New enum configuration and new ToggleSoundsEvent);
• Added PlayerFlight event to sounds configuration;
• Added PlayerFlightStop event to sounds configuration;
• Added Radius setting to sounds configuration: If the radius is -1 (for compatibility issues), the sound will only be played for the player who made the event. If it is 0, the sound will be played for all online players. If it is greater than 0, the sound will play to all players at that distance;
• Added Cancellable setting to sounds configuration: If another plugin has cancelled the event, PMS will not play the sound;
• Added Cooldown setting to ToggleCommand configuration: If a player has recently toggled his sounds, the player will need to wait a while before toggling again;
• Added HideOn to NearestSounds configuration;
  
• Added a new value to DebugOutput configuration: If you set the DebugOutput value to 'developer', the plugin will spam you with all logs and developer tests;
• Added NoteBlock notes to ToggleSounds and ReloadCommand sound events;
• Added CEM(Custom Error Messages) to HandHit configuration;
• BugFix: Now the sounds are not toggled to ON when a player has relloged;
• BugFix: The plugin was not sending Fatal-Error Message when config.yml did not exists;
• Removed unused class "JsonBuilder" on plugin's code;
  
• Now the plugin has his own updater coded by me;
• The NearestSounds is now the 'greater than 0' state of Radius.

Changes:

• Added World-BlackList setting to configuration;
• Added playmoresounds.sounds.join.listen and playmoresounds.sound.leave.listen permissions that allows players to listen to the join/leave sound;
• Added noteblock notes to sounds configuration: Use "Note." plus the noteblock instrument plus ";" plus the note. You can use this in PerThingSounds too;
• Added compatibility with my custom Legendchat: Now if you send a message in a channel with a distance bigger than 0, the sound 'PlayerChat' will be played to every player in this distance. If the channel's distance is 0, the sound will be played to everyone in the server;
• Added date easter eggs to the plugin which, if you want, you can disable in the configuration;
• Added RestoreCMD_Success_Plural string to language;
• Added gamemodes.yml to restorer command;
• Added Custom Error Messages to PerChannelSounds and PerRegionSounds;

• BugFix: The UltimateChat distance was not 100% accurate;
• BugFix (Critical): If a player has their sounds disabled, they can still hear NearestSounds;
• BugFix (Critical): If a player has their sounds disabled, they can still hear Join/Leave/Chat sounds from other players;
• Fixed PlayerAdvancementDone and PlayerAchievement that was not sending Custom Error Messages;

• Now the /pms update command does not download the update every time that you send the command;
• Now PerGamemodeSounds need to be in UpperCase;

• Removed PerEventMessages: It did not make sense to have messages in a sound plugin, so I separated PerEventMessages from PlayMoreSounds and made a new message plugin that you can find here;
• Removed HelpFooter string from the internally language;

• (Spigot) Updated the HelpHeader string from the internally language;
• Updated the Spanish language to 2.2;

• Changed PlayerHit to HandHit;
• Merged SwordHit and ArrowHit with HandHit code;
• Modified restore command;
• Some language strings have been modified.

This version is very prone to bugs. If you find one, please report it to me here.

Changes:

• Added PerGamemodeSounds;
• Added "<heart>" variable to ArrowHit message;
• Added "/pms restore" command to rsestore your configuration;
• Added "/pms confirm" command to confirm something;
• Added ConfirmOutdatedFileRestoration setting to configuration;
• Added Volume to "ToggleSounds" configuration;
• Added Volume and Pitch to "ReloadSound" configuration;
• Added PlayCommandDefaultVolume setting to configuration;
• Added PlayCommandDefaultPitch setting to configuration;
• Added support for Chinese language; - by AndyYu
• Added compatibility with Jobs: When a player join a job, the sound JobsJoin is played. When a player leave a job, the sound JobsLeave is played;
• Added FurnaceExtract event;
• Added BedEnter event;
• Added BedLeave event;
• Added AfkToggle event;
• Added JobsJoin event;
• Added JobsLeave event;
• Renamed "messages.yml" to "eventmessages.yml";
• Merged near sounds to normal sounds;
• BugFix: The nearest sounds are played with normal sounds;
• BugFix: Sometimes the teleportation particles were spawned incomplete or invisible;
• BugFix: "/pms play" command was not sending NoPermission message;
• BugFix: RegionEnter/RegionLeave was only playing if the file regions.yml has the configuration section of the region plugin;
• BugFix: PerRegionSounds of WorldGuard was getting the wrong path of configuration sections;
• BugFix: The sound of teleportation was not playing when crossing worlds;
• BugFix: The plugin was lagging the server when PlayerJoinEvent was called;
• BugFix: The plugin was registering unnecessary events;
• BugFix: Sometimes PerEventMessages were not sent;
• Now eventmessages.yml are generated only if the boolean "PerEventMessages" is enabled;
• Now the distance of the NearestSounds is the volume of the sound;
• Now the tab-completer show only the commands that you have permission;
• Now instead of sending error message, the plugin send to console the exact error that was interrupting the sound playback;
• Now if the message string of "language_custom.properties" is null, the plugin get automatically the message string of "language_en.properties" if its available. If its not, The plugin gets the language internally;
• Fixed an updater available message repeating scheduler that was generating a 1 hour repeating scheduler at each update check;

Changes:

• Added RegionEnter event to sounds configuration;
• Added RegionLeave event to sounds configuration;
• Added PerCommandSounds: You can choose a command and give a sound to it;
• Added compatibility with RedProtect:
  When you enter a region, the "RegionEnter" sound is played. When you exit a region, the "RegionLeave" sound is played;
• Added compatibility with WorldGuard (need WGRegionEvents to work): When you enter a region, the "RegionEnter" sound is played. When you exit a region, the "RegionLeave" sound is played;
• Added PerRegionSounds: You can choose an entering and exiting sound for a custom region. Works with RedProtect and WorldGuard;
• Added PerChannelSounds: You can choose a sound for each UltimateChat channel;
• Added "/pms play <sound> *" to play a sound to everyone;
• Added "/pms play <sound> me" to play a sound to you;
• Added "playmoresounds.play.others" permission;
• The code of the /pms play <event> command was too large and I was not adding the new events to it, so now it picks up all the events of sounds.yml without me to adding one by one, the code is now much more compact and totally different.
• The "/pms play" code has been completely rewritten;
  
• Removed "IgnoreCommands" from configuration because now the plugin has PerCommandSounds;
• BugFix: If the compatibility with UltimateChat was true and the player sent a message in the local chat, only players who are in the channel's distance can listen to the sound, the message sender did not hear it;
• BugFix: PlayerTeleportNearEvent was not working, it did not take the distance from the config, just the distance from the sound volume.

Any bug please report on: https://dev.bukkit.org/projects/playmoresounds/issues

Changes:

• Now the plugin sends a message to OP Players if the plugin have an update available;
• Now the plugin is compiled with Craftbukkit instead of Spigot for better compatibility.
  
• Now the plugin checks for updates every 10 minutes (Can be changed in configuration);
• Now the plugin does not update if the update version is smaller than the current version of the plugin. (Important for anyone who downloads on the spigot page);
  
• Now the plugin has new messages when it is enabled;
• Now the files sounds.yml and messages.yml is only reseted if the update has severes changes such as adding a new event or new configuration;
  
• The code is now more organized;
  
• BugFix: The plugin was not auto-toggling the sounds of a player to ON if the player relogged;
• Added colors for console messages;
  
• Added IgnoreCommands to ignore the PlayerCommand sound if the command is on the list;
• Added compatibility with the plugin UltimateChat:
  If a player sends a message on a channel with a distance larger than 0, the sound of the "PlayerChat" event will play only to players who can see the message. If the distance is 0, the message is sent to all players online;
• Added compatibility with the plugin ProtocolLib:
  If in the configuration, the "CommandAutoUpdate" boolean is false, the message of command "/pms update" will have new interactions: hover the mouse or click on it will show the last update link.

Changes:

• BugFix: If vanish is true and the hook with Essentials is false, the plugin still cancels the teleport particles. Fixed;
• BugFix: The MC 1.7 configuration did not generate the new booleans of version 1.8.1;
• BugFix: "Essentials hooked" message was not being sent;
• Added compatibility with VanishNoPacket.

Changes:

• Added "SendOnHitMobs" to ArrowHit messages configuration;
• Added CommandAutoUpdate configuration;
• BugFix: The plugin was seting the join and leave messages to null if the "SetQuitMessage" and "SetJoinMessage" setting was enabled and "JoinServer" or "LeaveServer" was disabled;
• BugFix: Very large decimal numbers sent in the ArrowHit message so now they are only natural numbers;
• MessageFix: "Messages.yml restored" was sent instead "Sounds.yml restored" when the sounds configuration was outdated;
• The SendMessageOnArrowHitPlayer code was merged with the SendMessageOnArrowHitMobs code;
• Now the Boolean "Random", the StringList "RandomMessages", and the String "Message" are merged with the StringList "Messages".
• Changed PerEventMessage configuration to PerEventMessages

Changes:

• Added Per Event Messages
• Added messages.yml
• Added new permissions to plugin.yml
  
• Fixed wrong configuration at first plugin loading
• Fixed folder organization that from 1_7_2 changed to 1_7_9
  
• BugFix: The sounds.yml file was not reloading
• BugFix: Languages were not reloading
• BugFix: ArrowHit, PlayerHit and SwordHit were not playing for iron golens and snowmen
• BugFix: Some debug messages were not being sent
• Removed UseAsyncChat from Configuration
• The configuration load method has been rewritten for better compatibility
• More organization in plugin code

Changes:

• Added permission "playmoresounds.toggle.others" to /pms toggle <player>.
• Added permission "playmoresounds.toggle.check.others" to /pms sounds <player>.

Changes:

• Fixed a bug that did not let the plugin start and generate files.
• Changed version string to 1.7.5.

Changes:

• Now the configuration and the sounds configuration are generated according to the version of MC that you are using. Example - If your server is 1.7, the sounds of sounds.yml and config.yml will be in version 1.7. And if it is above 1.9, the sounds of sounds.yml and config.yml will be in version 1.9.
• Now MC1.7.9 is 100% compatible

- Changed version string to 1.7.3.2

Changes:

• Fixed outdated configuration messages on console if config don't exists.
• Fixed error NullPointerException
• Added /pms toggle to PlayMoreSounds tab-completer

Changes:

• Now it is no longer necessary to the "Localization" line have a lowercase value.
• Now the plugin generates a log when some configuration error happens.
  
• Now you can check if the sounds of other players are ON or OFF. (/pms sounds <player>).
  
• Now you can toggle the sounds of other players. (/pms toggle <player>)
• Added "ConfigVersion" String to the plugin's configuration.
• Added "SoundsConfigVersion" string to the plugin's sounds configuration.
• Changed the /pms sounds toggle command to /pms toggle
  
• Removed /pms sounds toggle tab-completer.

NOTE: Update (1.7.1 - 1.7.2) The "config.yml" must be restored to the plugin work correctly

Changes:

• Now Localization config have to be in lowercase
• Now the PlayerCommand is canceled when a PlayMoreSounds command is sent.

• BugFix: For some reason multicraft servers did not recognize the lang folder so I left lang files accessible only inside the jar.
• BugFix: JoinServer was not playing correctly.

• Removed the translation of BR language on console, now it's all in english.

• Added support for Spanish language.

Changes:

• Added compatibility with Spigot-1.12pre5
• Now the plugin is 60% compatible with MC 1.7 (JoinServer, LeaveServer, PlayerTeleportNear, PlayerChat not working in MC 1.7)

Changes:

• Now the plugin is 99% compatible with Spigot-1.12 pre2
• Added Tab-Completer to commands "/pms", "/pms sounds", "/pms play"
• Added Advancements Done sound
• Added "playmoresounds.sound.advancements" permission
• Added error message for the events if the config has an invalid sound
• Added error message to the updater if the connection is offline
• Edited Essentials plugin compatibility

Changes:

• Now the configurations are separated
• Now the event sounds have different names
• Now the sounds configuration are more organized
• Now the language configuration are more organized

• Added new language files
• Added "/pms list" command
• Added "/pms update" command
• Added compatibility with essentials vanish
• Added UseAsyncChat configuration
• Added HelpBasedOnPermissions configuration
• Added ToggleSounds configuration
• Added DebugOutput configuration
• Added HideOn/TeleportParticles configuration
• Added CheckForUpdates configuration
• Added NearestSounds/Distance configuration
• Added ReloadSound configuration
• Added a permission for description command (/pms)
• Added "/pms play <event>" command, can be used as "/pms play JoinServer", "/pms play LeaveServer"...

• Removed the ".cmd" from command permissions
• Removed "playmoresounds.cmd.play.others" permission

• Changed "/pms sounds on/off" to "/pms sounds toggle"

• BugFix: "Unknown command" did not work perfectly

Changes:

• Added new permission "playmoresounds.cmd.toggle.check", to allow players to check if the sounds are enabled
• Added new permission "playmoresounds.cmd.play.others", to allow a player to play sound for others
• BugFix: When dispensers shoot arrows at animals, errors occur on the console. - FIXED

Note:
Sometimes, when the plugin is posted to the spigot, bukkit has not yet approved the update, so the updater reverts to the previous version. You can disable the updater in the plugin folder so this does not happen.

Changes:

• Added "/pms play" command
• Now the volume and pitch of sounds can be a decimal number (Yay)
• Redecorated configuration and help
• Fixed the mobs: Shulker, bat, slime and magma cubes that were not making sound while the OnSwordHit event and OnHandHit were executed
• Changed the volume of some sounds that before were not possible to lower
• Removed MC 1.7.10 compatibility

Changes:

• Fixed a bug that caused the plugin does not load

Changes:

• Added a way to edit help in the config
• Added more quick permissions
• BugFix: Quick permissions rewritten for greater compatibility
• Now instead of setting true or false to disable sounds, you can simply change them to NONE
• Some improvements in commands
• Some changes in sounds
• Only spigot: Fixed a permission node on "playmoresounds.admin"

Changes:

• Added command "/pms sounds" - Allows you to see if your sounds are enabled.
• Added command "/pms sounds on" - Allows you to enable your sounds.
• Added command "/pms sounds off" - Allows you to disable your sounds.
• Added "unknown command" message.
• Added updater - Now the plugin updates automatically (Thanks for Gravity).
• Added custom messages for each type of player.
• BugFix: Teleport Near Sounds are playing when you are vanished.
• Now the plugin has lots of messages related to the commands.
• Now the help shows the command/alias that you typed.

Changes:

• Added nearest sounds to OnTeleport/OnDrop/OnSwordHit/OnHandHit;
• Added new commands: "/pms help and /pms reload";
• Added a setting that allows you to choose if the nearest sounds should be played;
  
• BugFix: Particles of teleportation were shown only to the player who teleported;
• BugFix: OnSwordHit/OnHandHit/OnArrowHit were not being played for npcs.
• Removed a command that did nothing "/pms play"

Notes:

• The nearest sounds are played within a 15 blocks radius of the player who made the event.

Sorry if I'm sending lots and lots of updates at once. I mean, this is the first plugin that I publish and I had no idea it would be so hard to administer it. Anyway, let's go to the update!

Changes:

• Fixed an issue caused when OnSwordHit, OnHandHit, and OnArrowHit events were executed by hitting or shooting any entities like ArmorStands, ItemFrames, Boats, Minecarts...
• Fixed the apparition of the teleportation particles when the player was in gamemode spectator.

• Added OnArrowHit, OnSwordHit and OnHandHit permissions.

Notes:

• The OnArrowHit keeps making exceptions when a mob is hit by an arrow shot by a dispenser, this will probably be fixed in the next update.

Changes:

• Removed compatibility with LegendChat (Generating some errors while loading the plugin)

• Added auto permissions.

• Changed the volume of OnHandHit and OnSwordHit to 10 in file configuration.

• Fixed "/pmsreload" was not extracting the config that came from the plugin after being changed.

Changes:

• Added header for the help message
• Added footer for the help message

• BugFix (Critical): Fixed an error that caused some events to play sounds for all players in the same world. (InventoryClick, ChangeGamemode, Achievement, ArrowHit, ChangeExpLevel and Commands).
• BugFix: Fixed a bug that caused the sounds were not reproduced when using the chat of the LegendChat plugin.
• BugFix: Fixed an error that caused the OnArrowHit was not executed.

Changes:

• Added settings that allows the sounds to be played.
• Added prefix on messages.
• Added OnHandHit, OnSwordHit, OnArrowHit sounds.

• Changed permissions and configuration of OnGamemode to OnChangeGamemode.
• Changed permissions and configuration of OnHotBar to OnChangeHotBar.
• Changed permissions and configuration of OnExpLevel to OnChangeExpLevel.

• BugFix: Fixed the sound of inventory that was played to everyone online in server.
• BugFix: Fixed the sound that was reproduced in console when using the "/pmsreload" command.

To do:

• Add a message file separated from the configuration.
  
• Continue working on the inactive command "/pmsplay".
  
• Separate commands from each other.
  
• Continue working in the event messages

Until the next 1.5 update - The biggest event update

Changes:

1. Added particles effect when player teleports
2. Added compatiblity with essentials vanish
3. Added a sound when the command is executed successfully
4. BugFix: Deleted "stopSound" string (On Item Drop bug)
5. BugFix: Removed some unnecessary files that made the plugin heavy

Notes : Particles can only be canceled if a player has the invisibility effect, so it should not work properly with vanish plugins like VanishNoPacket and others....

Plugin status:
- Working in the messages per sound;
- Making the pitch and volume values compatible with decimal numbers (0.1/0.2/0.3/0.4...);
- Working on a compatibility with vanish plugins that do not have invisibility effects
- Working on a way to end the conflicts of sounds

If you find any bug in the plugin, please contact me so I can fix it

Changes:

1. Added a lot of events.
2. Added a lot of permissions.
3. Added custom message to command "/pmsreload" in configuration file.
4. BugFix: Teleport Sound bug fixed.
5. BugFix: Fixed Inventory Click pitch in configuration file.

Whats next?
Add messages to sounds when played
Add particles to teleport

Send me ideas to add more things to the plugin.

Changes:

• Added /pmsreload command
• Added compatibility with the versions of MC 1.8/ 1.9/ 1.10

Note: If you want to use the plugin in MC 1.8, change the sounds to 1.8 sounds list