Skip to main content

​
Template-Ordner auswählen

Lege eine Datei einmal im passenden Template ab. SimpleCloud kopiert sie beim Start auf jeden zugehörigen Server. Templates eignen sich am besten für Gruppenserver, die mit einem neuen Verzeichnis starten. Wenn Dateien, die sich während des Serverbetriebs ändern, nach dem Stoppen erhalten bleiben müssen, verwende einen persistenten Server. Öffne Files im Dashboard, wähle einen Serverhost aus und öffne templates. Wähle den Ordner danach aus, wie weit die Dateien geteilt werden sollen:
  • Eine Gruppe oder ein persistenter Server: templates/{name}/
  • Server mit einem Tag: templates/_tagged/{tag}/
  • Eine Serversoftware: templates/_every/every_{software}/
  • Alle Gameserver: templates/_every/every_server/
  • Alle Proxys: templates/_every/every_proxy/
  • Jeder Server: templates/_every/every/
Dateien, die beispielsweise nur von der Gruppe lobby verwendet werden, gehören in templates/lobby/. Ein Plugin, das jeder Paper-Server benötigt, gehört in templates/_every/every_paper/.
Verwende den spezifischsten Ordner, der alle Server mit diesen Dateien umfasst. So bleiben die übrigen Server und Templates übersichtlich.

​
Ordnerstruktur des Servers beibehalten

Alles unterhalb des gewählten Template-Ordners wird direkt auf das Serververzeichnis abgebildet. Verwende an beiden Stellen denselben relativen Pfad. Diese Template-Datei:
wird beispielsweise zu dieser Datei in einem laufenden lobby-Server:
Der generierte Servername, zum Beispiel lobby-1, kann sich zwischen Starts unterscheiden. Der Pfad unterhalb dieses Namens bleibt gleich. Verwende Secrets für Passwörter und Tokens. Füge eine Referenz wie {{ secrets.DATABASE_PASSWORD }} statt des echten Werts in das Template ein.
1

Passenden Template-Ordner öffnen

Öffne den Ordner für die Gruppe, das Tag, die Software oder den Servertyp, den du ändern möchtest. Erstelle den Ordner, falls er noch nicht vorhanden ist.
2

Dateien am relativen Serverpfad hinzufügen

Um ein Plugin im Ordner plugins des Servers abzulegen, erstelle im Template einen Ordner plugins und lade dort die JAR-Datei hoch. Behalte für Konfigurations- und Weltordner dieselbe Struktur bei, die sie innerhalb eines laufenden Servers verwenden.
3

Passenden Server starten

Starte einen Server und öffne seine Seite Files, um zu bestätigen, dass die Dateien an den erwarteten Speicherorten erscheinen.

​
Template-Änderungen anwenden

Gruppenserver erhalten bei jedem Start ihre passenden Template-Dateien. Ein bereits laufender Server ändert sich nicht. Stoppe ihn daher und starte nach der Aktualisierung eines Templates einen weiteren Server. Auch persistente Server lesen ihre Templates beim Start, behalten ihr Serververzeichnis jedoch zwischen den Starts. Ein Template kann eine fehlende Datei hinzufügen, ersetzt aber keine Datei, die auf dem persistenten Server bereits vorhanden ist. Bearbeite eine bestehende Datei des persistenten Servers direkt auf seiner Seite Files.

​
Generierte Konfiguration wiederverwenden

Einige Plugins erstellen ihre Konfiguration erst beim ersten Start. Gehe bei einem Gruppenserver wie folgt vor:
  1. Starte einen Server und lasse das Plugin seine Dateien erstellen.
  2. Öffne noch während der Server läuft seinen Ordner unter running/{group}/{server}/.
  3. Kopiere die generierte Datei oder lade sie herunter und lege sie anschließend unter demselben relativen Pfad im Template der Gruppe ab.
  4. Bearbeite die Template-Kopie.
  5. Stoppe den laufenden Server und starte einen weiteren, um das Template zu testen.
