Wie man einen Cyberpunk-2077-Server mit Open77 erstellt

Open77 (OPEN//77) ist die Community-Multiplayer-Plattform für Cyberpunk 2077. Deinen eigenen Cyberpunk-2077-Server zu hosten ermöglicht dir:

• Zu mehreren in Night City zu spielen: Roleplay, Freeroam, Deathmatch oder Battle Royale.
• Eigene Spielmodi mit Lua-5.4-Ressourcen und Web-Oberflächen (WebUI) zu erstellen.
• Die Welt individuell zu gestalten: Fahrzeuge, Karten, NPCs, Cyberware, Wetter und Mods, die automatisch an die Spieler verteilt werden.
• Von Anfang an eine Community rund um eine noch junge Multiplayer-Szene aufzubauen, in der noch Platz ist, sich einen Namen zu machen.

Open77 funktioniert nach demselben Prinzip wie FiveM für GTA V: ein dedizierter Server, ein kostenloser Lizenzschlüssel, ein webbasiertes Admin-Panel und skriptbasierte Ressourcen. Der Server wird spielbereit mit dem Freeroam-Modus geliefert: Du kannst in wenigen Minuten eine Welt öffnen und sie dann weiterentwickeln.

Der Open77-Server ist bewusst leichtgewichtig: Er benötigt weder Cyberpunk 2077 noch die REDengine noch Spieldaten. Prüfe diese Punkte, bevor du beginnst:

• ✔ System : Windows x64 oder Linux x64 (Debian), die .NET-Runtime ist im Archiv enthalten: nichts weiter zu installieren
• ✔ Hardware : Die offizielle Dokumentation legt kein Minimum fest; als Richtwert reicht ein VPS mit 2 bis 4 Kernen und 4 GB RAM zum Start, je nach deinen Lua-Ressourcen und der Spielerzahl zu erhöhen
• ✔ Spiel : Auf der Server-Maschine ist keine Installation von Cyberpunk 2077 nötig
• ✔ Spieler : Jeder Spieler braucht Cyberpunk 2077 in Version 2.31 mit der Erweiterung Phantom Liberty, auf 64-Bit-Windows 10 oder 11, sowie einen Alpha-Zugang
• ✔ Hosting : Dein eigener PC zum Testen, dann ein VPS oder dedizierter Server für einen 24/7-Server

Um den Server herunterzuladen und beim Open77-Master zu registrieren, benötigst du ein Konto mit Alpha-Zugang und einen über den Keymaster generierten Lizenzschlüssel.

/alpha apply

Der dedizierte Open77-Server wird von der Host-Seite der offiziellen Website heruntergeladen. Das Archiv enthält den Server und seine .NET-Runtime, den spielbereiten Freeroam-Modus, Warden (Einrichtungsassistent und Web-Panel) und die Lua-5.4-Runtime.

1. Gehe mit deinem Alpha-Konto zu open2077.net/host und wähle den Stable-Kanal (empfohlen) statt Unstable
2. Lade das Archiv für dein System herunter: .zip für Windows, .tar.gz für Linux, und überprüfe den auf der Seite angezeigten SHA-256-Hash
3. Entpacke das Archiv in einen eigenen Ordner für deinen Server
4. Starte Start.cmd unter Windows oder ./start.sh unter Linux (oder direkt die ausführbare Datei Open77.Server)

Den Lizenzschlüssel angeben

Die empfohlene Methode besteht darin, den Schlüssel über die Umgebungsvariable OP77_LICENSE_KEY zu übergeben, damit er nie im Klartext in einer Konfigurationsdatei steht:

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

$env:OP77_LICENSE_KEY = "op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
.\Start.cmd

Warden ist das webbasierte Admin-Panel, das mit dem Open77-Server ausgeliefert wird, das Äquivalent zu txAdmin für FiveM. Beim ersten Start öffnet sich im Browser ein Einrichtungsassistent, falls noch keine server.jsonc-Datei existiert.

http://localhost:11780

Die Datei server.jsonc (JSON mit Kommentaren) enthält die gesamte Serverkonfiguration. Der Assistent erstellt automatisch eine; hier die wichtigsten Blöcke, die du kennen solltest:

{
  "identity": {
    "name": "Night City RP",
    "visibility": "public"
  },
  "network": {
    "port": 11778,
    "publicEndpoint": "play.example.com:11778"
  },
  "query": {
    "enabled": true,
    "map": "Night City",
    "gamemode": "Freeroam"
  },
  "masterServer": {
    "enabled": true,
    "url": "https://master.open2077.net/",
    "licenseKey": null,
    "licenseKeyEnvironmentVariable": "OP77_LICENSE_KEY"
  },
  "warden": {
    "enabled": true,
    "bind": "127.0.0.1:11780"
  }
}

• identity.name - Servername, der im Serverbrowser des Launchers angezeigt wird
• identity.visibility - Sichtbarkeit im Verzeichnis: public (gelistet), unlisted oder private (nur auf Einladung)
• network.port / network.publicEndpoint - UDP-Spielport (standardmäßig 11778) und öffentliche Adresse, über die Spieler sich verbinden
• query - Aktiviert die Abfrage von Serverinformationen und legt die angezeigte Karte und den Spielmodus fest
• masterServer - Registrierung beim Open77-Master; lasse licenseKey auf null, um den Schlüssel aus der Variable OP77_LICENSE_KEY zu lesen
• warden.bind - Lauschadresse des Warden-Panels, lokal halten

Startargumente

Auf einem VPS kannst du auch alles als Startargumente übergeben: --no-setup überspringt den Assistenten, --public-ip gibt deine öffentliche IP an und --max-players legt die maximale Spielerzahl fest. Füge --check-config hinzu, um die Konfiguration zu prüfen, ohne den Server zu starten.

./Open77.Server --no-setup --config server.jsonc \
  --public-ip 203.0.113.10 --port 11778 --max-players 32 \
  --log-level info

Der gesamte Inhalt deines Servers (Spielmodi, HUD, Skripte, Karten, Fahrzeuge) hat die Form von Ressourcen: Pakete aus Lua-5.4-Skripten, Berechtigungen und Webdateien, die der Server lädt und an die Spieler verteilt. Sie sind nach Kategorie im Ordner resources/ sortiert:

resources/
  system/       official platform resources
  gamemodes/    playable modes and HUDs
  dev/          examples and harnesses
  assets/
    loaders/    archivexl, tweakxl
    maps/       world packages
    vehicles/   vehicle packages
    mods/       third-party packages

Das Manifest open77.lua

Jede Ressource besitzt eine Datei open77.lua, die ihren Namen, ihre Version, ihre Server-, Client- und geteilten Skripte, ihre Web-Oberfläche und die benötigten Berechtigungen deklariert. Server-Skripte werden niemals an Spieler gesendet.

resource "garage"
version "1.0.0"
auto_start true

shared_script "shared/config.lua"
server_script "server/main.lua"
client_script "client/main.lua"

web_ui_page "web/index.html"
web_files { "web/**" }
permissions { "network.events" }

Ressourcen über die Konsole verwalten

Nachdem du einen Ordner hinzugefügt hast, scanne die Manifeste mit refresh neu und starte die Ressource dann mit ensure. Die Befehle start, stop, restart und resources (Liste) sind ebenfalls verfügbar, genauso wie das Hot-Reload über Warden.

refresh
ensure garage
restart garage
stop garage

Kommst du von FiveM?

Open77 übernimmt viele Konzepte von FiveM und bietet Kompatibilitäts-Aliase: Citizen.CreateThread, Wait, RegisterCommand, Events und Exports funktionieren, und fxmanifest.lua wird zu open77.lua. Die GTA-Natives (Citizen.InvokeNative, RequestModel, RequestAnimDict) existieren dagegen nicht: Ein FiveM-Skript muss angepasst werden, nicht einfach kopiert. Falls du neu bei FiveM bist, schau auch in unseren Guide zum Erstellen eines FiveM-Servers.

MySQL- / MariaDB-Datenbank

Um Daten zu speichern (Charaktere, Inventare, Fahrzeuge), aktiviere den Block database in server.jsonc. Nur MySQL und MariaDB werden unterstützt. Die Verbindungszeichenfolge im MySqlConnector-Format wird vorzugsweise über die Variable OP77_DATABASE_CONNECTION übergeben, und jede Ressource, die darauf zugreift, muss die Berechtigung database.access deklarieren.

Server=127.0.0.1;Port=3306;Database=open77;User ID=open77;Password=SECRET;

Open77 kann die von deinem Server benötigten Mods (ArchiveXL, TweakXL, Fahrzeuge, Karten) automatisch installieren, bevor das Spiel startet: Die Spieler müssen nichts manuell tun und müssen zum Beitreten nicht neu starten.

Die drei Sicherheitsstatus

• Verified - vom Open77-Team geprüfter Mod, jede Art von Inhalt erlaubt (auch ausführbare Dateien), von der Plattform verteilt
• Unverified - nur inerte Daten werden akzeptiert (.archive, .tweak, .xl, Engine-INI-Dateien), von deinem Server gehostet
• Blocked - abgelehnter Mod: Spieler können keinem Server beitreten, der ihn voraussetzt

Open77 nutzt einen UDP-Port für das Spiel und einen TCP-Port, über den Spieler Ressourcen herunterladen. Damit dein Server aus dem Internet erreichbar ist, müssen beide Ports offen sein.

Zu öffnende Ports

• UDP 11778 (Standard): Spielverkehr, anpassbar über network.port oder --port
• TCP 11779 (Standard): Download von Ressourcen und Mods durch Spieler
• TCP 11780 : Warden-Panel, lokal halten, nicht öffentlich öffnen

Beispiele für Firewall-Regeln

Windows Defender :

New-NetFirewallRule -DisplayName "Open77 Game" -Direction Inbound -Protocol UDP -LocalPort 11778 -Action Allow
New-NetFirewallRule -DisplayName "Open77 Downloads" -Direction Inbound -Protocol TCP -LocalPort 11779 -Action Allow

Linux UFW :

sudo ufw allow 11778/udp
sudo ufw allow 11779/tcp

Linux iptables :

sudo iptables -A INPUT -p udp --dport 11778 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 11779 -j ACCEPT

Warden zentralisiert die Administration deines Cyberpunk-2077-Servers über den Browser:

• Live-Konsole: Logs lesen und Server-Befehle ausführen
• Spielermoderation: verwarnen, kicken, bannen und die Bannliste verwalten, Ankündigungen senden
• Verwaltung der Lua-Ressourcen mit Hot-Reload, ohne den Server neu zu starten
• Administratorkonten mit rollenbasierten Berechtigungen, plus Icon und Banner des Servers

• ✔ Backups: Kopiere regelmäßig deine server.jsonc, deinen Ordner resources/ und deine Datenbank von der Maschine weg. Automatisiere es: Ein manuelles Backup wird irgendwann immer vergessen.
• ✔ Updates: Bleibe auf dem Stable-Kanal und aktualisiere den Server, sobald eine neue Version erscheint, da Spieler eine kompatible Version nutzen müssen. In der Alpha-Phase solltest du deine Ressourcen vor jedem Update sichern.

Sobald ein öffentlicher Server mit seinem Lizenzschlüssel beim Master registriert ist, erscheint er automatisch im Browser des Open77-Launchers und auf open2077.net. Ein paar Einstellungen machen den Unterschied:

• ✔ Wähle einen klaren Namen und eine Beschreibung, die deinen Spielmodus, deine Sprache und deine Atmosphäre erkennen lassen.
• ✔ Füge Tags hinzu: Der erste Tag, der einem bekannten Modus entspricht, bestimmt die Kategorie, in der dein Server eingeordnet wird, sonst erscheint er als „Custom“.
• ✔ Füge über Warden ein Icon und ein Banner hinzu, gib deine Website und deinen Discord an und teile deinen Direktverbindungslink (open77://connect?server=...).
• ✔ Trage deinen Server in das Cyberpunk-2077-Server-Ranking von Top-Games ein, um über Votes neue Spieler zu erreichen.