Tidewrack · Dedicated Server

Your world, always afloat.

A practical guide to installing, configuring and maintaining a private Tidewrack server on Windows or Linux.

Deine Welt, immer über Wasser.

Eine praktische Anleitung für Installation, Einrichtung und Betrieb eines privaten Tidewrack-Servers unter Windows oder Linux.

Release status: Tool app 5243500 is the server download; game app 5035340 is used at runtime. Public anonymous SteamCMD access is not promised until the Tool release is live and verified. Until then, use an account that has access.
Veröffentlichungsstatus: Tool-App 5243500 liefert den Server; Spiel-App 5035340 wird zur Laufzeit verwendet. Öffentlicher anonymer SteamCMD-Zugriff wird erst nach Freigabe und Prüfung des Tools zugesagt. Bis dahin ist ein berechtigtes Konto nötig.

Install

  1. Install SteamCMD following Valve’s official SteamCMD documentation.
  2. Choose an empty install directory outside your save-data directory.
  3. Sign in with an account that currently has access, then install and validate Tool app 5243500.

Installation

  1. SteamCMD nach der offiziellen Valve-Anleitung installieren.
  2. Ein leeres Installationsverzeichnis außerhalb des Spielstandordners wählen.
  3. Mit einem derzeit berechtigten Konto anmelden, dann Tool-App 5243500 installieren und prüfen.
steamcmd +login YOUR_STEAM_ACCOUNT +force_install_dir /opt/tidewrack/server +app_update 5243500 validate +quit

Windows

Run start-server.bat from the package root. It starts the bundled executable and writes logs outside the update directory.

Windows

start-server.bat im Paketordner starten. Das Skript verwendet die mitgelieferte EXE und schreibt Logs außerhalb des Updateverzeichnisses.

Linux

Run /bin/bash ./start-server.sh. The launcher supplies the bundled Steam runtime libraries.

Linux

/bin/bash ./start-server.sh ausführen. Der Launcher bindet die mitgelieferten Steam-Laufzeitbibliotheken ein.

Configure

Set environment variables in the service account or service manager. Keep the password out of command lines and public files. The defaults below create world slot 1 on UDP 7777; Steam queries use UDP 7778.

Einrichtung

Umgebungsvariablen im Dienstkonto oder Service-Manager setzen. Das Passwort gehört nicht in Befehlszeilen oder öffentliche Dateien. Die Vorgaben starten Welt 1 auf UDP 7777; Steam-Abfragen verwenden UDP 7778.

TIDEWRACK_SERVER_PASSWORD=replace-with-a-secret
TIDEWRACK_WORLD_SLOT=1
TIDEWRACK_PORT=7777
TIDEWRACK_MAX_PLAYERS=16
TIDEWRACK_AUTOSAVE=90
TIDEWRACK_EMPTY_TIMEOUT=600
TIDEWRACK_SERVER_NAME=Tidewrack Server

TIDEWRACK_SHARKS_ENABLED=true
TIDEWRACK_SHARK_FREQUENCY=1.0
TIDEWRACK_SHARK_SPEED=1.0
TIDEWRACK_SHARK_POWER=1.0
TIDEWRACK_RAIDERS_ENABLED=true
TIDEWRACK_LEVIATHAN_ENABLED=true

The supplied example.env is a template and is not loaded automatically. On Linux, copy it to a private file, edit it, then load it into the service shell:

cp example.env server.env
chmod 600 server.env
set -a; . ./server.env; set +a
/bin/bash ./start-server.sh

On Windows PowerShell, set variables for the current process before starting the launcher:

$env:TIDEWRACK_SERVER_PASSWORD = "replace-with-a-secret"
$env:TIDEWRACK_WORLD_SLOT = "1"
./start-server.bat

Die mitgelieferte example.env ist eine Vorlage und wird nicht automatisch geladen. Unter Linux in eine private Datei kopieren, bearbeiten und in die Dienst-Shell laden:

cp example.env server.env
chmod 600 server.env
set -a; . ./server.env; set +a
/bin/bash ./start-server.sh

Unter Windows PowerShell die Variablen vor dem Launcher für den aktuellen Prozess setzen:

$env:TIDEWRACK_SERVER_PASSWORD = "replace-with-a-secret"
$env:TIDEWRACK_WORLD_SLOT = "1"
./start-server.bat

Boolean values accept true/false, 1/0, yes/no or on/off. Shark frequency accepts 0.50–2.00; speed and power accept 0.50–1.50. Frequency scales the delay between shark events, so a larger value means fewer attacks. Invalid values stop startup instead of silently changing the rules.

