> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/scoreboardplus/beschreibung.md).

# Beschreibung

Das ScoreboardPlus-Plugin bietet eine Vielzahl von Funktionen zur Anpassung von Scoreboards, TabLists, Chatformaten und vielem mehr. Es ist vollständig konfigurierbar und unterstützt die PlaceholderAPI, wodurch es sich nahtlos in deinen Server integrieren lässt. Zusätzlich bietet es eine API für Entwickler, um eigene Erweiterungen zu erstellen.

#### Features

* **Vollständig anpassbar:** 100% der Einstellungen können in der Konfigurationsdatei angepasst werden.
* **PlaceholderAPI-Unterstützung:** Nutze Platzhalter für Chat, Prefixe, Suffixe, Scoreboard, TabList Header und Footer.
* **Chatformat:** Kann in der Konfiguration ein- oder ausgeschaltet werden.
* **Asynchroner Modus:** Ressourcenfreundliche Ausführung, individuell pro Feature aktivierbar.
* **Reload-Befehl:** Aktualisiere das Scoreboard und andere Einstellungen ohne Server-Neustart.
* **"Force new Scoreboard" Modus:** Beim Joinen wird immer ein neues Scoreboard erstellt (empfohlen).
* **Scoreboard Sidebar:** Ein- und ausschaltbar, mit anpassbarem Update-Intervall.
* **Animiertes Scoreboard:** Ermöglicht dynamische Effekte im Scoreboard.
* **Eigene Placeholder:** Verfügbar sind `%sbplus_dpname%`, `%sbplus_rang%`, `%sbplus_chatprefix%`, `%sbplus_tabprefix%`.
* **TabList:** Prefixe und Suffixe sind einstellbar (ein- und ausschaltbar).
* **TabList Header und Footer:** Anzeigbare oder leere Textfelder für zusätzliche Informationen.
* **Ranksystem:** Reihenfolge, Prefix, Suffix und Scoreboard-Anzeigename individuell konfigurierbar.
* **Actionbar und Bossbar:** Beide sind optional und können über die Konfiguration aktiviert oder deaktiviert werden.
* **Flackerfreie Updates:** Sorgt für eine reibungslose Anzeige ohne visuelle Störungen.
* **HEX-Code Support:** Ab Version 1.16 für Scoreboard, Chat, Tab Header & Footer und Customprefixe verfügbar.
* **Customprefix:** Mit `/prefix` können Spieler ihre Prefixfarben ändern.
* **Toggle-Befehle:** Spieler können Scoreboard, Actionbar und Bossbar ein- oder ausblenden.
* **Developer API:** Bietet Entwicklern eine Schnittstelle, um das Plugin zu erweitern.
* **Kompatibel mit allen Permissionsystemen.**
* **PlaceholderAPI und ProtocolLib:** Für einige Funktionen erforderlich.

#### Befehle

* **`/scoreboardplus`** - Reloadet die Konfigurationsdatei.
* **`/scoreboardplus togglesb`** - Zeigt das Scoreboard an oder versteckt es (funktioniert nicht, wenn `Packets` auf `true` gesetzt ist).
* **`/scoreboardplus toggleactionbar`** - Zeigt die Actionbar an oder versteckt sie.
* **`/scoreboardplus togglebossbar`** - Zeigt die Bossbar an oder versteckt sie.
* **`/prefix`** - Öffnet das CustomPrefix GUI.
* **`/customprefix`** - Öffnet ebenfalls das CustomPrefix GUI.

*Hinweis:* Anstelle von `/scoreboardplus` kann auch `/sbplus` verwendet werden.

#### Berechtigungen

* **`scoreboardplus.reload`** - Erlaubt das Ausführen von `/scoreboardplus reload`.
* **`scoreboardplus.togglesb`** - Erlaubt das Ein- und Ausblenden des Scoreboards (erforderlich, wenn in der Konfiguration `permissionneed` auf `true` gesetzt ist).
* **`scoreboardplus.toggleactionbar`** - Erlaubt das Ein- und Ausblenden der Actionbar (erforderlich, wenn `permissionneed` auf `true` gesetzt ist).
* **`scoreboardplus.togglebossbar`** - Erlaubt das Ein- und Ausblenden der Bossbar (erforderlich, wenn `permissionneed` auf `true` gesetzt ist).

#### Ranksystem

In der Konfiguration findest du den Abschnitt "ranks", in dem du die Prefixe für TabList, Chat und Scoreboard für die jeweiligen Ränge definierst. Die Reihenfolge in der Konfiguration bestimmt auch die Anzeige-Reihenfolge in der TabList.

**Anleitung zur Konfiguration des Ranksystems**

* **Format:** `PERMISSION;RANGNAME IM SCOREBOARD;CHATPREFIX;TABPREFIX`
* **Beispiel:**

  ```
  'rank.0001;&4Owner;&4Owner &7| ;&4Owner &7| '
  ```
* **Erklärung des Beispiels:**\
  Wenn ein Spieler die Berechtigung `rank.0001` hat, werden folgende Werte angezeigt:
  * `%sbplus_rang%` -> `&4Owner`
  * `%sbplus_chatprefix%` -> `&4Owner &7|`
  * `%sbplus_tabprefix%` -> `&4Owner &7|`

Durch die Nutzung dieser Konfiguration kannst du individuelle Prefixe und Suffixe für jeden Rang festlegen und sie in der TabList, im Chat und im Scoreboard anzeigen.


---

# 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:

```
GET https://wiki.dyroxplays.de/scoreboardplus/beschreibung.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
