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

# Persistente Server

> Erstelle einzelne Server-Instanzen, die ihre Identität und Daten über Neustarts hinweg behalten.

<Info>
  Soll SimpleCloud mehrere austauschbare Server je nach Spielerbedarf erstellen? Nutze stattdessen [Server-Gruppen](/docs/de/manual/setup/server-groups).
</Info>

## Wann du einen persistenten Server verwendest

| Nutze einen persistenten Server, wenn ...       | Nutze eine Gruppe, wenn ...                                     |
| ----------------------------------------------- | --------------------------------------------------------------- |
| Der Server langlebige Weltdaten hat             | Server aus einer gemeinsamen Vorlage neu erstellt werden können |
| Du einen benannten Server wie `survival` willst | Du mehrere Instanzen wie `lobby-1`, `lobby-2` willst            |
| Du den Serverhost beim Setup auswählst          | SimpleCloud Server auf Hosts verteilen soll                     |
| Du planbare, manuelle Kapazität willst          | Du automatische Skalierung willst                               |

## Persistenten Server erstellen

<Steps>
  <Step title="Server-Wizard öffnen">
    Öffne im Dashboard **Persistent Servers** und klicke auf **Add Server**.
  </Step>

  <Step title="Grunddaten festlegen">
    Lege fest, wie der Server heißt und wofür er verwendet wird:

    * **Name**: Verwende einen stabilen Namen wie `survival`, `spawn` oder `build`. Namen dürfen bis zu 100 ASCII-Buchstaben, Ziffern, Unterstriche und Bindestriche (`[A-Za-z0-9_-]`) enthalten und sind innerhalb des Netzwerks ohne Rücksicht auf Groß-/Kleinschreibung eindeutig — `Survival-1` und `survival-1` gelten als derselbe Name.
    * **Type**: Wähle **Server** für Game-Server oder **Proxy** für Load Balancer.
    * **Server host**: Wähle die Maschine, die diesen Server ausführen soll.
    * **Activate on creation**: Aktiviere dies, wenn der Server sofort starten soll.
  </Step>

  <Step title="Software auswählen">
    Wähle Server-Software und Version. Für eigene Server-JARs kannst du eine direkte Download-URL angeben.

    Für Game-Server wählst du außerdem den Configurator, der die Server-Dateien vorbereitet.
  </Step>

  <Step title="Ressourcen festlegen">
    Konfiguriere die Ressourcen für diesen Server:

    * **Memory**: Minimaler und maximaler Speicher in MB.
    * **Max players**: Spielerlimit für diesen Server.
  </Step>

  <Step title="Proxy-Netzwerk konfigurieren">
    Für Proxy-Server legst du den **Port** für eingehende Spieler-Verbindungen fest.
  </Step>

  <Step title="Plugins hinzufügen">
    Füge Plugins von Modrinth, Hangar, Spigot, direkten URLs oder deinen konfigurierten Plugin-Quellen hinzu. Du kannst Plugins auch später in den Server-Einstellungen ergänzen.
  </Step>

  <Step title="Prüfen und erstellen">
    Prüfe die Zusammenfassung und klicke auf **Create Server**.

    <Check>
      Wenn der Server aktiv ist, sollte SimpleCloud eine laufende Instanz für diesen persistenten Server starten oder online halten.
    </Check>
  </Step>
</Steps>

## Serverstatus verstehen

| Status       | Bedeutung                                  | Prüfen                                                           |
| ------------ | ------------------------------------------ | ---------------------------------------------------------------- |
| **Active**   | Der Server ist aktiviert und sollte laufen | Host-Verfügbarkeit und Server-Logs, wenn keine Instanz startet   |
| **Inactive** | Der Server ist deaktiviert                 | In den allgemeinen Einstellungen aktivieren, wenn er laufen soll |

## Bestehenden persistenten Server konfigurieren

<AccordionGroup>
  <Accordion title="Allgemeine Einstellungen">
    Aktiviere oder deaktiviere den Server, passe Speicher an, ändere das Spielerlimit und füge Tags zum Filtern hinzu.
  </Accordion>

  <Accordion title="Deployment">
    Persistente Server laufen auf einem zugewiesenen Serverhost. Ändere diesen nur, wenn du den Server bewusst auf eine andere Maschine verschiebst.

    <Warning>
      Das Verschieben eines persistenten Servers verschiebt lokale Weltdaten nicht automatisch. Kopiere benötigte Daten, bevor du den Server auf einem neuen Host startest.
    </Warning>
  </Accordion>

  <Accordion title="Blueprint">
    Ändere die Server-Vorlage, zum Beispiel Software-Version, Configurator-Einstellungen, JVM-Optionen und Runtime-Argumente.

    Starte den laufenden Server neu, wenn er Blueprint-Änderungen übernehmen soll.
  </Accordion>

  <Accordion title="Properties">
    Füge eigene Key-Value-Daten hinzu, die Plugins und Integrationen lesen können.

    Properties werden dem laufenden Server als `SIMPLECLOUD_`-Umgebungsvariablen bereitgestellt.
  </Accordion>

  <Accordion title="Workflows">
    Konfiguriere Automatisierung für Server-Lifecycle-Events:

    * **Manual workflows**: Manuell ausführen.
    * **On start workflows**: Beim Start des Servers ausführen.
    * **On stop workflows**: Beim Stoppen des Servers ausführen.
  </Accordion>

  <Accordion title="Plugins">
    Füge Plugins hinzu, prüfe installierte Plugins oder entferne sie für den Server.

    Plugin-Änderungen gelten je nach Plugin- und Workflow-Setup beim nächsten Vorbereiten oder Neustarten des Servers.
  </Accordion>

  <Accordion title="Danger zone">
    Lösche den persistenten Server erst, nachdem du benötigte lokale Daten gesichert hast.

    <Warning>
      Das Dashboard deaktiviert den persistenten Server, wartet bis die laufende Instanz gestoppt ist, und löscht danach den persistenten Server und den zugehörigen Blueprint. Es sichert oder migriert lokale Weltdaten nicht automatisch.
    </Warning>
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Server startet nicht">
    **Wahrscheinliche Ursache:** Der Server ist inaktiv, der zugewiesene Host ist nicht verfügbar oder der Host hat keine Kapazität.

    **Das solltest du prüfen:**

    1. Prüfe, ob der Server aktiv ist.
    2. Prüfe den zugewiesenen Serverhost mit `sc status serverhost`.
    3. Prüfe freien Speicher auf dem Host.
    4. Prüfe Logs mit `sc logs serverhost`.
  </Accordion>

  <Accordion title="Weltdaten fehlen nach Host-Wechsel">
    **Wahrscheinliche Ursache:** Der persistente Server wurde einem neuen Host zugewiesen, ohne lokale Dateien zu kopieren.

    **Das solltest du prüfen:**

    1. Stoppe den Server.
    2. Kopiere Welt- und Plugin-Daten vom alten Host auf den neuen Host.
    3. Starte den Server wieder.
  </Accordion>

  <Accordion title="Plugin-Änderungen erscheinen nicht">
    **Wahrscheinliche Ursache:** Der laufende Server wurde noch nicht mit der aktualisierten Plugin-Liste neu gestartet oder vorbereitet.

    Starte den Server nach Plugin-Änderungen neu und prüfe anschließend die Logs auf Plugin-Ladefehler.
  </Accordion>
</AccordionGroup>