Boolesche Werte akzeptieren true/false, 1/0, yes/no oder on/off. Hai-Häufigkeit erlaubt 0,50–2,00; Geschwindigkeit und Stärke erlauben 0,50–1,50. Die Häufigkeit skaliert den Abstand zwischen Hai-Ereignissen: Ein größerer Wert bedeutet weniger Angriffe. Ungültige Werte brechen den Start ab.

PlatformDefault data and save location
Windows%LOCALAPPDATA%\Tidewrack-Dedicated\Tidewrack\server\<slot>
Linux${XDG_DATA_HOME:-$HOME/.local/share}/Tidewrack-Dedicated/Tidewrack/server/<slot>

Operate and back up

The server autosaves the world and player profiles together. Use the local command utility from the same OS account as the server. It is a local file channel, not remote administration.

Betrieb und Sicherungen

Der Server speichert Welt und Spielerprofile gemeinsam. Das lokale Befehlswerkzeug muss unter demselben Betriebssystemkonto laufen. Es ist ein lokaler Dateikanal, keine Fernadministration.

# Windows PowerShell
./server-command.ps1 -RequestId manual-save -Command "save"
./server-command.ps1 -RequestId backup-01 -Command "backup"
./server-command.ps1 -RequestId stop-01 -Command "shutdown"

# Linux
./server-command.sh --id manual-save --command save
./server-command.sh --id backup-01 --command backup
./server-command.sh --id stop-01 --command shutdown

Available commands are status, save, backup, kick PEER, ban STEAMID and shutdown. Keep the entire slot directory when making an external backup.

Verfügbar sind status, save, backup, kick PEER, ban STEAMID und shutdown. Für eine externe Sicherung den gesamten Slot-Ordner kopieren.

Update safely

  1. Run shutdown and wait for the server process to exit. This writes the final checkpoint and backup.
  2. Copy the world-slot data directory to separate storage.
  3. Run SteamCMD with app_update 5243500 validate.
  4. Start the launcher and check the slot log for DEDICATED_WORLD_READY before players reconnect.

Sicher aktualisieren

  1. shutdown senden und warten, bis der Prozess beendet ist. Dabei entstehen letzter Checkpoint und Sicherung.
  2. Den Datenordner des Welt-Slots auf getrennten Speicher kopieren.
  3. SteamCMD mit app_update 5243500 validate ausführen.
  4. Launcher starten und vor dem Beitritt im Slot-Log auf DEDICATED_WORLD_READY prüfen.

Troubleshooting

Server is not visible or reachable

Allow inbound UDP on the gameplay port and the following query port: 7777 and 7778 by default. Check host firewall, router forwarding and provider firewall separately. Public Internet browser discovery remains subject to the current Tool release verification.

Steam initialization fails

Keep the package’s matching executable, PCK and Steam runtime libraries together. Do not replace them with older redistributables. Confirm that steam_appid.txt contains runtime game AppID 5035340.

The server starts with the wrong world

Check TIDEWRACK_WORLD_SLOT and the data root used by the service account. Updates do not move saves from one OS account to another.

A rule is rejected

Check spelling and bounds. The log identifies startup failures; malformed booleans and out-of-range shark factors are rejected.

Fehlersuche

Server ist nicht sichtbar oder erreichbar

Eingehendes UDP für Spiel- und nachfolgenden Query-Port erlauben: standardmäßig 7777 und 7778. Host-Firewall, Routerweiterleitung und Provider-Firewall getrennt prüfen. Die öffentliche Internet-Browser-Sichtbarkeit hängt weiterhin von der abschließenden Tool-Freigabeprüfung ab.

Steam-Initialisierung schlägt fehl

Passende EXE bzw. x86_64-Datei, PCK und Steam-Laufzeitbibliotheken aus demselben Paket zusammenlassen. Keine älteren Redistributables darüberkopieren. steam_appid.txt muss die Laufzeit-Spiel-ID 5035340 enthalten.

Die falsche Welt startet

TIDEWRACK_WORLD_SLOT und den Datenpfad des Dienstkontos prüfen. Updates verschieben keine Spielstände zwischen Betriebssystemkonten.

Eine Spielregel wird abgelehnt

Schreibweise und Wertebereich prüfen. Das Log nennt Startfehler; ungültige Bool-Werte und Hai-Faktoren außerhalb der Grenzen werden abgewiesen.