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

# Axochat

**Axochat** ist ein leichtgewichtiges, modernes Chat-Plugin mit **MiniMessage-Support**, farbigen **LuckPerms-Präfixen**, privaten Nachrichten, Staff-Chat, Mute-System und Chat-Filtern.

### Eigenschaften

* Modernes Chat-Design mit MiniMessage-Support (Farben, Verläufe, Decorationen)
* Zeigt LuckPerms-Präfixe farbig im Chat an
* Private Nachrichten (`/msg`, `/r`) mit optionalem SocialSpy
* Staff-Chat (`/staffchat` / `/sc`)
* Mute-System mit Zeit und Grund
* Chat-Filter (Anti-Spam, Caps, Wortfilter, Anti-Werbung, Anti-Link)
* Folia-Support

### Voraussetzungen

* Minecraft-Version: **1.20 – 26.2**
* Server-Typ: **Paper**, Spigot, Purpur, Folia oder Bukkit
* Empfohlen: **LuckPerms** für Präfixe

### Installation

1. Lade die neueste Version von [Modrinth](https://modrinth.com/organization/haistudios) herunter.
2. Lege die `.jar`-Datei in den Ordner `plugins/`.
3. Starte den Server neu.
4. Optional: LuckPerms installieren und Präfixe setzen.

### Befehle

| Befehl                                 | Beschreibung                                 | Berechtigung                |
| -------------------------------------- | -------------------------------------------- | --------------------------- |
| `/chatreload` (alias `/axochat`)       | Reloadet die AxoChat-Config                  | `axochat.command.reload`    |
| `/msg <Spieler> <Nachricht>`           | Sendet eine private Nachricht                | `axochat.command.msg`       |
| `/r <Nachricht>`                       | Antwortet auf die letzte private Nachricht   | `axochat.command.reply`     |
| `/color`                               | Zeigt alle Farben und Erklärungen            | `axochat.command.color`     |
| `/colortest`                           | Zeigt einen Farbtest                         | `axochat.command.color`     |
| `/ignore <Spieler>` \| `/ignore list`  | Ignoriert einen Spieler bzw. zeigt die Liste | `axochat.command.ignore`    |
| `/spy`                                 | Schaltet den Spy-Modus um                    | `axochat.command.spy`       |
| `/staffchat [Nachricht]` (alias `/sc`) | Staff-Chat                                   | `axochat.command.staffchat` |
| `/mute <Spieler> [Zeit] [Grund]`       | Mutet einen Spieler                          | `axochat.command.mute`      |
| `/unmute <Spieler>`                    | Entmutet einen Spieler                       | `axochat.command.unmute`    |
| `/muteinfo [Spieler]`                  | Zeigt Mute-Informationen                     | `axochat.command.muteinfo`  |

### Berechtigungen

#### Befehle

| Berechtigung                | Beschreibung                         | Standard |
| --------------------------- | ------------------------------------ | -------- |
| `axochat.command.reload`    | Erlaubt `/chatreload` und `/axochat` | 🔒 OP    |
| `axochat.command.msg`       | Erlaubt `/msg`                       | ✅ Alle   |
| `axochat.command.reply`     | Erlaubt `/r`                         | ✅ Alle   |
| `axochat.command.color`     | Erlaubt `/color` und `/colortest`    | ✅ Alle   |
| `axochat.command.ignore`    | Erlaubt `/ignore`                    | ✅ Alle   |
| `axochat.command.spy`       | Erlaubt `/spy`                       | 🔒 OP    |
| `axochat.command.staffchat` | Erlaubt `/staffchat`                 | 🔒 OP    |
| `axochat.command.mute`      | Erlaubt `/mute`                      | 🔒 OP    |
| `axochat.command.unmute`    | Erlaubt `/unmute`                    | 🔒 OP    |
| `axochat.command.muteinfo`  | Erlaubt `/muteinfo`                  | 🔒 OP    |

#### Chat-Features

| Berechtigung             | Beschreibung                                     | Standard |
| ------------------------ | ------------------------------------------------ | -------- |
| `axochat.color`          | Erlaubt das Schreiben mit normalen `&`-Farbcodes | ✅ Alle   |
| `axochat.color.advanced` | Erlaubt erweiterte MiniMessage-Farben            | 🔒 OP    |
| `axochat.socialspy`      | Erlaubt das Mitlesen privater Nachrichten        | 🔒 OP    |
| `axochat.deathmessage`   | Sieht Todesnachrichten                           | ✅ Alle   |
| `axochat.joinmessage`    | Sieht Join-Nachrichten                           | ✅ Alle   |
| `axochat.quitmessage`    | Sieht Quit-Nachrichten                           | ✅ Alle   |
| `axochat.tab`            | Zeigt den Prefix in der Tabliste                 | ✅ Alle   |
| `axochat.silentjoin`     | Tritt dem Server still bei                       | ❌ Keiner |
| `axochat.silentquit`     | Verlässt den Server still                        | ❌ Keiner |

#### Filter-Bypass

| Berechtigung                 | Beschreibung                | Standard |
| ---------------------------- | --------------------------- | -------- |
| `axochat.bypass.caps`        | Umgeht die Caps-Sperre      | ❌ Keiner |
| `axochat.bypass.wordfilter`  | Umgeht den Wortfilter       | ❌ Keiner |
| `axochat.bypass.advertising` | Umgeht die Werbe-Sperre     | ❌ Keiner |
| `axochat.bypass.links`       | Umgeht die Link-Sperre      | ❌ Keiner |
| `axochat.bypass.spam`        | Umgeht die Anti-Spam-Sperre | ❌ Keiner |

> **Hinweis:** Alte Permissions wie `axochat.reload`, `axochat.ignore`, `axochat.spy`, `axochat.staffchat`, `axochat.mute`, `axochat.unmute` und `axochat.muteinfo` funktionieren weiterhin und verweisen auf die neuen Nodes.

### Konfiguration

Die Konfigurationsdatei `plugins/AxoChat/config.yml` wird beim ersten Start automatisch erstellt. Die wichtigsten Optionen:

```yaml
chat:
  format: "{player} >> {message}"
  use-mini-message: true

prefix:
  use-luckperms: true
  fallback: "<gray>Spieler"

filter:
  anti-spam:
    enabled: true
    cooldown-seconds: 3
  caps:
    enabled: true
    min-length: 6
    max-uppercase-percent: 50
  word-filter:
    enabled: true
    replacement: "****"
    blocked-words: []
  anti-advertising:
    enabled: true
    blocked-ips: []
  anti-link:
    enabled: true

mute:
  default-duration: "10m"
  default-reason: "Kein Grund angegeben"

staffchat:
  format: "<gray>[</gray><dark_aqua>Staff</dark_aqua><gray>] </gray><senderPrefix><sender><gray>:</gray> <white><message></white>"
```

Die Config enthält außerdem Einstellungen für `hover`, `click` (Aktionen auf Spieler-Klick), `private-message`, `death`, `socialspy`, `tab`, Join-/Quit-Nachrichten, `spy` und `ignore`-Nachrichten.

### Support

Bei Fragen oder Problemen: [Discord](https://discord.gg/3pA82RqTWt)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://haistudios.gitbook.io/haistudios-wiki/plugins/axochat.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.