MysticWeapons
33 Weapons. 4 Categories. Every Swing Tells a Story.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
33 Weapons ◆ 4 Weapon Types ◆ Vault + WorldGuard ◆ 2 Languages ◆ Paper 1.21
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What MysticWeapons Solves
Most weapon plugins give you a stat boost and call it a day. A sword is a sword. A bow is a bow. There is no reason to pick one over the other beyond the damage number.
MysticWeapons changes that. Every weapon in this plugin has its own unique active ability, passive mechanics, and special interactions. The Aetherius Blade dashes through enemies and applies random rune debuffs on kill. The Vampire Sword drains life and enters a blood rage. The Freeze Bow traps foes in ice prisons. The Elven Dagger creates shadow clones that confuse and poison your enemies.
These are not simple stat modifiers. They are complete combat identities.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
33 Weapons Across 4 Categories
Every weapon has three layers: Active Ability ◆ Passive Mechanic ◆ Special Interaction
Every value is tunable in dedicated YAML configuration files.
· · · SWORDS · · ·
33 Weapons Across 4 Categories
Every weapon has three layers: Active Ability ◆ Passive Mechanic ◆ Special Interaction
Every value is tunable in dedicated YAML configuration files.
· · · SWORDS · · ·
- Aetherius Blade Dash forward through enemies dealing 6 damage + knockback. Every 3 hits grants +2 bonus damage for 5s. Kills apply random debuffs (fire, freeze, poison, weakness).
- Trap Sword Shift-right-click places a web trap in a 5x5 area. Killing enemies has a chance to drop their totem or armor.
- Elven Sword Right-click performs a 12-block whirlwind dash dealing 7 damage and pulling enemies toward you. Poisons on hit.
- Thief Sword Steals 10% of target's money on hit (Vault required). 75% success rate. Configurable min/max steal amounts.
- Item Stealer Steals up to 2 items from enemy inventory on hit. 60% success rate. Respects protected slots and blacklisted items.
- Repair Sword Right-click restores 100 durability to your items. Hit allies to repair their armor. Both cost money via Vault.
- Hunger Sword Right-click restores your hunger to full. Hitting enemies drains their hunger and saturation, transferring it to you.
- Energy Sword Right-click grants Strength II, Regeneration, and Resistance for 5 seconds. Hitting enemies applies Weakness and Mining Fatigue.
- Speed Sword Right-click gives Speed III and Jump Boost II for 4 seconds. Hitting enemies slows them down.
- Potion Sword Right-click applies 2 random positive effects to you. Hitting enemies applies 2 random negative effects. Alchemical chaos.
- Vampire Sword Passive lifesteal heals 15% of damage dealt. Right-click enters Blood Rage for 50% bonus damage at the cost of half your HP. Kills trigger a blood explosion that heals nearby allies.
- Shadow Sword Right-click throws a smoke bomb granting invisibility and teleporting behind the nearest enemy. Attacking from behind deals 2x damage.
- Phantom Blade Each hit stacks +20% bonus damage (max 5 stacks). Stacks decay after 3s. Right-click consumes all stacks for an AoE burst dealing 2 damage per stack in a 5-block radius.
- Parry Blade Right-click enters Guardian Stance for 2 seconds. The next attack you receive is blocked and reflected back at 150% damage with knockback.
- Crystal Blade Right-click activates True Strike - next 3 hits deal +30% true damage that ignores armor. Passive: every 5th hit deals +2 true damage.
- Tether Blade Right-click grants 100% knockback resistance for 3s. Attackers become rooted for 1.5s. Passive: 25% chance to root target for 1s on hit.
- Hook Blade Right-click fires a chain hook (20 blocks) that pulls a single target to you, dealing 4 damage and slowing for 2s. Passive: +20% damage for 3s after a successful hook.
· · · PVP AXES · · ·
- Storm Breaker Right-click Purge removes all positive effects from nearby enemies and applies Cursed for 4s. Passive: 20% chance to remove 1 random buff on hit. Hard counter to potion spam.
- Executioner Right-click charges a heavy strike dealing bonus damage per missing HP. Below 30% HP the bonus is doubled. Passive: +1 damage per 10% missing target HP.
- Shield Bash Right-click shatters shields on impact + stuns the wielder. If no shield, deals 8 damage + Slowness III. Passive: 15% chance to lock shield use for 2s.
· · · BOWS · · ·
- Gravity Bow Right-click pulls all enemies within 8 blocks toward you. Left-click repels them with powerful knockback. Full gravity manipulation.
- Elven Bow Right-click fires a volley of 5 tracking arrows. Arrows home in on targets within 12 blocks. Applies slowness and poison on hit.
- Teleport Bow Shoot an arrow and instantly teleport to its impact point. Up to 50 blocks. Includes safe landing and void protection.
- Web Bow Arrows place sticky webs on impact in a 5x5 area for 6 seconds. Applies Slowness III. Webs restore original blocks after expiring.
- Freeze Bow Arrows freeze enemies with Slowness IV and Weakness. Critical hits (full draw + headshot) have a 30% chance to trap targets in an ice prison. Area freeze radius of 4 blocks.
- Lightning Bow Arrows summon lightning strikes dealing 6 damage. Chain lightning jumps to 3 nearby targets with 50% damage reduction per chain.
- Explosive Bow Arrows explode on contact dealing 8 damage in a 4-block radius. Ricochets off walls up to 2 times before detonating.
- Null Bow Arrows apply silence for 3s - target cannot use potions, pearls, shields, or weapon swap. Passive: 15% chance to silence for 0.5s on hit.
- Mark Bow Arrows mark the target for 6s. Marked targets take +25% damage from all sources and glow. Passive: hits on marked targets extend the mark duration.
· · · DAGGERS · · ·
- Elven Dagger Right-click summons 3 shadow clones that attack nearby targets within 10 blocks. Each clone deals 8 damage and applies blindness and poison.
- Poison Dagger Each hit stacks poison on the target (max 5 stacks). At max stacks triggers Wither II for 10 seconds. Right-click deploys a poison cloud that applies Poison II in a 4-block radius.
- Wound Dagger Right-click applies Gaping Wound for 5s - target cannot heal at all and bleeds for 1 true damage every 2s. Passive: 35% chance for Deep Cut reducing healing by 50% for 3s.
- Phase Dagger Right-click deals 5 true damage (ignores armor) and reduces healing by 75% for 4s. Passive: each hit deals 0.5 true damage through armor.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Systems
Core Systems
◆ Ability Engine
- Per-weapon cooldown system with action bar display
- Active skills triggered by right-click, left-click, or shift combinations
- Passive mechanics process automatically (combos, stacks, lifesteal, etc.)
- All abilities respect WorldGuard PVP and build flags
◆ Item System
- Custom model data for unique visual identity on every weapon
- Rich lore display showing all abilities and mechanics
- Per-weapon permission nodes (mysticweapons.weapon.<name>)
- Admin bypass permission covers all restrictions
◆ Data Storage
- YAML configuration per weapon category (swords.yml, bows.yml, daggers.yml)
- Every value exposed: damage, cooldowns, durations, radii, chances
- Full reload support via /mw reload - no server restart needed
◆ Third-Party Integrations
- WorldGuard: region-based ability blocking, PVP and build flag checks
- Vault: economic weapons (Thief Sword, Repair Sword, Item Stealer)
- Anti-Cheat: configurable bypass for teleport, movement, and combat abilities
- Staff notifications when anti-cheat bypass is triggered
◆ Multi-Language Support
- 2 built-in languages: English and Polish
- All messages fully configurable with hex color support
- Force-update from JAR for seamless plugin upgrades
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How MysticWeapons Compares
How MysticWeapons Compares
| Feature | MysticWeapons | Typical Weapon Plugin |
| Weapon mechanics | 33 unique active + passive systems | Stat multipliers or generic enchantments |
| Combat depth | Stack mechanics, combos, stance switching, counters | Damage + speed modifiers only |
| Ability variety | Dashes, teleports, lifesteal, clones, gravity, explosions, freezing, lightning, poison, parrying | None or a single click effect |
| Integrations | WorldGuard, Vault, anti-cheat bypass | None or bare-minimum |
| Configuration | Dedicated YAML per weapon category, every value exposed | Single config.yml with a handful of options |
| Multi-language | 2 languages, full message customization | Hardcoded English messages |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Who This Is For
Who This Is For
- PvP servers Adds real weapon variety. From parry-based counter-play to shadow-step backstabs, every fight plays differently depending on what weapon your opponent is holding.
- Survival and SMP Gives rare weapon finds real weight. Finding a Vampire Sword in a dungeon chest or crafting an Aetherius Blade becomes a memorable event.
- RPG and adventure servers Build character classes around weapon choice. The per-weapon permission system makes it easy to gate weapons by progression or rank.
- Kit PvP and arenas Each weapon is a complete kit. Give players different weapons and let them discover counters, synergies, and favorites.
- Network owners Drop into any Paper 1.21 server. Single-command install with /mw reload for live config changes. No restarts needed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Technical Specs
Technical Specs
| Server | Paper 1.21, Java 21 |
| Dependencies | None required. WorldGuard and Vault are optional soft dependencies. |
| Storage | YAML flat-file per weapon category |
| Languages | en_US, pl_PL |
| Weapon count | 33 weapons: 17 swords, 3 axes, 9 bows, 4 daggers |
◆ Commands
| Command | Description | Permission |
| /mw give <player> <weapon> | Gives a weapon directly to the specified player | mysticweapons.admin |
| /mw reload | Reloads config, language, and all weapon YAML files live | mysticweapons.admin |
◆ Permissions
| Permission | Description | Default |
| mysticweapons.use | Allows a player to use weapon active abilities | true |
| mysticweapons.admin | Access to /mw command (give, reload) | op |
| mysticweapons.weapon.<name> | Permission to use a specific weapon | true |
| mysticweapons.bypass | Bypasses all weapon restrictions | false |
| mysticweapons.thief.protected | Protection from Thief Sword money theft | false |
| mysticweapons.stealer.protected | Protection from Item Stealer item theft | false |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get MysticWeapons
Your players are ready for weapons that do more than deal damage. Every swing, every right-click, every kill should feel meaningful.
Choose the weapon. Master the mechanics. Dominate the fight.
33 unique weapons. Four categories. One plugin.
Download and have it running in under 5 minutes.
Questions? Contact bishyy on GitHub. Feature requests are welcome.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get MysticWeapons
Your players are ready for weapons that do more than deal damage. Every swing, every right-click, every kill should feel meaningful.
Choose the weapon. Master the mechanics. Dominate the fight.
33 unique weapons. Four categories. One plugin.
Download and have it running in under 5 minutes.
Questions? Contact bishyy on GitHub. Feature requests are welcome.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
