# 🌌 AstralWalker

_Traverse the world as an invisible, intangible spirit._

## ✨ Overview
AstralWalker lets players project their spirit out of their body and explore the world as an invulnerable, intangible spectator. While projecting, your physical body stays put and a countdown ticks down — stray too far, change dimensions, or run out of time and your spirit is snapped back. Place named **Astral Beacons** around the world that resonate with a chime and message when your spirit drifts near them. When you recall, you're safely returned to your body on solid ground.

## 📦 Installation
1. Drop the `.jar` into your server's `/plugins` folder.
2. Restart (or reload) your server.
3. That's it! Built for Minecraft **1.21** (api-version `1.21`).

## ⌨️ Commands

| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/astral` | Astral projection commands. Usage: `/astral <project\|recall\|beacon place <name>>`. `project` sends your spirit out (spectator + invulnerable) for a limited time; `recall` returns you to your body early; `beacon place <name>` saves a named Astral Beacon at your current location. | _none_ | _none_ |

## ⚙️ Configuration
The `config.yml` controls the projection limits (and stores your saved beacons):
- **spirit-duration** — how many seconds your spirit can roam before being pulled back (default 60).
- **max-distance** — how far you may stray from your body before forced recall (default 200 blocks).
- **beacon-radius** — how close your spirit must be to a beacon for it to resonate (default 8 blocks).
- **beacons** — auto-managed list of saved beacons (world, coordinates, and name); created via `/astral beacon place`.

## 📖 Full documentation
👉 https://spaleforce.com/wiki/astralwalker

---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
Astral Walker
