🌟 Join Our Discord for Early Access & Free Plugins! 🎮

Join our Discord Server 🔗 for priority access to texture packs and plugin updates before they release on Modrinth and Spigot! 🚀

---

⚔️ Astral Swords v1.2.12 — Stability Update! 🛠️

Warriors, v1.2.12 is here with critical bug fixes and console spam elimination! This update focuses on stability and includes some Eclipse Blade improvements. 🚀 No more annoying error messages flooding your server logs — just smooth, reliable sword action! Full details below!

---

✨ What's New in v1.2.12 ✨

🛠️ Critical Hotfix

• fix: 🛡️ FIXED NULLPOINTEREXCEPTION CRASH - Resolved server crashes when attacking with Astral Swords

• fix: 🔍 Added debug logging - Better error tracking for sword name matching issues

• fix: 🚨 FIXED CONSOLE SPAM - Eliminated "Plugin cannot be null" error flooding server console

• fix: 🛠️ Corrected MaceEffectListener scheduler - Fixed plugin reference causing EntityDamageEvent errors

• refactor: 🌘 Enhanced Eclipse Blade invisibility - Invisibility now persists across item switches until ability ends

• fix: 🔄 Improved invisibility logic - Simplified item switching behavior for Eclipse Blade ability

• fix: ⏰ FIXED Eclipse Blade infinite invisibility exploit - Dropping and picking up the sword now properly respects the 90-second timer

• fix: 🧹 Code cleanup - Removed unused imports and optimized listener performance

• fix: 📊 Enhanced error handling - Better scheduler validation and null-pointer prevention

• feat: 🎯 Improved stability - No more console errors during fall damage events

• fix: ⚡ Performance boost - Eliminated unnecessary error processing overhead

Previous v1.2.11 Features Still Included:

• feat: ➕ Reduced Warden's Oath ability cooldown from 75s to 25s for faster-paced action!
• feat: 🖼️ Added continuous sword effects system - holding certain swords now grants permanent passive effects
• feat: 🔄 Implemented automatic fire resistance for Phoenix Talon and speed for Windblade while held
• fix: 🛡️ Fixed cooldown timers - they now work properly across all abilities

---

✨ New Features & Improvements ✨

🔹 Custom Trigger System – Set your own keybind to activate abilities (must already be binded in MC)🔑 🔹 Config Overhaul – Full control over recipes & enchants 🔹 Sword Tracking 2.0 – No more duplicate swords! 🔒 🔹 Global Crafting Announcements – Let the world know a sword has emerged (without exposing the crafter!) 🌍 🔹 Sword Selection GUI – Deciding between two swords? Choose easily via a sleek chat popup menu 🪄 🔹 Disable containers - Swords Can't be put into any container except anvils

---

🌟 New Sword Types

Each sword now has a unique playstyle type:

• DUELIST - Focused on one-on-one combat and skilled swordplay
• INITIATOR - Excels at starting fights and creating opportunities
• CONTROLLER - Masters of crowd control and battlefield manipulation
• SENTINEL - Defensive playstyle with sustain and protective abilities

---

🌈 Visual Effects & Feedback

• Custom Particles: Each sword has its own stunning visuals when activated! ✨
  • Eclipse Blade → Dark Aura ☁️
  • Phoenix Talon → Fiery Sparks 🔥
  • Windblade → Swift Cloud Trails 🌬️
• Lightning Flashes: Certain swords like Thunderstrike cause real in-game lightning ⚡
• Global Announcements: When a sword is crafted, everyone gets notified — but without revealing who made it 😉

---

🔥 Sword Abilities

Activate with F or your off-hand key (configurable)!
Each sword has a unique ability, including:

• 🌌 Skyfall Blade: Launch into the air & create an explosion
• 🐉 Dragon's Wrath: Dragon breath attack
• 🗡 Shadowbane: Apply weakness to nearby enemies
• ⚡ Thunderstrike: Call down thunder
• ☠️ Venom Edge: Poison your foes
• 🌘 Eclipse Blade: Blind others & turn invisible (persists across item switches!)
• ❤️ Soul Reaver: Heal by absorbing souls
• 🔥 Phoenix Talon: Shoot fireballs
• 🌊 Warden's Oath: Sonic boom explosion
• 🌪️ NEW! Windblade: Dash forward with the force of a storm
• 💥 NEW! Power House Sword: Ground slam & send enemies flying with sheer force!

