Skip to content

Astral Swords — Compatibility & Troubleshooting

Server requirements, compatibility info, and common issue fixes.

Server Requirements

Requirement Value
Minecraft Version Paper 1.21+
Java Version Java 21 or higher
Server Software Paper (Spigot compatibility not guaranteed)
RAM Minimum 2GB allocated to server

Plugin Dependencies

  • FaithBreak — Required dependency, auto-downloaded from Modrinth on first startup (SHA-256 verified)
  • Optional Integrations:
    • PlaceholderAPI (enhanced message formatting)
    • WorldGuard (region-based restrictions)

Known Compatibility

Status Details
✅ Compatible Most economy, permission, and utility plugins
✅ Compatible Anti-cheat plugins (properly configured)
⚠️ Caution Plugins that modify crafting mechanics
❌ Conflicts Other weapon plugins that override vanilla swords

Troubleshooting

Swords Not Crafting

  1. Check if crafting is enabled: /as craft <sword_name> on
  2. Verify player has astral.craft permission
  3. Ensure all recipe materials are correct
  4. Check if player already owns that sword type
  5. Check if server-wide craft limit is reached: /as craft-limit off to disable

Abilities Not Working

  1. Check cooldown status (abilities have cooldown periods)
  2. Ensure player has the sword equipped in main hand
  3. Confirm ability isn't disabled in config
  4. For trust-related issues, check if target is trusted: /as untrust <player>

Ritual Mode Issues

  1. Check ritual mode is enabled: /as craft-mode ritual
  2. Verify no concurrent ritual limit reached
  3. Ensure crafting table placement is valid
  4. Check for area protection conflicts

SMP / Grace Period Issues

  1. Check SMP status: /as smp status
  2. View grace period status: /as graceperiod status
  3. Reload configurations: /as smp reload or /as graceperiod reload
  4. Reset SMP state: /as smp reset

Language Issues

  1. Language auto-detects on join based on client locale
  2. Manually set language: /as language <code> (e.g., en_US, es_ES)
  3. Sword names in inventory refresh automatically on language change

Performance Problems

  1. Reduce particle intensity in config
  2. Lower concurrent ritual limits
  3. Check for plugin conflicts
  4. Monitor server TPS during rituals

Error Messages

Message Meaning
"You already own this sword!" Player has sword in inventory/enderchest
"Ritual limit reached" Too many concurrent rituals active
"Insufficient permissions" Player lacks required permission node

Version History

v1.8.18 (Current)

  • Added Critlock Blade and Blade of Justice swords (17 swords total)
  • Registered custom models for all 4 new swords
  • Updated marketplace descriptions

v1.8.16

  • Added Void Blade and Void Serpent swords
  • Enhanced sword descriptions with passive ability info
  • Fixed off-hand container protection bug

v1.5.15

  • Added comprehensive German language support
  • Updated marketplace descriptions

v1.5.13

  • Guardian Blade water dome fixes
  • Multi-language support system (8 languages)
  • Enhanced ritual crafting system
  • Improved performance optimizations
  • Fixed multi-sword prevention system
  • Added world border management features

v1.5.12

  • Balance improvements
  • Polymart description added

v1.4.10

  • Container protection issue fixes

v1.4.9

  • Modrinth API dependency integration (FaithBreak auto-download)
  • Major protection system overhaul

v1.4.7

  • Added Zephyr's Wrath sword with wind abilities

v1.3.7

  • Fixed sword duplication exploit

Previous Versions

  • v1.3.6: CI/CD pipeline improvements
  • v1.2.6: Container protection and anti-duplication features
  • v1.1.5: Stability release, initial ability system
  • v1.1.4: Early release with core sword functionality
  • v1.0.x: Initial release with basic sword functionality