# ⏳ ChronoEcho

_Record your past actions and summon a translucent ghostly echo to replay them beside you._

## ✨ Overview
ChronoEcho constantly records what you do — where you walk, the blocks you break and place, and when you swing your weapon — keeping a rolling buffer of your recent history. With a command you can summon a ghostly armor-stand "echo" of your past self that faithfully replays those movements and actions on a loop, complete with particle trails and attack animations. The echo even strikes nearby hostile mobs while replaying an attack frame, making it a spooky companion as well as a spectacle. Echoes can optionally be remembered and resummoned automatically when you log back in.

## 📦 Installation
1. Drop the `ChronoEcho.jar` into your server's `/plugins` folder.
2. Restart the server.
3. Done! ChronoEcho targets Minecraft **1.21** (api-version `1.21`).

## ⌨️ Commands

| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/echo <summon\|dismiss\|replay> [seconds]` | Manage your time-echo. `summon` spawns an echo replaying the default number of seconds, `dismiss` removes your active echo, `replay <seconds>` summons an echo replaying a custom length of your recorded history. | `chronoecho` | _none_ |

## ⚙️ Configuration
The `config.yml` shapes how recording and echoes behave:
- `max-recording-seconds` — how many seconds of history are kept in the rolling buffer (default `60`).
- `default-replay-seconds` — seconds replayed by `/echo summon` and auto-resummoned echoes (default `30`).
- `echo-particle` — the Bukkit particle used for the echo's ghostly trail (default `WITCH`).
- `echo-name` — display name shown above the echo; `%player%` is replaced with the owner's name and `&` color codes work (default `"&7Echo of %player%"`).
- `pending-on-join` — remember active echoes on logout and resummon them on rejoin (default `true`).
- `echo-attack-damage` — damage the echo deals to nearby hostile mobs during an attack frame (default `2.0`).

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

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