Kopiere beispielsweise:
nach:
Kopiere Dateien aus einem Gruppenserver, bevor du ihn stoppst. SimpleCloud entfernt das running-Verzeichnis dieses Servers, wenn er stoppt.
Die Dateien eines persistenten Servers liegen unter running/persistent/{name}/ und bleiben nach dem Stoppen erhalten. Bearbeite vorhandene Dateien direkt. Ein Template eignet sich hier nur für Dateien, die SimpleCloud bei Bedarf hinzufügen soll.

​
Dateien mit Tags teilen

Mit Tags können nicht miteinander verbundene Gruppen oder persistente Server dieselben Dateien verwenden, ohne sie in jedem benannten Template zu duplizieren. Erstelle einen Ordner wie templates/_tagged/minigames/ und füge anschließend jeder Gruppe und jedem persistenten Server, der seine Dateien erhalten soll, das Tag minigames hinzu. Der Name des Tags und der Ordnername müssen übereinstimmen.

​
Konflikte zwischen Template-Ordnern vermeiden

Ein Server kann zu mehreren Template-Ordnern passen. SimpleCloud kopiert die passenden Template-Ordner in dieser Reihenfolge:
  1. templates/_every/every/
  2. Der passende Servertyp-Ordner, zum Beispiel templates/_every/every_server/
  3. Die zugeordnete Softwarefamilie, zum Beispiel templates/_every/every_paper/ für Purpur
  4. Der exakte Softwareordner, zum Beispiel templates/_every/every_purpur/
  5. Jeder passende Ordner in templates/_tagged/
  6. Der benannte Ordner, zum Beispiel templates/lobby/
Wenn derselbe relative Pfad mehrfach vorkommt, bleibt die zuerst kopierte Datei erhalten. Spätere Ordner ersetzen sie nicht. templates/lobby/server.properties überschreibt beispielsweise templates/_every/every/server.properties nicht. Lege jede Datei nur in einem passenden Template-Ordner ab, damit das Ergebnis vorhersehbar bleibt. Verlasse dich nicht auf die Reihenfolge mehrerer passender Tag-Ordner, die denselben Pfad enthalten. Der Ordner templates/cache/ wird von SimpleCloud verwaltet und sollte nicht für eigene Template-Dateien verwendet werden.

​
Templates auf mehreren Serverhosts verwenden

Templates gehören zu dem Serverhost, auf dem sie gespeichert sind. Wenn eine Gruppe auf mehreren Serverhosts laufen kann, benötigt jeder davon dieselben Template-Dateien. Verwende die Anleitung SimpleCloud auf mehreren Maschinen ausführen, um den Ordner templates zwischen ihnen zu synchronisieren.

​
Fehlerbehebung

Prüfe, ob der Ordner zum Gruppennamen, Tag, zur Software oder zum Servertyp passt. Vergleiche danach den Pfad unterhalb des Template-Ordners mit dem erwarteten Pfad innerhalb des Servers. Starte nach Änderungen einen neuen Gruppenserver.
Templates verändern keinen laufenden Server. Stoppe bei einer Gruppe den aktuellen Server und starte einen weiteren. Bearbeite bei einem persistenten Server eine vorhandene Datei direkt, da Templates nur fehlende Dateien hinzufügen.
Suche in den anderen passenden Template-Ordnern nach demselben relativen Pfad. Die erste passende Kopie bleibt erhalten. Entferne daher das Duplikat oder belasse die Datei im früher angewendeten gemeinsamen Ordner.
Stelle sicher, dass das Tag der Gruppe oder dem persistenten Server zugewiesen ist und seine Schreibweise mit dem Ordner unter templates/_tagged/ übereinstimmt.
Synchronisiere den Ordner templates auf allen Serverhosts, auf denen die Gruppe laufen kann.