Mystic Weapons - Next Level Combat v1.9.2

• Active abilities can target players outside WorldGuard regions. An area without a PVP flag is no longer incorrectly treated as protected.
• Elven Dagger clones attack valid player targets. Shadow clones now select and damage players when PvP is enabled. This fix also covers Elven Sword, Gravity Bow, Storm Breaker, Hook Blade, Phantom Blade, area attacks, and other active abilities.
• Elven Bow volley effects no longer disappear after impact. Tracking arrows keep their hit state until the delayed protection check finishes, so valid targets consistently receive the configured slowing and poison effects.
• WorldGuard protection remains enforced. Protected regions, PVP deny flags, memberships, owners, and region priorities are checked using WorldGuard's standard protection query.
• WorldGuard bypass works consistently. The configured MysticWeapons bypass permission and WorldGuard's active region bypass are both respected.
• Temporary block abilities follow normal build access. Web Bow, Freeze Bow, and Trap Sword can modify blocks where the player may build and remain blocked in protected areas.
• Server PvP settings remain enforced. Worlds with PvP disabled and players protected by PvPManager cannot be affected by custom weapon attacks.

Stop the server, replace the old JAR, and start the server normally.

Existing configuration files, language files, and weapon items remain compatible. No configuration changes are required.

Do not use /reload. A full restart is required to register the updated combat checks.

• Weapon effects work on players again. Fixed a 1.9 regression that allowed normal damage but stopped combo counters, passive effects, and other weapon abilities from activating against players.
• PvPManager checks now match real combat events. Accepted melee and arrow hits are no longer rejected by a second protection check. PvP toggle, newbie protection, WorldGuard regions, and PvPManager world exclusions are still respected.
• Arrow effects wait for the final damage result. Freeze, mark, silence, lightning, web, explosive, teleport, and Elven Bow effects only activate after protection plugins accept the hit.
• Piercing arrows check every player separately. Permission from one valid target can no longer carry over to another protected player hit by the same arrow.
• Counter attacks use the correct PvP direction. Parry Blade counters and Tether Blade retaliation now check whether the defender is allowed to affect the original attacker.

• Crystal Blade counts True Strike hits correctly. The counter now drops from 3 to 0 when hitting players. Expired and completed activations are removed, and the state resets after death or leaving the server.
• Phantom Blade combos work against players. Valid player hits now build stacks and receive the combo damage bonus. Expired stacks cannot be used by the finisher, and stacks reset after death or leaving the server.
• Gravity Bow works on valid player targets. Players with PvP enabled can be pulled or pushed normally while protected players remain unaffected.
• Other on-hit weapons use the same fixed combat handling. The correction also covers Aetherius Blade, Executioner, Storm Breaker, Shield Bash, Shadow Sword, Poison Dagger, Phase Dagger, Wound Dagger, and the passive sword effects.
• Delayed attacks recheck protection at impact. Elven Dagger clones and Wound Dagger bleeding stop affecting a player who disables PvP or enters a protected region before the next hit.

• Players can no longer place items on shadow clones. Every armor and hand slot is locked, and all armor stand manipulation events are blocked.
• Shadow clones cannot be broken or used as storage. Clones are invulnerable, non-collidable, unable to pick up items, and are never saved with the world.
• Clone cleanup remains automatic. Temporary armor stands are removed after their attack and when the plugin shuts down.

Replace the old JAR with the new one while the server is stopped, then start the server normally.

Existing config.yml, weapon files, language files, and items are compatible. No configuration changes are required.

Do not use /reload to install the update. A full server restart ensures that all combat listeners and integrations are registered in the correct order.

• Explosive Bow no longer crashes the server. Fixed an x not finite error on Paper 1.21 when knockback hit entities at the edge of the blast. Detonations are safe again.
• Deep Cut and Gaping Wound no longer last forever. Deep Cut no longer refreshes while already active. Gaping Wound hit extensions are hard-capped (max-duration in daggers.yml).
• Mark Bow mark extensions are capped. Repeated hits can still extend the mark, but only up to max-duration in bows.yml.
• Safer knockback and tracking. Gravity Bow, Hook Blade, Shadow Sword, Aetherius Blade, and Elven Bow no longer risk NaN velocities or broken arrow speed after tracking.