---

🌟 Continuous Sword Effects

When certain swords are held in your hand, you gain special passive effects:

• 🔥 Phoenix Talon: Grants permanent Fire Resistance while the sword is held
• 🌪️ Windblade: Grants permanent Speed II while the sword is held

🧪 New Crafting Recipes & GUI

• 🌪 Windblade Recipe available in-game!
• 🧱 Power House Recipe available in-game!
• Use /aswords craftable or /aswords recipes to view all current recipes in a clean GUI format!

---

🧰 New Admin & Player Commands

• /aswords recipes – View available sword recipes
• /aswords give materials – Admins can give custom items
• /aswords trigger – Change your sword activation key!
• /aswords reload – Reload the config without restarting
• /aswords update check - Checks & Installs updates without having to go on Modrinths or Spigot!
• /aswords swordannouncemnts - To enable or disable sword crafting announcements
• /aswords craftable - View which legendary blades are still unclaimed
• /aswords announceplayername - To enable or disable the announcing of names in the sword crafting announcements

---

✅ Critical Fixes in v1.2.12

• �️* MAJOR: Fixed NullPointerException crash - Eliminated server crashes during EntityDamageByEntityEvent when using celestial swords
• 🔍 Added debug logging - Better tracking of sword name matching for troubleshooting
• 🚨 MAJOR: Fixed console spam - Eliminated "Plugin cannot be null" errors that flooded server logs
• 🛠️ Fixed MaceEffectListener - Corrected plugin reference in scheduler causing EntityDamageEvent crashes
• 🌘 Enhanced Eclipse Blade - Invisibility now persists when switching items until ability duration ends
• 🔄 Improved invisibility mechanics - Simplified logic prevents premature invisibility removal
• ⏰ Fixed Eclipse Blade timer exploit - No more infinite invisibility when dropping and picking up the sword
• 🧹 Code optce improvement - Eliminated error processing overhead for smoother gameplay

Previous v1.2.11 Fixes Still Active:

• 🌪 Windblade properly grants Speed II when held and removes it when unequipped
• 🔥 Phoenix Talon properly removes Fire Resistance when dropped or unequipped
• 🫥 Eclipse Blade proper invisibility state management
• ⏰ Eclipse Blade timer exploit completely patched
• ⏱ All cooldown timers work consistently
• 🌊 Venom Edge applies both Poison II and Slowness I to nearby enemies

---

🔮 Coming Soon

• 🔊 Immersive Sword Sounds (like dragon roars and thunder cracks)
• 📦 Custom Sound Pack for even more immersive vibes!

---

🧠 How to Install

1. Download v1.2.12 from Modrinth or Spigot
2. Drop the .jar file into your server's plugins folder
3. Restart your server (recommended) or use /reload
4. Enjoy spam-free console logs! 🎉
5. Begin your legendary sword-forging journey! 🌌⚔️

Requirements: Paper 1.21+ (Java 21+ recommended)
⚠️ IMPORTANT: Update to v1.2.12 to prevent server crashes and console spam!

---

🎯 Why Update to v1.2.12?

If you're experiencing server crashes with errors like:

Could not pass event EntityDamageByEntityEvent to AstralSwords v1.2.11
java.lang.NullPointerException: Cannot invoke "com.celestialswords.models.CelestialSword.ordinal()" because the return value of "com.celestialswords.models.CelestialSword.getByName(String)" is null

v1.2.12 completely fixes this crash! Your server will run smoothly without unexpected crashes during combat.

💬 Got suggestions or found a bug?
Jump into #『💡』suggestions or #『🐛』bug-reports on Discord and let me know!
Let's keep making this plugin better — together!

Happy crafting, legends! 🗡️🔥🌠

☕ Support Me on Ko-fi

If you like my work, consider buying me a coffee: