# Einstellungen

## Grundlagen

{% hint style="warning" %}
**Bevor du irgendwas machst, STOPP DEN SERVER!**
{% endhint %}

AdminTools3 hat verschiedene Konfigurationsdateien, die dieser Guide alle behandelt.

Wenn du keinen gescheiten Datei-Bearbeiter hast, lade dir bitte zuerst einen runter!

* Das Einfachste: Notepad++. Funktioniert und hat zumindest einfaches Syntax Highlighting. (simplicity)
* Besser (Empfohlen): Visual Studio *Code*. Damit hast du immernoch einen sehr kleinen Editor, der aber viel besser auf Dateien wie die Config-Dateien optimiert ist.

Pass auf, dass du die YAML-Formatierung nicht zerstörst. Wenn du noch nie mit .yml-Dateien gearbeitet hast, hilft dir [dieser Guide](https://en.wikipedia.org/wiki/YAML#Syntax).

{% hint style="warning" %}
Another thing you NEED to look out for when editing config files is to NEVER use TAB!! ALWAYS make 2 Spaces !!! If you use TAB, the plugin crashes on load.
{% endhint %}

## Die config.yml-Datei

(Lies zuerst den Abschnitt "Die Grundlagen"!!!)

Die meisten Informationen findest du auch ganz oben in der config.yml-Datei, das hier ist einfach nur eine etwas ausführlichere Version davon.

{% hint style="warning" %}
Wenn du AdminTools3 updatest, wird evtl. eine neue config.yml generiert und die alte wird zu config\_OLD.yml umbenannt. **In diesem Fall musst du die Werte der alten Datei in die Neue übertragen**.
{% endhint %}

`language: en` Wenn du eine andere Sprachdatei nutzen willst, kannst du das hier ändern. Für die deutsche Übersetzung auf `de`

`prefix: "&cAdminTools&8│ &7"` Das Präfix wird vor jeder Nachricht angezeigt. Du kannst es beliebig ändern; wenn du kein Präfix willst, musst du es auf "" setzen.

`log-module-usage: true` Damit wird in die Konsole eine Nachricht gesendet, wenn jemand ein Modul nutzt. Damit kannst du nachverfolgen, wer wann was gemacht hat (z.B. wen gekillt hat etc.)

```
adminchat:
 format: "&c&lAC &7<&e%player%&7> &a%message%"
 prefix: "@admin"
```

Das Präfix des AdminChat ist das, was du vor die Nachricht schreiben musst, wenn du den AdminChat nutzen willst. %player% wird mit dem Namen des Spielers, der den AdminChat benutzt, ersetzt, %message% mit der Nachricht (ohne das Prefix).

Du kannst über den AdminChat auf der Seite "AdminTools3 benutzen" mehr erfahren.

```
module:
 [modulename]:
   registerCommands: false
   showMessageToTarget: false
   cooldown: 0
   aliases:
    - alias1
    - alias2
```

Hier kannst du jedes Modul einstellen. Wenn registerCommands nicht angegeben oder "true" ist, wird AdminTools3 Befehle für das Modul registrieren (das überschreibt manchmal andere Plugins!).&#x20;

Wenn showMessageToTarget auf false (Normal: true) steht, sendet AdminTools3 dem Ziel keine Nachricht. Das ist hilfreich, wenn du z.B. nicht willst, dass der andere Spieler sieht dass du in sein Inventar schaust.&#x20;

Wenn kein Cooldown eingestellt ist, kann man das Modul so schnell wie man will benutzten.&#x20;

Wenn keine Aliase angegeben werden, nutzt das Modul nur seinen Namen als Alias. Beispiele für Aliase:

```
module:
 workbench:
   cooldown: 0
   aliases:
    - wb
```

In diesem Beispiel kannst du das Modul workbench mit diesen Befehlen benutzen:

* /a workbench
* /a wb
* /workbench
* /wb

## Eine eigene Übersetzung einbauen

{% hint style="danger" %}
!!!! WICHTIG: Bearbeite NIE messages\_de.yml oder messages\_en.yml DIREKT !!!!

!!!! DIESE DATEIEN WERDEN IMMER WIEDER ÜBERSCHRIEBEN !!!!
{% endhint %}

1. Server runterfahren!!!
2. Kopiere und füge eine bestehende Nachrichtendatei in den gleichen Ordner ein. Benenne sie zu messages\_XX.yml (Du kannst alles in XX benutzen.)
3. Ändere die "language"-Einstellung in der config.yml zu was auch immer du als XX benutzt hast.
4. Jetzt kannst du die Nachrichten in der neuen Datei beliebig ändern

Bitte beachte diese Dinge:

* Du kannst diese Farbcodes nutzen: <http://ess.khhq.net/mc/>
* Das Plugin nutzt den Platzhalten %s. Er wird mit den Dingen ersetzt, die in der Nachricht Sinn ergeben. Wenn %s in der Ursprünglichen Nachricht auftaucht, finde raus wofür sie stehen und benutze sie in der neuen Nachricht.
  * Die Reihenfolge ist wichtig! In den wenigen Nachrichten mit mehreren %s werden die Werte immer in der gleichen Reihenfolge eingesetzt, pass dort also auf!
* Du kannst in der config.yml das Prefix ändern
* Inventarnamen (invName) dürfen maximal 32 Zeichen lang sein, längere Namen crashen das Plugin.
* In itemLore-Nachrichten kannst du ## für eine neue Zeile nutzen. Wichtig: Am Anfang von neuen Zeilen ist die Formatierung weg, du brauchst also wieder neue Farbcodes.
* Wenn du PlaceholderAPI nutzt, kannst du die Platzhalter überall nutzen. Mehr Infos [hier](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki).&#x20;
* Im playerInfo-Bereich gibt es einen Eintrag namens"explanationIgnoredByPlugin". Das ist nur eine Erklärung für den config-Bereich.
* Nachrichten im chatMessages-Bereich können auch in der Konsole erscheinen.
* Wenn du das Plugin übersetzt hast, wäre ich dir sehr dankbar, wenn du das auf dem [support discord server](https://discord.gg/YDkQbE7) sagst!
