> For the complete documentation index, see [llms.txt](https://docs.instantroot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instantroot.de/gameserver/hytale/mit-dem-hytale-server-verbinden.md).

# Mit dem Hytale Server verbinden

In diesem Artikel erklären wir dir, wie du dich mit deinem Hytale Server verbindest und wo du die benötigte Serveradresse im INSTANTPANEL findest.

Damit die Verbindung funktioniert, muss dein Hytale Server gestartet sein. Außerdem müssen Client und Server zueinander passen. Wenn der Server eine andere Version verwendet als dein Spiel, kann die Verbindung fehlschlagen.

### Voraussetzungen

Bevor du dich verbindest, benötigst du:

* einen gestarteten Hytale Server
* die Serveradresse aus dem INSTANTPANEL
* den Server-Port, falls dieser zusätzlich angegeben ist
* einen Hytale Account
* einen installierten Hytale Client
* eine passende Spielversion

Hytale unterstützt neben normalen Multiplayer-Sitzungen auch dedizierte Server. Ein dedizierter Server läuft unabhängig von einem einzelnen Spieler und ist dafür gedacht, dauerhaft für mehrere Spieler erreichbar zu sein. Die offizielle Hytale-Dokumentation unterscheidet dabei zwischen normalen Freundes-Sitzungen und dedizierten Servern. Bei Freundes-Sitzungen kann ein Host eine Welt öffnen und einen Share Code erzeugen. Bei einem Hosting-Server verbindest du dich dagegen über die Serveradresse deines Servers.

### Serveradresse im INSTANTPANEL finden

Die Serveradresse findest du direkt im INSTANTPANEL.

1. Öffne das INSTANTPANEL.
2. Melde dich mit deiner E-Mail-Adresse und deinem Passwort an.
3. Wähle deinen Hytale Server aus.
4. Öffne die Serverübersicht.
5. Kopiere die angezeigte Serveradresse.

Eine Serveradresse besteht meistens aus einer IP-Adresse und einem Port.

Beispiel: `123.123.123.123:5520`

Der Teil vor dem Doppelpunkt ist die IP-Adresse. Der Teil nach dem Doppelpunkt ist der Port.

| Bestandteil       | Bedeutung               |
| ----------------- | ----------------------- |
| `123.123.123.123` | IP-Adresse des Servers  |
| `5520`            | Port des Hytale Servers |

**Wichtig:** Kopiere die Serveradresse möglichst direkt aus dem INSTANTPANEL. Tippfehler, Leerzeichen oder ein falscher Port führen häufig dazu, dass der Server nicht erreichbar ist.

### Mit dem Hytale Server verbinden

Öffne zuerst den Hytale Client und melde dich mit deinem Hytale Account an.

Der genaue Menüpunkt kann sich je nach Version ändern. Suche im Spiel nach einem Bereich für Multiplayer, Server, direkte Verbindung oder Serveradresse.

Typischer Ablauf:

1. Starte Hytale.
2. Melde dich mit deinem Hytale Account an.
3. Öffne den Multiplayer- oder Serverbereich.
4. Wähle die Option zum direkten Verbinden oder zum Hinzufügen eines Servers.
5. Trage die Serveradresse aus dem INSTANTPANEL ein.
6. Gib den Port ein, falls dieser separat abgefragt wird.
7. Speichere den Server oder verbinde dich direkt.
8. Warte, bis die Verbindung hergestellt wurde.

Beispiel für eine vollständige Adresse: `123.123.123.123:5520`

Wenn Adresse und Port getrennt eingegeben werden, sieht es so aus:

| Feld          | Beispiel          |
| ------------- | ----------------- |
| Serveradresse | `123.123.123.123` |
| Port          | `5520`            |

**Hinweis:** Die Benutzeroberfläche von Hytale kann sich im Early Access ändern. Wenn die Menüpunkte anders heißen, suche nach Begriffen wie „Multiplayer“, „Server“, „Join“, „Direct Connect“ oder „Server Address“.

### Server muss gestartet sein

Dein Hytale Server muss im INSTANTPANEL gestartet sein, bevor du dich verbinden kannst.

Wenn der Server ausgeschaltet ist, kann der Client keine Verbindung herstellen.

Prüfe deshalb zuerst:

* Serverstatus im INSTANTPANEL
* Konsole des Servers
* Startvorgang
* Fehlermeldungen im Log
* ob der Server vollständig hochgefahren ist

Ein Server kann nach dem Start einige Zeit benötigen, bis er vollständig erreichbar ist.

### Version prüfen

Client und Server müssen zueinander passen.

Wenn dein Hytale Client eine andere Version verwendet als dein Server, kann die Verbindung fehlschlagen oder der Server wird als nicht kompatibel angezeigt.

Prüfe bei Verbindungsproblemen:

* wurde Hytale im Client aktualisiert?
* wurde der Server bereits aktualisiert?
* läuft der Server noch auf einer älteren Version?
* gab es kurz vorher ein Update?
* wurde der Server nach einem Update neu gestartet?

Wenn gerade ein Update erschienen ist, kann es kurzzeitig zu Versionsunterschieden kommen.

### Unterschied zwischen Share Code und dediziertem Server

Hytale kann verschiedene Arten von Multiplayer unterstützen.

Bei einer privaten Freundes-Sitzung kann ein Spieler seine Welt öffnen und einen Share Code weitergeben. Andere Spieler treten dann über diesen Code bei.

Bei einem dedizierten Server läuft die Welt dauerhaft auf einem Server. Spieler verbinden sich über eine Serveradresse.

| Verbindung    | Erklärung                                                             |
| ------------- | --------------------------------------------------------------------- |
| Share Code    | Für private Sitzungen, die von einem Spieler geöffnet werden          |
| Serveradresse | Für dedizierte Server, die dauerhaft über IP und Port erreichbar sind |

Wenn du einen Hytale Gameserver bei INSTANTROOT nutzt, verwendest du normalerweise die Serveradresse aus dem INSTANTPANEL.

### Verbindung über eine Domain

Du kannst deinen Hytale Server auch über eine Domain erreichbar machen.

Beispiel: `play.deinedomain.de`

Dafür müssen passende DNS-Einträge gesetzt werden.

Wenn dein Server einen eigenen Port nutzt, muss der Port entweder mit angegeben oder über passende DNS-Einstellungen abgebildet werden.

Beispiel mit Port: `play.deinedomain.de:5520`

**Hinweis:** DNS-Änderungen sind nicht sofort überall aktiv. Es kann einige Minuten bis mehrere Stunden dauern, bis eine Domain korrekt aufgelöst wird.

### Öffentlicher und privater Server

Je nach Einstellung kann ein Hytale Server öffentlich oder privat genutzt werden.

Ein öffentlicher Server ist für mehr Spieler gedacht und kann je nach Konfiguration leichter erreichbar sein.

Ein privater Server ist nur für ausgewählte Spieler gedacht. In diesem Fall kann eine Einladung, Freigabe oder Zugriffsbeschränkung erforderlich sein.

Wenn Spieler nicht beitreten können, prüfe:

* ist der Server öffentlich erreichbar?
* gibt es eine Whitelist oder Zugriffsbeschränkung?
* wurde der Spieler zugelassen?
* ist die Serveradresse korrekt?
* ist der richtige Port angegeben?

### Häufige Probleme

#### Server wird als offline angezeigt

Prüfe zuerst:

* Ist der Server im INSTANTPANEL gestartet?
* Ist der Startvorgang abgeschlossen?
* Ist die Serveradresse korrekt?
* Ist der Port korrekt?
* Verwendest du die passende Hytale-Version?
* Gibt es Fehlermeldungen in der Konsole?

Wenn der Server gerade gestartet wurde, warte kurz und versuche es erneut.

#### Verbindung schlägt fehl

Wenn die Verbindung fehlschlägt, liegt das häufig an einer falschen Adresse, einem falschen Port oder einer nicht passenden Version.

Prüfe:

* keine Leerzeichen in der Serveradresse
* richtige IP-Adresse
* richtiger Port
* Server ist online
* Client ist aktuell
* Server ist aktuell
* keine Fehlermeldungen beim Serverstart

#### Verbindung läuft in einen Timeout

Ein Timeout bedeutet, dass keine rechtzeitige Verbindung zum Server hergestellt werden konnte.

Mögliche Ursachen:

* Server ist nicht erreichbar
* Server ist überlastet
* falsche Adresse
* falscher Port
* Server startet noch
* Netzwerkproblem
* Verbindung wird blockiert

Prüfe den Serverstatus im INSTANTPANEL und starte den Server bei Bedarf neu.

#### Verbindung wird abgelehnt

Wenn die Verbindung abgelehnt wird, kann der Server zwar erreichbar sein, nimmt deine Verbindung aber nicht an.

Mögliche Ursachen:

* Server ist noch nicht vollständig gestartet
* Server ist voll
* Spieler ist nicht freigeschaltet
* Zugriffsbeschränkung aktiv
* falsche Version
* Serverfehler im Hintergrund

Prüfe die Konsole und die Logs im INSTANTPANEL.

#### Falsche Version

Wenn Client und Server nicht zusammenpassen, kann der Beitritt blockiert werden.

Lösung:

* Hytale Client aktualisieren
* Server aktualisieren
* Server neu starten
* prüfen, ob ein Update gerade erst erschienen ist

#### Server ist voll

Wenn das Spielerlimit erreicht ist, können weitere Spieler nicht beitreten.

Prüfe im INSTANTPANEL oder in der Serverkonfiguration:

* maximale Spielerzahl
* aktuelle Spielerzahl
* reservierte Slots, falls vorhanden
* Zugriffsbeschränkungen

#### Spieler hat keine Berechtigung

Wenn ein Spieler nicht beitreten darf, kann eine Rechte- oder Zugriffseinstellung aktiv sein.

Prüfe:

* Whitelist
* Rollen
* Berechtigungen
* private Servereinstellungen
* Einladungen oder Freigaben

#### Mods oder Inhalte fehlen

Hytale ist stark auf eigene Inhalte und Modding ausgelegt. Je nach Serverkonfiguration können beim Verbinden zusätzliche Inhalte erforderlich sein.

Wenn die Verbindung wegen fehlender Inhalte fehlschlägt, prüfe:

* wurden serverseitige Inhalte korrekt installiert?
* sind Mods oder Asset Packs beschädigt?
* passen Client und Server zusammen?
* zeigt die Konsole Fehler beim Laden von Inhalten?
* wurde nach Änderungen ein Neustart durchgeführt?

### Gute erste Prüfung bei Problemen

Wenn du dich nicht verbinden kannst, gehe so vor:

1. Server im INSTANTPANEL öffnen.
2. Prüfen, ob der Server gestartet ist.
3. Serveradresse direkt aus dem Panel kopieren.
4. Port prüfen.
5. Hytale Client neu starten.
6. Version prüfen.
7. Serverkonsole auf Fehler prüfen.
8. Server neu starten.
9. Verbindung erneut testen.

Ändere nicht mehrere Einstellungen gleichzeitig. Sonst ist später schwer nachvollziehbar, welche Änderung geholfen oder ein neues Problem verursacht hat.