SoundPlayer

---

SoundPlayer

*Version: 1.1* *Author: XCaNiNeX*

See it in action on caninecraft.reviverealm.net

Overview

SoundPlayer is a plugin that lets you create custom sound regions on your server. Play immersive sounds when players enter specific areas like hubs, spawn points, or mini-games. Regions can now be configured with different playback modes, loop timing, volume, and pitch for more control over how sounds behave.

Commands

> Aliases: `/player` > Aliases: `/looper`, `/spl`

Set Region Corners

* `/player pos1` Set the first corner of the region at your location.

* Example: `/player pos1`

* `/player pos2` Set the second corner of the region at your location.

* Example: `/player pos2`

Sound Formats

* Custom sound example: `entity.player.levelup` * Custom sound example: Custom sound example: * Custom sound example: * Custom sound example: `iamusic:music_disc.mozart` *(Example of a custom sound provided by ItemsAdder or a resource pack)*

Create and Manage Regions

* `/player set <name> <sound> [message]` Create a region with a name, sound, and an optional enter message.

* Example: `/player set spawn_area entity.player.levelup &6Welcome to spawn!`

* Long sounds or music discs need delay to match duration Change how a region plays its sound. * Long sounds or music discs need delay to match duration

* Example: `ON_ENTER`, `LOOP`, `INTERVAL` * Example: `/player setmode spawn_area LOOP <ticks>`

* `/player play <name>` Activate the region.

* Example: `/player play spawn_area`

* `/player stop <name>` Deactivate the region.

* Example: `/player stop spawn_area`

* `/player remove <name>` Delete the region permanently.

* Example: `/player remove spawn_area`

Player Controls

* `/player toggle` Enable or disable region sounds for yourself.

* Useful for players who prefer silence in hubs or busy areas.

Plugin Management

* `/player reload` Reloads the plugin’s configuration and region data.

* Example: `/player reload`

How It Works

1. Manage: Use `/player pos1` and `/player pos2` to set corners. 2. Manage: Use `/player set <name> <sound> [message]` to save it. 3. Manage: Use `/player setmode` to control how the sound plays. 4. Manage: Use `/player play <name>` to enable the region. 5. Manage: Use `/player stop` to deactivate or `/player remove` to delete.

Configuration

* `regions.yml` Stores region bounds, sounds, messages, playback mode, volume, pitch, and loop timing.

* `active_regions.yml` Tracks which regions are active across restarts.

Compatibility

* Dependencies: 1.21+ * Dependencies: None

Enjoy creating immersive soundscapes on your server with SoundPlayer.

---