• PvPManager support. Abilities now respect PvP toggle, newbie protection, and related rules when PvPManager is installed. Enable with integrations.pvpmanager.enabled: true in config.yml.
• WorldGuard + PvPManager share one combat check. Player-vs-player ability hits go through both systems, so protected players stay protected.
• More weapons respect no-PvP correctly. Includes Aetherius empowerment/runes, Shadow Sword smoke bomb, Tether Blade roots, Elven Bow arrow damage, and other passives that previously slipped through.

• Freeze Bow and Gravity Bow. Cooldown only starts when something is actually affected. Empty block hits / no targets nearby no longer burn the cooldown.
• Shadow Sword miss no longer sets cooldown. Missing the smoke bomb ray trace does not put the ability on cooldown.
• Executioner cleans up on death and quit. Charge state is cleared properly so it cannot stick after dying or leaving.
• Shield Bash, Item Stealer, and passive swords. Shield lock uses a real shield cooldown. Item Stealer takes 1 item per slot by default. Speed / Hunger / Energy / Potion passives have their own short cooldown so they do not fire every swing.
• Null Bow silence and Mark Bow amplify. Silence blocks item use correctly. Mark amplifies damage from all sources while active.

• CustomModelData defaults to 0. Weapons use the normal vanilla look out of the box. No resource pack required. Set a CMD value in the weapon YAML if you use a custom pack.
• Weapon names are consistent. Phantom Blade and Parry Blade no longer use bold names. All weapons use the same plain colored name style.
• Clearer Gravity Bow feedback. When nothing is in range, the message explains that Gravity Bow pulls/pushes and does not shoot arrows.

Replace the JAR. Existing configs keep working.

