Wavetrack

Open-source project for the AsianF4rmer Network and DataThorn Technologies family. *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

- Permission System: Create reusable sound tracks with multiple sounds - Permission System: Add delays between sounds in a track (measured in ticks, 20 ticks = 1 second) - Permission System: Optionally play sounds to nearby players at a reduced volume - Permission System: Organize tracks into categories for better management - Permission System: Create and edit tracks using commands without editing config files - Permission System: All tracks are saved to `config.yml` for easy manual editing - Permission System: 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> [volume] [pitch] [delay] ``` 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> [newcategory] ``` 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 [category] ``` 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 volume: 1.0 pitch: 0.8 delay: 0 - sound: fireworks.blast volume: 1.0 pitch: 1.0 delay: 5 - sound: fireworks.twinkle volume: 0.8 pitch: 1.2 delay: 15 ```

Minecraft 1.8 Sound Reference

Below is a complete list of all available sounds in Minecraft 1.8. Use these exact names when adding sounds to tracks.

Ambient - `ambient.cave.cave` - Cave ambient sounds - `ambient.weather.rain` - Rain sound - `ambient.weather.thunder` - Thunder sound

Damage - `damage.fallbig` - Large fall damage - `damage.fallsmall` - Small fall damage - `damage.hit` - Hit sound - `damage.hurtflesh` - Flesh hurt sound

Dig (Block Breaking) - `dig.cloth` - Breaking cloth/wool - `dig.glass` - Breaking glass - `dig.grass` - Breaking grass - `dig.gravel` - Breaking gravel - `dig.sand` - Breaking sand - `dig.snow` - Breaking snow - `dig.stone` - Breaking stone - `dig.wood` - Breaking wood

Fire - `fire.fire` - Fire burning - `fire.ignite` - Ignite/flint and steel

*Fireworks* - `fireworks.blast` - Firework explosion - `fireworks.blast_far` - Distant firework explosion - `fireworks.largeBlast` - Large firework explosion - `fireworks.largeBlast_far` - Distant large firework explosion - `fireworks.launch` - Firework launch - `fireworks.twinkle` - Firework twinkle - `fireworks.twinkle_far` - Distant firework twinkle

*Liquid* - `liquid.lava` - Lava ambient - `liquid.lavapop` - Lava pop - `liquid.splash` - Splash sound - `liquid.swim` - Swimming - `liquid.water` - Water ambient

*Minecart* - `minecart.base` - Minecart rolling - `minecart.inside` - Inside minecart

*Zombie Pigman* | Category | Sounds | |----------|--------| | Zombie Pigman | `mob.bat.death`, `mob.bat.hurt`, `mob.bat.idle`, `mob.bat.loop`, `mob.bat.takeoff` | | Zombie Pigman | `mob.blaze.breathe`, `mob.blaze.death`, `mob.blaze.hit` | | Zombie Pigman | `mob.cat.hiss`, `mob.cat.hitt`, `mob.cat.meow`, `mob.cat.purr`, `mob.cat.purreow` | | Zombie Pigman | `mob.chicken.hurt`, `mob.chicken.plop`, `mob.chicken.say`, `mob.chicken.step` | | Zombie Pigman | `mob.cow.hurt`, `mob.cow.say`, `mob.cow.step` | | Zombie Pigman | `mob.creeper.death`, `mob.creeper.say` | | Zombie Pigman | `mob.enderdragon.end`, `mob.enderdragon.growl`, `mob.enderdragon.hit`, `mob.enderdragon.wings` | | Zombie Pigman | `mob.endermen.death`, `mob.endermen.hit`, `mob.endermen.idle`, `mob.endermen.portal`, `mob.endermen.scream`, `mob.endermen.stare` | | Zombie Pigman | `mob.ghast.affectionate_scream`, `mob.ghast.charge`, `mob.ghast.death`, `mob.ghast.fireball`, `mob.ghast.moan`, `mob.ghast.scream` | | Zombie Pigman | `mob.guardian.attack`, `mob.guardian.curse`, `mob.guardian.death`, `mob.guardian.elder.death`, `mob.guardian.elder.hit`, `mob.guardian.elder.idle`, `mob.guardian.flop`, `mob.guardian.hit`, `mob.guardian.idle`, `mob.guardian.land.death`, `mob.guardian.land.hit`, `mob.guardian.land.idle` | | Zombie Pigman | `mob.horse.angry`, `mob.horse.armor`, `mob.horse.breathe`, `mob.horse.death`, `mob.horse.gallop`, `mob.horse.hit`, `mob.horse.idle`, `mob.horse.jump`, `mob.horse.land`, `mob.horse.leather`, `mob.horse.soft`, `mob.horse.wood` | | Zombie Pigman | `mob.horse.donkey.angry`, `mob.horse.donkey.death`, `mob.horse.donkey.hit`, `mob.horse.donkey.idle` | | Zombie Pigman | `mob.horse.skeleton.death`, `mob.horse.skeleton.hit`, `mob.horse.skeleton.idle` | | Zombie Pigman | `mob.horse.zombie.death`, `mob.horse.zombie.hit`, `mob.horse.zombie.idle` | | Zombie Pigman | `mob.irongolem.death`, `mob.irongolem.hit`, `mob.irongolem.throw`, `mob.irongolem.walk` | | Zombie Pigman | `mob.magmacube.big`, `mob.magmacube.jump`, `mob.magmacube.small` | | Zombie Pigman | `mob.pig.death`, `mob.pig.say`, `mob.pig.step` | | Zombie Pigman | `mob.rabbit.death`, `mob.rabbit.hurt`, `mob.rabbit.idle`, `mob.rabbit.hop` | | Zombie Pigman | `mob.sheep.say`, `mob.sheep.shear`, `mob.sheep.step` | | Zombie Pigman | `mob.silverfish.hit`, `mob.silverfish.kill`, `mob.silverfish.say`, `mob.silverfish.step` | | Zombie Pigman | `mob.skeleton.death`, `mob.skeleton.hurt`, `mob.skeleton.say`, `mob.skeleton.step` | | Zombie Pigman | `mob.slime.attack`, `mob.slime.big`, `mob.slime.small` | | Zombie Pigman | `mob.spider.death`, `mob.spider.say`, `mob.spider.step` | | Zombie Pigman | `mob.villager.death`, `mob.villager.haggle`, `mob.villager.hit`, `mob.villager.idle`, `mob.villager.no`, `mob.villager.yes` | | Zombie Pigman | `mob.wither.death`, `mob.wither.hurt`, `mob.wither.idle`, `mob.wither.shoot`, `mob.wither.spawn` | | Zombie Pigman | `mob.wolf.bark`, `mob.wolf.death`, `mob.wolf.growl`, `mob.wolf.howl`, `mob.wolf.hurt`, `mob.wolf.panting`, `mob.wolf.shake`, `mob.wolf.step`, `mob.wolf.whine` | | Zombie Pigman | `mob.zombie.death`, `mob.zombie.hurt`, `mob.zombie.infect`, `mob.zombie.metal`, `mob.zombie.remedy`, `mob.zombie.say`, `mob.zombie.step`, `mob.zombie.unfect`, `mob.zombie.wood`, `mob.zombie.woodbreak` | | Zombie Pigman | `mob.zombiepig.zpig`, `mob.zombiepig.zpigangry`, `mob.zombiepig.zpigdeath`, `mob.zombiepig.zpighurt` |

