> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edautofighter/essential/messages.md).

# Messages

All chat messages live in `messages.yml`. They support `&` colour codes, `&#RRGGBB` hex colours and PlaceholderAPI. `{prefix}` inserts the configurable prefix. Available placeholders vary per message and are documented inline in the file.

### Spawn messages

| Key                        | Sent when                               | Placeholders                     |
| -------------------------- | --------------------------------------- | -------------------------------- |
| `spawn-no-permission`      | Player lacks `edautofighter.use`        | —                                |
| `spawn-not-in-zone`        | Player is not inside an EdDungeons zone | —                                |
| `spawn-no-time`            | Player has no Autofighter Time left     | —                                |
| `spawn-daily-limit`        | Player hit their daily limit            | `{reset}`                        |
| `spawn-already-active`     | Fighter is already active               | —                                |
| `spawn-eddungeons-missing` | EdDungeons is unavailable               | —                                |
| `spawn-success`            | Fighter spawned                         | `{time}` (usable time remaining) |

### Despawn messages

| Key                   | Sent when                                  | Placeholders |
| --------------------- | ------------------------------------------ | ------------ |
| `despawn-manual`      | Player dismissed the fighter               | —            |
| `despawn-out-of-time` | Time Balance ran out                       | —            |
| `despawn-daily-limit` | Daily limit was reached                    | —            |
| `despawn-left-zone`   | Player left the zone                       | —            |
| `low-time-warning`    | Remaining time dropped below the threshold | `{time}`     |

### Upgrade & target messages

| Key                     | Placeholders                                   |
| ----------------------- | ---------------------------------------------- |
| `upgrade-maxed`         | `{upgrade}`                                    |
| `upgrade-cannot-afford` | `{cost}`, `{currency}`                         |
| `upgrade-success`       | `{upgrade}`, `{level}`, `{cost}`, `{currency}` |
| `target-locked`         | —                                              |
| `target-changed`        | `{mode}`                                       |

### Admin & misc messages

| Key                | Placeholders         |
| ------------------ | -------------------- |
| `time-given`       | `{player}`, `{time}` |
| `time-set`         | `{player}`, `{time}` |
| `time-received`    | `{time}`             |
| `reloaded`         | —                    |
| `player-not-found` | —                    |
| `invalid-usage`    | `{usage}`            |
| `no-permission`    | —                    |
| `players-only`     | —                    |
| `usage-root`       | — (help text)        |
| `usage-time`       | `{sub}` (help text)  |