Recommended: update weapons/*.yml from the JAR (or delete those files once so they regenerate) to get custom-model- 0, max-duration for Wound/Mark, and passive-cooldown keys.

Add this to config.yml if missing:

integrations:
  pvpmanager:
    enabled: true

Old items already in inventories keep their old CustomModelData. Give fresh items with /mw give after updating.

• Supports Paper 1.21 and newer. The plugin now runs on every Paper version from 1.21 all the way up to the newest releases (26.1 / 26.2). Whether your server is old or freshly updated, it just works.
• Sound effects keep working. Fixed sound handling that newer Paper versions were starting to remove, so all weapon sounds play correctly on every version.

• Thief Sword and Item Stealer protection now actually works. Players with mysticweapons.thief.protected or mysticweapons.stealer.protected are now truly protected from being robbed. Before, these permissions were advertised but did nothing - that is fixed.
• Trap Sword respects protection. Trap Sword can no longer steal armor or totems from protected players. Grant mysticweapons.stealer.protected to stop item and armor theft completely.
• Storm Breaker no longer triggers raids. The "Cursed" effect no longer applies Bad Omen, which could accidentally start a raid when the victim walked into a village.

• Fixed issues when the plugin is disabled or reloaded. Shadow Sword no longer leaves players invisible with a hidden name tag, and Elven Dagger no longer leaves invisible armor stands behind after a plugin reload.
• One background thread instead of many. All background tasks now share a single thread, which is easier on the server and smoother on busy networks.
• Internal cleanup. Removed duplicated and unused code, which makes the plugin faster to load and much easier to keep bug-free in the future.

• Particle toggle now works. Set weapons.particles.enabled: false in config.yml to turn particles off. This setting was listed before but did nothing - now it works.
• Friendlier /mw give. You now get clear messages when a weapon is disabled or when the target player is offline.
• Aetherius combo counter can be turned off. Set abilities.empowerment.show-progress: false in swords.yml to stop the "Combo: x/y" message from showing on every hit.
• Better cooldown handling. Setting a cooldown to 0 or a negative value now correctly disables it instead of misbehaving.

Your existing config.yml, swords.yml, bows.yml, and daggers.yml files are fully compatible. No configuration migration required.

If you want the updated language messages, delete the lang folder inside the plugin folder once (it will regenerate), or set language.force-update: true in config.yml and reload.

Protection permissions changed: the documented mysticweapons.thief.protected and mysticweapons.stealer.protected permissions now actually protect players. The old mysticweapons.theft.exempt permission still works for compatibility, but the new permissions are the recommended way to protect your players.

• New anti-cheat integration. Grim, Vulcan, Matrix, Themis, NoCheatPlus, Spartan, AntiAura and Wraith are now supported. The plugin temporarily exempts players from movement and combat checks while they use weapons, which stops false flags from fast abilities and teleports.
• Fully configurable. Enable anti-cheat.bypass-movement-checks and anti-cheat.bypass-combat-checks in config.yml. You can add custom bypass permissions for any other anti-cheat through the extra lists.
• Staff notifications. Players with the mysticweapons.staff permission get notified when someone uses a bypass, so you can keep an eye on everything.

• Repair Sword Repairs now cost money when Vault is installed. Set cost-per-point for self and ally repair in swords.yml. Players without enough money get a clear message.
• Vampire Sword Blood Rage now gives a real percentage damage boost instead of a Strength potion.
• Aetherius Blade Void Strike stops at walls, works when looking straight up or down, and empowerment settings (hits-required, timeout, duration) now come from swords.yml.
• Elven Dagger Clone Strike damage boost now actually applies. Configure it with damage-boost and damage-boost-duration in daggers.yml.
• Tether Blade Knockback resistance now scales the real knockback instead of acting as full immunity. The value comes from swords.yml.
• Web Bow Webs now restore the original block when removed, and the replace list only replaces configured blocks.
• Freeze Bow The area slowness amplifier is now configurable in bows.yml.
• Lightning Bow Lightning no longer strikes players in protected no-PvP zones.
• Cooldowns on failed use Elven Dagger, Hook Blade, Wound Dagger, Shield Bash, Phase Dagger, Shadow Sword and Trap Sword now set a cooldown even when there is no target. They can no longer be spammed.
• Thief Sword and Item Stealer The protection exemption permission now comes from swords.yml and can be configured per weapon.
• Disabled weapons Setting enabled: false in a weapon config now fully disables that weapon, including passive abilities. Players get a clear "weapon disabled" message.

• Fixed all message placeholders. No more messages showing raw text like {player} or {ability}. Weapon names now appear correctly in WorldGuard block messages.
• Weapon and rune names are localized. Polish servers now see Polish weapon and rune names, English servers see English. Names are managed in the language files.
• Cleaner language files. Removed unused keys and emoji, fixed duplicate and missing keys. New keys are added automatically when the plugin updates.

Your existing config.yml, swords.yml, bows.yml, and daggers.yml files are fully compatible. No configuration migration required.

To get the updated language files, delete the lang folder inside the plugin folder once (it will regenerate), or set language.force-update: true in config.yml and reload. New keys are added automatically, but cleaned messages need the folder refresh to appear.

Anti-cheat support is off by default. If you use Grim, Vulcan, Matrix or another supported anti-cheat, set anti-cheat.bypass-movement-checks and anti-cheat.bypass-combat-checks to true in config.yml.

• Weapons work everywhere again. Many weapons only worked at spawn and were blocked in the overworld. Teleport and shooting abilities are no longer blocked by WorldGuard building restrictions.
• WorldGuard bypass permission now works. The mysticweapons.worldguard.bypass permission is now fully functional. Grant it to players who should use weapons in every region.
• Protection is still respected. Combat abilities still follow no-PvP zones. Web Bow, Freeze Bow, and Trap Sword still follow build protection.

• Elven Bow Slow and poison effects now apply when arrows hit enemies. Custom values from bows.yml now work.
• Executioner Cooldown now applies even when the charged strike misses. You can no longer start multiple charges at once.
• Speed Sword and Energy Sword Boost settings from swords.yml now actually apply. Edits were ignored before.
• Aetherius Blade Empowerment damage from swords.yml now applies correctly.
• Freeze Bow and Web Bow Fixed a missing cooldown message. Players no longer see "Missing message" errors.
• Tether Blade Iron Roots knockback resistance now works. A rooted player no longer gets knocked back.
• Phantom Blade The finisher no longer damages players in protected areas where PvP is disabled.
• Item Stealer Cooldown now applies when your inventory is full, so it can no longer be spammed.

• Fixed background crashes. Trap Sword and Poison Dagger effects no longer run on the wrong thread, which could cause console errors or lag.
• Wound Dagger Fixed a crash risk when custom bleed settings were set too low in daggers.yml.

Your existing config.yml, swords.yml, bows.yml, and daggers.yml files are fully compatible. No configuration migration required.

WorldGuard settings from config.yml are read on every reload, so no extra steps are needed after the update.

Your server deserves better combat.