Skip to main content

Wie Templates funktionieren

Templates sind Ordner auf jedem Serverhost, die vor dem Serverstart in das Serververzeichnis kopiert werden. Nutze sie für Plugin-JARs, Standardwelten, Konfigurationsdateien und gemeinsame Ressourcen. Der Standard-Setup-Workflow kopiert Template-Ebenen in einer festen Reihenfolge. Bestehende Dateien bleiben erhalten, solange du den Workflow nicht so anpasst, dass er sie überschreibt.
Brauchst du Welt- oder Spielerdaten, die Neustarts überleben? Verwende einen Persistenten Server anstelle einer Gruppe.

Template-Verzeichnisstruktur

templates
_every
_tagged

Gemeinsame Templates

_every/every

Nutze _every/every/ für Dateien, die jeder Server bekommen soll, also Proxies und Game-Server.
templates
_every
every

_every/every_{type}

Nutze Typ-Templates, wenn Dateien für alle Proxies oder alle Game-Server gelten sollen.

_every/every_{software}

Nutze Software-Templates, wenn Dateien zu einer bestimmten Server-Software gehören.

Tagged Templates

Tags helfen dir, Dateien über mehrere Gruppen oder persistente Server zu teilen, ohne den benannten Template-Ordner zu duplizieren.
  1. Erstelle einen Tag-Ordner in templates/_tagged/.
  2. Weise denselben Tag im Dashboard zu, wenn du die Gruppe oder den persistenten Server erstellst oder bearbeitest.
templates
_tagged
minigames

Benannte Templates

Der Ordner mit dem Namen einer Gruppe oder eines persistenten Servers ist die spezifischste Template-Ebene.
templates
bedwars
Bei Gruppenservern werden Dateien, die während der Laufzeit geändert werden, entfernt, wenn der dynamische Server stoppt. Bei persistenten Servern bleibt das Laufzeitverzeichnis zwischen Neustarts erhalten.

Template-Dateien verwalten

Plugins hinzufügen

Lege Plugin-JARs in der Ebene ab, in der sie gelten sollen:
Neue Serverstarts enthalten das Plugin. Bereits laufende Server brauchen einen Neustart.

Generierte Konfiguration zurück ins Template kopieren

  1. Starte einen Server einmal, damit das Plugin seine Standarddateien erzeugt.
  2. Stoppe den Server.
  3. Kopiere die generierte Konfiguration aus running/ in den passenden Template-Ordner.
  4. Bearbeite die Template-Kopie.
  5. Starte den Server erneut und prüfe das Ergebnis.

Weltdateien hinzufügen

Lege einen Weltordner im benannten Template ab, wenn jeder neue dynamische Server mit derselben Map starten soll:
templates
bedwars
Änderungen während des Spielens gehen verloren, wenn ein dynamischer Gruppenserver stoppt. Nutze einen persistenten Server für Welten, an denen Spieler weiterbauen sollen.

Cache-Dateien

Der Standard-Cleanup-Workflow speichert ausgewählte generierte Dateien in templates/cache/{name}/, damit spätere Starts sie wiederverwenden können. Der Serverhost verwaltet diesen Ordner.
Wenn ein dynamischer Server mit veralteten generierten Dateien startet, stoppe die betroffenen Server und lösche den passenden Gruppenordner unter templates/cache/.

Fehlerbehebung

Prüfe den genauen Ordnernamen. Die gemeinsamen Ordner liegen unter _every/, zum Beispiel templates/_every/every_paper/, nicht templates/every_paper/.
Templates werden während der Servervorbereitung kopiert. Starte den betroffenen Server neu, damit der Setup-Workflow erneut läuft.
Der Standard-Setup-Workflow behält vorhandene Dateien in den meisten Template-Ebenen. Das schützt Cache- und Persistent-Server-Daten. Nutze einen Configurator oder einen eigenen Workflow, wenn ein Wert bei jedem Start erzwungen werden muss.
Prüfe, ob der Tag im Dashboard zugewiesen ist und ob der Ordnername unter templates/_tagged/ exakt zum Tag passt.