> ## Documentation Index
> Fetch the complete documentation index at: https://simplecloud.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Proxy Essentials
> Konfiguriere SimpleCloud MOTDs, Tablists, Joinstates, Player Counts und Proxy-Layouts
## Überblick
Proxy Essentials ergänzt typische Proxy-Funktionen für SimpleCloud-Netzwerke: Serverlisten-MOTDs, Tablist-Header und -Footer, Joinstates, Whitelisting, summierte Spielerzahlen und konfigurierbare Hub-Befehle.
Alle Einstellungen liegen in Dateien und können vom Proxy aus neu geladen werden.
## Unterstützte Software
| Software | Plugin-Unterstützung |
| ---------- | -------------------- |
| Velocity | Ja |
| BungeeCord | Ja |
## Schnellstart
Lade das Plugin von [GitHub](https://github.com/simplecloudapp/proxy-essentials-plugin/releases) herunter und lege es im `plugins/`-Ordner deines Proxy-Templates ab.
Stelle sicher, dass das `simplecloud-api` Plugin im selben Proxy-Template installiert ist. Proxy Essentials nutzt es für Spielerzahlen und SimpleCloud-bezogene Proxy-Zustände.
Starte den Proxy einmal, damit das Plugin `config.yml`, `layout/*.yml`, `placeholder.yml` und `messages.yml` erzeugt.
Konfiguriere Joinstates, MOTD-Layouts, Tablists und Player Counts.
Nach einem Reload oder Neustart sollte `/scproxy reload` die Proxy-Essentials-Konfiguration ohne Fehler neu laden.
## Erzeugte Dateien
| Datei | Zweck |
| ----------------- | ----------------------------------------------- |
| `config.yml` | Joinstates, Whitelist, Player Count und Tablist |
| `layout/*.yml` | Serverlisten-MOTD-Layouts |
| `placeholder.yml` | Datums-, Zeit- und Ping-Farben |
| `messages.yml` | Kick- und Befehlsnachrichten |
## Joinstates
Joinstates steuern, ob ein Spieler beitreten darf und welches MOTD-Layout erzwungen wird.
```yaml theme={null}
version: "2"
initial-state: public
initial-layout: public
joinstates:
- name: public
permission:
join: ""
full: "simplecloud.proxy-essentials.join.full.public"
forced-motd-layout: null
- name: maintenance
permission:
join: "simplecloud.proxy-essentials.join.maintenance"
full: "simplecloud.proxy-essentials.join.maintenance"
forced-motd-layout: maintenance
whitelist:
enabled: true
players:
- Notch
```
### Player Count
Der Player Count kann diese Proxy-Gruppe plus weitere Gruppen oder Persistent Server zusammenzaehlen. Das Update-Intervall wird in Ticks konfiguriert.
```yaml theme={null}
player-count:
enabled: true
additional-groups: []
additional-persistent-servers: []
update-time: 20
```
## Serverlisten-Layouts
MOTD-Layouts liegen im `layout/`-Ordner. Joinstates können mit `forced-motd-layout` ein Layout erzwingen, und `/scproxy layout` kann ein Layout auf einer Gruppe speichern.
```yaml theme={null}
config-version: "2"
motd:
enabled: true
update-type: RANDOM # RANDOM oder QUEUE
layouts:
- name: public
line1: "A simplecloud.app network"
line2: " "
server-icon:
enabled: true
file: simplecloud.png
player-list:
enabled: true
player-list:
- ""
- "simplecloud.app"
- ""
version:
name:
enabled: false
text: "Example"
slots:
enabled: true
type: REAL # REAL, FAKE oder DYNAMIC
fake-slots: 100
dynamic-player-range: 5
```
## Tablist
Tablist-Layouts werden in `config.yml` konfiguriert. Die Update-Zeit ist in Ticks.
```yaml theme={null}
tablist:
- name: global
layout:
- header: "
SimpleCloud v3
"
footer: "
players are playing on your network
"
update-time: 20
```
## Befehle
| Befehl | Beschreibung |
| ------------------------------------------------- | -------------------------------------------------------------------------- |
| `/scproxy` | Verfügbare Proxy-Essentials-Befehle anzeigen |
| `/scproxy help` | Befehlshilfe anzeigen |
| `/scproxy reload` | `config.yml`, `placeholder.yml`, `messages.yml` und MOTD-Layouts neu laden |
| `/scproxy joinstate help` | Joinstate-Befehle anzeigen |
| `/scproxy joinstate info ` | Joinstate einer Gruppe anzeigen |
| `/scproxy joinstate info ` | Joinstate eines Servers anzeigen |
| `/scproxy joinstate set ` | Joinstate für eine Gruppe und ihre Server setzen |
| `/scproxy joinstate set ` | Joinstate für einen Server setzen |
| `/scproxy layout help` | Layout-Befehle anzeigen |
| `/scproxy layout info` | Standard-MOTD-Layout anzeigen |
| `/scproxy layout info ` | Layout einer Gruppe anzeigen |
| `/scproxy layout set ` | MOTD-Layout auf einer Gruppe und ihren laufenden Servern speichern |
## Platzhalter
| Platzhalter | Kontext | Beschreibung |
| -------------------- | ------------- | ------------------------------------------------- |
| `` | MOTD, Tablist | Summierte Online-Spieler |
| `` | MOTD, Tablist | Maximale Spielerzahl anhand des Slot-Modus |
| `` | MOTD, Tablist | Aktuelles Datum/Zeit mit MiniMessage-Datumsformat |
| `` | MOTD, Tablist | Wert einer Umgebungsvariable |
| `` | MOTD, Tablist | Umgebungsvariable mit Fallback |
| `` | Tablist | Aktueller Server des Spielers |
| `` | Tablist | Ping des Spielers mit konfigurierter Farbe |
Konfiguriere Datums- und Ping-Darstellung in `placeholder.yml`:
```yaml theme={null}
currentDateFormat: "dd.MM.yyyy"
currentTimeFormat: "HH:mm:ss"
pingColors:
- ping: 0
color: ""
- ping: 100
color: ""
- ping: 200
color: ""
```
## Berechtigungen
| Berechtigung | Beschreibung |
| ----------------------------------------------------- | ----------------------------------------------------------- |
| `simplecloud.proxy-essentials.command.help` | `/scproxy`, `/scproxy help` und `/scproxy reload` verwenden |
| `simplecloud.proxy-essentials.command.joinstate.help` | Joinstate-Hilfe anzeigen |
| `simplecloud.proxy-essentials.command.joinstate.info` | Joinstates anzeigen |
| `simplecloud.proxy-essentials.command.joinstate.set` | Joinstates ändern |
| `simplecloud.proxy-essentials.command.layout.help` | Layout-Hilfe anzeigen |
| `simplecloud.proxy-essentials.command.layout.info` | Layout-Zuweisungen anzeigen |
| `simplecloud.proxy-essentials.command.layout.set` | MOTD-Layout einer Gruppe ändern |
| `simplecloud.proxy-essentials.join.maintenance` | Im Maintenance-Status beitreten |
| `simplecloud.proxy-essentials.join.full.public` | Einem vollen Public-Netzwerk beitreten |
