Note

PLEASE READ THE RESOURCE OVERVIEW BEFORE DOWNLOADING THE PLUGIN TO SEE IF THIS PLUGIN FITS YOUR NEEDS. IF YOU HAVE ANY QUESTIONS, JOIN MY DISCORD SERVER AND CREATE A TICKET.

Spigot | Modrinth | Discord | Wiki

Sonus

Sonus is a powerful yet lightweight plugin compatible with Spigot, Paper, Purpur, and Folia servers, designed to create immersive audio experiences. It allows you to define custom regions within your world and attach specific sounds, music, or effects to them. From the bustling noise of a marketplace to the eerie whispers of a haunted forest, Sonus gives you the tools to bring your world to life with sound.

Features

• Define sound zones anywhere in your world with an easy-to-use selection wand.
• Full control over sound, source, volume, pitch, and looping in a simple sounds.yml file.
• Manage everything with simple commands, from defining regions to assigning sounds
• Use built-in Minecraft sounds or add your own custom audio for a truly unique atmosphere.
• Extensive permission nodes for all commands and features.
• Folia Support

Showcase

Check this section of the wiki for a showcase of the plugin: Showcase

Installation Guide

Setting up Sonus is designed to be as simple as possible.

1. Download the latest release of Sonus, based on your server version, from the release section.
2. Place the downloaded .jar file into your server’s /plugins folder.
3. Restart your server. This will generate the default configuration files in the plugins/Sonus/ folder.

Update Guide

For most updates that include bug fixes and small feature additions, you do not need to reset your configuration files.

1. Stop your server.
2. Delete the old Sonus-x.x.x.jar file from your /plugins folder.
3. Place the new, downloaded .jar file into your /plugins folder and remove the old one.
4. Start your server.

Warning

Always check the changelog before updating. It will state if a configuration reset is necessary. If a reset is recommended, back up your existing plugins/Sonus folder and delete the necessary configuration files.

Statistics

To guide future development and improvements, this plugin utilises bStats to gather anonymous statistics on its usage. This helps me track the total server count, assess version compatibility needs, and see which features are most valued by the community.

You can view all of this information openly on the public dashboard: https://bstats.org/plugin/bukkit/Sonus

If you prefer to disable bStats, you can manage this setting for your entire server within the plugins/bStats/config.yml configuration file.

License

Distributed under the GNU GPL v3 License. See LICENSE for more information.