Skip to content

Astral Swords (Freemium) — Compatibility & Troubleshooting

Server requirements, compatibility info, and common issue fixes.

Server Requirements

Requirement Value
Minecraft Version 1.21.x
Java Version Java 21+
Server Software Paper / Purpur (recommended)
Memory Minimal additional RAM usage

Plugin Dependencies

  • No Required Dependencies — Plugin works fully standalone (no external dependencies)
  • Optional Integrations:
    • PlaceholderAPI (advanced message formatting)
    • WorldGuard (region-based restrictions)
    • Vault (economy integration)

FaithBreak Dependency Removed

As of v1.2.16, AstralSwords no longer requires or bundles FaithBreak. The plugin is entirely self-contained.

Known Compatibility

Status Details
✅ Works With Most popular plugins (WorldEdit, Essentials, etc.)
⚠️ Potential Conflicts Other weapon plugins that modify crafting
❌ Incompatible Plugins that completely override crafting mechanics

Troubleshooting

Swords Not Crafting

  1. Check if crafting is enabled: /aswords craftable
  2. Verify recipe materials match exactly
  3. Ensure player has crafting permissions

Abilities Not Working

  1. Check cooldown status (action bar shows remaining time)
  2. Verify trigger key is set correctly: /aswords trigger
  3. Ensure player has required permissions

Missing Visual Effects

  1. Check client-side particle settings
  2. Verify server performance (TPS)
  3. Update client to latest Minecraft version

Performance Optimization

  • Particle Limits — Effects are optimized for server performance
  • Cooldown Management — Prevents ability spam and server overload
  • Memory Usage — Plugin uses minimal server resources
  • Database-Free — No external database requirements

Version History

v1.2.16 (Current)

  • Replaced auto-update system with a one-time version reminder on startup (clickable Modrinth link)
  • Removed FaithBreak dependency — plugin is now fully standalone
  • Fixed Craftable GUI back button returning to wrong page
  • Fixed /aswords craftable being blocked when player already holds a sword
  • Renamed all "Celestial Sword" references to "Astral Sword" for consistency
  • Fixed Warden's Oath particle crash (missing Float parameter for SCULK_CHARGE)
  • Patched off-hand swap exploit allowing swords into containers via F key
  • Migrated from deprecated Bukkit APIs to modern alternatives

v1.2.12

  • Enhanced sword mechanics and performance optimization
  • Fixed cooldown timers across all abilities
  • Improved continuous effects system
  • Updated sword descriptions with detailed lore

v1.2.11

  • Reduced Warden's Oath cooldown from 75s to 25s
  • Added continuous sword effects system
  • Implemented automatic fire resistance for Phoenix Talon
  • Added speed effects for Windblade
  • Enhanced Eclipse Blade with proper invisibility management