Wavetrack

**WaveTrack Plugin** ***Open-source project for the AsianF4rmer Network and DataThorn Technologies family.*** A Spigot/Bukkit plugin for Minecraft 1.8 that allows developers to play preconfigured sound tracks to players using a single command instead of multiple `/playsound` commands. **Features** - **Track-based Sound System**: Create reusable sound tracks with multiple sounds - **Delay Support**: Add delays between sounds in a track (measured in ticks, 20 ticks = 1 second) - **Nearby Player Support**: Optionally play sounds to nearby players at a reduced volume - **Category Organization**: Organize tracks into categories for better management - **In-game Configuration**: Create and edit tracks using commands without editing config files - **YAML Configuration**: All tracks are saved to `config.yml` for easy manual editing - **Tab Completion**: Full tab completion support with common Minecraft 1.8 sounds - **Permission System**: Granular permissions for different command actions **Commands** All commands start with `/wavetrack` (alias: `/wt`) **Playing Tracks** ``` /wavetrack play <trackname> <player> ``` Plays a track to the specified player. If the track has `nearby-players` enabled, nearby players will also hear the sounds at a reduced volume. **Creating Tracks** ``` /wavetrack create <trackname> <category> ``` Creates a new empty track in the specified category. **Deleting Tracks** ``` /wavetrack delete <trackname> ``` Permanently deletes a track. **Adding Sounds** ``` /wavetrack addsound <trackname> <sound> ``` Adds a sound to a track. - `sound`: The Minecraft sound name (e.g., `random.levelup`, `mob.villager.yes`) - `volume`: Sound volume (default: 1.0) - `pitch`: Sound pitch (default: 1.0) - `delay`: Delay in ticks before playing this sound (default: 0) **Removing Sounds** ``` /wavetrack removesound <trackname> <index> ``` Removes a sound from a track by its index. Use `/wavetrack info <trackname>` to see indices. **Editing Sounds** ``` /wavetrack editsound <trackname> <index> <property> <value> ``` Edit a specific property of an existing sound in a track. - `index`: The sound index (use `/wavetrack info` to see indices) - `property`: One of `sound`, `volume`, `pitch`, `delay` - `value`: The new value for the property **Examples:** ``` /wavetrack editsound mytrack 0 volume 0.5 /wavetrack editsound mytrack 1 sound random.levelup /wavetrack editsound mytrack 2 delay 20 ``` **Clearing All Sounds** ``` /wavetrack clearsounds <trackname> ``` Removes all sounds from a track (keeps track settings). **Renaming Tracks** ``` /wavetrack rename <trackname> <newname> ``` Renames an existing track. **Copying Tracks** ``` /wavetrack copy <trackname> <newname> ``` Creates a copy of a track with a new name. Optionally place it in a different category. **Moving Tracks to a Different Category** ``` /wavetrack move <trackname> <newcategory> ``` Moves a track to a different category. **Configuring Nearby Players** ``` /wavetrack setnearby <trackname> <true/false> ``` Enable or disable playing the track to nearby players. ``` /wavetrack setradius <trackname> <radius> ``` Set the radius (in blocks) for nearby player detection. ``` /wavetrack setvolumemultiplier <trackname> <multiplier> ``` Set the volume multiplier for nearby players (0.0 to 1.0). **Viewing Track Info** ``` /wavetrack info <trackname> ``` Shows detailed information about a track including all sounds and settings. **Listing Tracks** ``` /wavetrack list ``` Lists all tracks, optionally filtered by category. **Reloading Configuration** ``` /wavetrack reload ``` Reloads the configuration file without restarting the server. **Permissions** | Permission | Description | Default | |------------|-------------|---------| | `wavetrack.*` | All WaveTrack permissions | op | | `wavetrack.play` | Play tracks to players | op | | `wavetrack.create` | Create new tracks | op | | `wavetrack.edit` | Edit existing tracks (add/remove sounds, change settings) | op | | `wavetrack.delete` | Delete tracks | op | | `wavetrack.list` | List tracks and view track info | op | | `wavetrack.reload` | Reload plugin configuration | op | **Configuration** The plugin automatically generates a `config.yml` file with example tracks: ```yaml **Default settings for sounds (used when not specified)** defaults: volume: 1.0 pitch: 1.0 delay: 0 nearby-players: false nearby-radius: 10 nearby-volume-multiplier: 0.5 **Tracks organized by category** tracks: examples: level-up: nearby-players: true nearby-radius: 15 nearby-volume-multiplier: 0.4 sounds: - sound: random.levelup volume: 1.0 pitch: 1.0 delay: 0 - sound: random.orb volume: 0.8 pitch: 1.2 delay: 5 rare-drop: nearby-players: true nearby-radius: 20 nearby-volume-multiplier: 0.3 sounds: - sound: random.levelup