DiscSwordPlugin

DiscSwordPlugin turns every Minecraft music disc into a custom weapon with unique abilities, complete with crafting recipes, model data support, a GUI selector, and a fully-featured Guardian Wolf companion system. Designed for SMPs, RPG servers, PvP, and custom content-creator worlds.

Features

Custom Disc Swords for all vanilla music discs
Right-click abilities (movement, combat, utility, effects)
Custom model data per disc sword (config-driven)
Survival-friendly crafting recipes
GUI Disc Sword Selector menu
Guardian Wolf system: summon, modes, stats, recall, auto-teleport
Automatic config patching to prevent missing sections
Player data saved in players.yml
Admin commands, debug info, and cooldown bypass permissions

Abilities

Each disc sword has its own power, such as:

Lightning Dash
Wind Dash
Barrier Shield
Freeze Pulse
Void Rift Implosion
Nether Flames
Damage Immunity
Sonic Boom
Lifesteal
Teleport to mobs
Launch enemies
Invert breathing
Water Empowered Strike
Guardian Wolf summon
Many more depending on disc type

All abilities are implemented internally and work out of the box.

Crafting

Every Disc Sword can be crafted in survival using:

 D 
NJN
 S

D = music disc J = jukebox N = netherite ingot S = diamond sword

No mods or external items required.

Commands

Player

/discsword wolf – Wolf menu
/discsword wolf mode <agg|def> – Change wolf behavior
/discsword wolf recall – Teleport wolf
/discsword autotpswitch – Toggle wolf auto-teleport

Admin

/discsword help
/discsword list
/discsword give <player> <disc>
/discsword getall
/discsword debug [player]
/discsword reload
/discsword menu – Open selector GUI

Permissions

discsword.player
discsword.admin
discsword.cooldown.bypass

Admins automatically bypass ability cooldowns.

Configuration

All disc swords load custom model data from config.yml
Plugin patches missing sections automatically
Player/wolf data stored in players.yml

Ideal For

SMP progression
RPG servers
PvP ability combat
Creator SMPs
Servers with custom resource packs