Skip to content

Astral Swords (Freemium) — Configuration

Configuration files and the ritual crafting system.

Configuration Files

The plugin uses a single unified configuration file at plugins/AstralSwords/config.yml.

General Settings

general:
  debug: false          # Enable debug logging
  check-updates: true   # Check for new versions on startup

Protection Settings

Controls how Astral Swords interact with containers and the world:

protection:
  allow-container-storage: false  # Allow swords in containers (chests, barrels, etc.)
  allow-item-frames: false        # Allow placing swords in item frames
  allow-hopper-pickup: false      # Allow hoppers to pick up swords
  allow-anvil-renaming: false     # Allow renaming swords in anvils
  allow-anvil-enchanting: false   # Allow adding enchantments via anvils

Off-Hand Swap Protection

As of v1.2.16, swords are also protected from being moved into containers via off-hand swapping (F key). This is covered by allow-container-storage.

Sword Enchantments

Configure enchantments for each sword in the sword-enchants section:

sword-enchants:
  skyfall_blade:
    sharpness: 8
    unbreaking: 4
  dragons_wrath:
    sharpness: 8
    unbreaking: 4
    fire_aspect: 5
  # ... continues for all swords

Sword Recipes

Manage crafting recipes using a 3x3 grid (slots 0-8) in the sword-recipes section:

sword-recipes:
  skyfall_blade:
    enabled: true
    recipe:
      0: ELYTRA
      1: NETHER_STAR
      2: ELYTRA
      # ... slots 3-8
  # ... continues for all swords

Configuration Options

  • Recipe Customization — Modify any sword's crafting recipe
  • Enchantment Levels — Adjust enchantment types and levels per sword
  • Crafting Toggle — Enable/disable crafting for individual swords
  • Protection Settings — Control container storage, item frames, hoppers, and anvil interactions
  • Update Checks — Toggle automatic version checks on startup
  • Sound Settings — Volume and pitch adjustments (code-level)
  • Cooldown Timers — Ability cooldown durations (code-level)
  • Effect Durations — How long abilities last (code-level)

Ritual Crafting System

How Ritual Crafting Works

When ritual crafting mode is enabled, the normal crafting process is replaced with an immersive ritual:

  1. Initiation — Player places items in crafting table as normal
  2. Ritual Animation — Items disappear and a floating sword appears above the table
  3. Charging Phase — Progress bar appears showing ritual completion
  4. Particle Effects — Mystical particles surround the floating sword
  5. Completion — Sword drops as an item with dramatic effects
  6. Announcement — Server-wide broadcast of the sword's creation

Enabling Ritual Mode

Command Description
/aswords craft-mode ritual Enable ritual crafting mode (Admin)
/aswords craft-mode normal Restore normal crafting (Admin)

Ritual Features

  • Floating Sword Display — 3D sword model hovers above crafting table
  • Progress Indication — Visual progress bar shows ritual completion
  • Particle Systems — Custom particle effects for each sword type
  • Sound Integration — Mystical sounds during the ritual process
  • Dramatic Completion — Sword drops with special effects and sounds