# 👻 EchoForge

_Record your block placing and breaking, then replay it as a glowing spectral ghost._

## ✨ Overview
EchoForge captures your construction in real time. Start a recording, then build or mine — every block you place or break is logged with its timing. Stop the recording to save it, then play it back: a glowing armor-stand "ghost" wearing your head re-enacts the whole session, placing and breaking the exact same blocks at the original pace (or faster). Perfect for time-lapse builds, tutorials, and eerie haunted-construction effects.

## 📦 Installation
1. Drop the `.jar` into your server's `/plugins` folder.
2. Restart the server (built for Minecraft **1.21**, `api-version: 1.21`).
3. Recordings are saved as `.yml` files under `plugins/EchoForge/recordings/`.

## ⌨️ Commands

| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/echo` | EchoForge recording and playback. `/echo record <name>` starts or stops a recording (run again to stop), `/echo play <name> [speed]` replays it as a ghost, `/echo list` lists saved recordings. | `echoforge`, `ef` | — |

## ⚙️ Configuration
- **`max-actions-per-recording`** — max block actions captured before a recording auto-stops (default `10000`).
- **`default-playback-speed`** — speed multiplier used when `/echo play` is run without a speed argument.
- **`max-playback-speed`** — the highest speed multiplier players may request.
- **`playback-tick-interval`** — how often (in ticks) the playback scheduler fires; `1` is smoothest.
- **`ghost.glowing`** — apply the glow effect so the ghost is visible through walls.
- **`ghost.particles`** — spawn ambient witch particles around the ghost.
- **`ghost.name-prefix`** — text shown above the ghost's head before the player's name (default `"Echo of "`).

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

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