*Note Blocks* - `note.bass` - Bass note - `note.bassattack` - Bass attack - `note.bd` - Bass drum - `note.harp` - Harp note - `note.hat` - Hi-hat - `note.pling` - Pling note - `note.snare` - Snare drum

*Portal* - `portal.portal` - Portal ambient - `portal.travel` - Portal travel - `portal.trigger` - Portal activation

*Random* - `random.anvil_break` - Anvil break - `random.anvil_land` - Anvil land - `random.anvil_use` - Anvil use - `random.bow` - Bow shoot - `random.bowhit` - Arrow hit - `random.break` - Item break - `random.burp` - Burp - `random.chestclosed` - Chest close - `random.chestopen` - Chest open - `random.click` - Click - `random.door_close` - Door close - `random.door_open` - Door open - `random.drink` - Drinking - `random.eat` - Eating - `random.explode` - Explosion - `random.fizz` - Fizz/extinguish - `random.fuse` - TNT fuse - `random.glass` - Glass break - `random.levelup` - Level up - `random.orb` - Experience orb - `random.pop` - Item pop - `random.splash` - Splash - `random.successful_hit` - Successful hit - `random.toast` - Toast/achievement - `random.wood_click` - Wood click

*Records (Music Discs)* - `records.11`, `records.13`, `records.blocks`, `records.cat`, `records.chirp` - `records.far`, `records.mall`, `records.mellohi`, `records.stal`, `records.strad` - `records.wait`, `records.ward`

*Step (Walking)* - `step.cloth` - Walking on cloth/wool - `step.grass` - Walking on grass - `step.gravel` - Walking on gravel - `step.ladder` - Climbing ladder - `step.sand` - Walking on sand - `step.snow` - Walking on snow - `step.stone` - Walking on stone - `step.wood` - Walking on wood

Tile - `tile.piston.in` - Piston retract - `tile.piston.out` - Piston extend

Example Usage

*Creating a Victory Track* ``` /wavetrack create victory events /wavetrack addsound victory random.levelup 1.0 1.0 0 /wavetrack addsound victory fireworks.blast 1.0 1.2 10 /wavetrack addsound victory fireworks.twinkle 0.8 1.0 20 /wavetrack setnearby victory true /wavetrack setradius victory 25 /wavetrack setvolumemultiplier victory 0.3 ```

*Playing the Track* ``` /wavetrack play victory PlayerName ```

*Testing a Track on Yourself* ``` /wavetrack play victory YourName ```

*License*

This plugin is provided as-is for use on Minecraft servers by the DataThorn Technologies family. Modifications to the content of this plugin are prohibited. Attempts to profit from this plugin without granted permission from the DataThorn Technologies family or the AsianF4rmer Network will be answered with legal action.