Comment créer un serveur Cyberpunk 2077 avec Open77

Open77 (OPEN//77) est la plateforme multijoueur communautaire de Cyberpunk 2077. Héberger votre propre serveur Cyberpunk 2077 vous permet de :

• Jouer à plusieurs dans Night City : roleplay, freeroam, deathmatch ou battle royale.
• Créer vos propres modes de jeu avec des ressources Lua 5.4 et des interfaces web (WebUI).
• Personnaliser le monde : véhicules, cartes, PNJ, cyberware, météo et mods distribués automatiquement aux joueurs.
• Fédérer une communauté dès les débuts d'une scène multijoueur encore jeune, où il reste de la place pour se faire un nom.

Open77 fonctionne sur le même principe que FiveM pour GTA V : un serveur dédié, une clé de licence gratuite, un panneau d'administration web et des ressources scriptées. Le serveur est fourni prêt à jouer avec le mode Freeroam : vous pouvez ouvrir un monde en quelques minutes, puis le faire évoluer.

Le serveur Open77 est volontairement léger : il n'a besoin ni de Cyberpunk 2077, ni du moteur REDengine, ni des données du jeu. Vérifiez ces points avant de commencer :

• ✔ Système : Windows x64 ou Linux x64 (Debian), le runtime .NET est inclus dans l'archive : rien à installer en plus
• ✔ Matériel : La documentation officielle ne fixe pas de minimum ; à titre indicatif, un VPS de 2 à 4 cœurs avec 4 Go de RAM suffit pour démarrer, à augmenter selon vos ressources Lua et votre nombre de joueurs
• ✔ Jeu : Aucune installation de Cyberpunk 2077 n'est nécessaire sur la machine serveur
• ✔ Joueurs : Chaque joueur doit posséder Cyberpunk 2077 en version 2.31 avec l'extension Phantom Liberty, sur Windows 10 ou 11 64 bits, et disposer d'un accès Alpha
• ✔ Hébergement : Votre PC pour tester, puis un VPS ou un serveur dédié pour un serveur ouvert 24h/24

Pour télécharger le serveur et l'inscrire sur le master Open77, il vous faut un compte avec l'accès Alpha et une clé de licence générée depuis le keymaster.

/alpha apply

Le serveur dédié Open77 se télécharge depuis la page Host du site officiel. L'archive contient le serveur et son runtime .NET, le mode Freeroam prêt à jouer, Warden (assistant de démarrage et panneau web) et le runtime Lua 5.4.

1. Rendez-vous sur open2077.net/host avec votre compte Alpha et choisissez le canal Stable (recommandé) plutôt que Unstable
2. Téléchargez l'archive de votre système : .zip pour Windows, .tar.gz pour Linux, et vérifiez son empreinte SHA-256 affichée sur la page
3. Décompressez l'archive dans un dossier dédié à votre serveur
4. Lancez Start.cmd sous Windows ou ./start.sh sous Linux (ou directement l'exécutable Open77.Server)

Renseigner la clé de licence

La méthode recommandée consiste à passer la clé par la variable d'environnement OP77_LICENSE_KEY, pour ne jamais l'écrire en clair dans un fichier de configuration :

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

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

Warden est le panneau d'administration web fourni avec le serveur Open77, l'équivalent de txAdmin pour FiveM. Au premier lancement, si aucun fichier server.jsonc n'existe, un assistant s'ouvre dans le navigateur.

http://localhost:11780

Le fichier server.jsonc (du JSON qui accepte les commentaires) regroupe toute la configuration du serveur. L'assistant en génère un ; voici les blocs essentiels à connaître :

{
  "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 - Nom du serveur affiché dans le navigateur de serveurs du launcher
• identity.visibility - Visibilité dans l'annuaire : public (listé), unlisted ou private (sur invitation)
• network.port / network.publicEndpoint - Port de jeu UDP (11778 par défaut) et adresse publique que les joueurs utilisent pour se connecter
• query - Active la requête d'informations du serveur et définit la carte et le mode de jeu annoncés
• masterServer - Inscription auprès du master Open77 ; laissez licenseKey à null pour lire la clé depuis la variable OP77_LICENSE_KEY
• warden.bind - Adresse d'écoute du panneau Warden, à garder en local

Arguments de démarrage

Sur un VPS, vous pouvez aussi tout passer en arguments de lancement : --no-setup ignore l'assistant, --public-ip annonce votre IP publique et --max-players fixe le nombre maximum de joueurs. Ajoutez --check-config pour valider la configuration sans démarrer le serveur.

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

Tout le contenu de votre serveur (modes de jeu, HUD, scripts, cartes, véhicules) prend la forme de ressources : des paquets de scripts Lua 5.4, de permissions et de fichiers web que le serveur charge et distribue aux joueurs. Elles sont rangées par catégorie dans le dossier resources/ :

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

Le manifeste open77.lua

Chaque ressource possède un fichier open77.lua qui déclare son nom, sa version, ses scripts serveur, client et partagés, son interface web et les permissions dont elle a besoin. Les scripts serveur ne sont jamais envoyés aux joueurs.

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" }

Gérer les ressources depuis la console

Après avoir ajouté un dossier, rescannez les manifestes avec refresh, puis démarrez la ressource avec ensure. Les commandes start, stop, restart et resources (liste) sont aussi disponibles, ainsi que le rechargement à chaud depuis Warden.

refresh
ensure garage
restart garage
stop garage

Vous venez de FiveM ?

Open77 reprend de nombreux concepts de FiveM et propose des alias de compatibilité : Citizen.CreateThread, Wait, RegisterCommand, les événements et les exports fonctionnent, et le fxmanifest.lua devient open77.lua. En revanche, les natives GTA (Citizen.InvokeNative, RequestModel, RequestAnimDict) n'existent pas : un script FiveM doit être adapté, pas simplement copié. Si vous débutez sur FiveM, consultez aussi notre guide pour créer un serveur FiveM.

Base de données MySQL / MariaDB

Pour sauvegarder des données (personnages, inventaires, véhicules), activez le bloc database du server.jsonc. Seuls MySQL et MariaDB sont pris en charge. La chaîne de connexion, au format MySqlConnector, se passe de préférence via la variable OP77_DATABASE_CONNECTION, et chaque ressource qui y accède doit déclarer la permission database.access.

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

Open77 sait installer automatiquement les mods dont votre serveur a besoin (ArchiveXL, TweakXL, véhicules, cartes) avant le lancement du jeu : les joueurs n'ont rien à faire à la main et n'ont pas besoin de redémarrer pour rejoindre.

Les trois statuts de sécurité

• Verified - mod vérifié par l'équipe Open77, tout type de contenu autorisé (y compris exécutable), distribué par la plateforme
• Unverified - seules les données inertes sont acceptées (.archive, .tweak, .xl, fichiers INI du moteur), hébergées par votre serveur
• Blocked - mod refusé : les joueurs ne peuvent pas rejoindre un serveur qui l'exige

Open77 utilise un port UDP pour le jeu et un port TCP pour le téléchargement des ressources par les joueurs. Pour que votre serveur soit accessible depuis Internet, ces deux ports doivent être ouverts.

Ports à ouvrir

• UDP 11778 (par défaut) : trafic de jeu, modifiable avec network.port ou --port
• TCP 11779 (par défaut) : téléchargement des ressources et des mods par les joueurs
• TCP 11780 : panneau Warden, à garder en local, ne l'ouvrez pas publiquement

Exemples de règles pare-feu

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 centralise l'administration de votre serveur Cyberpunk 2077 depuis le navigateur :

• Console en direct : lire les logs et exécuter des commandes serveur
• Modération des joueurs : avertir, expulser, bannir et gérer la liste des bannis, envoyer des annonces
• Gestion des ressources Lua avec rechargement à chaud, sans redémarrer le serveur
• Comptes administrateurs avec des permissions limitées par rôle, plus l'icône et la bannière du serveur

• ✔ Sauvegardes : copiez régulièrement votre server.jsonc, votre dossier resources/ et votre base de données hors de la machine. Automatisez : une sauvegarde manuelle finit toujours par être oubliée.
• ✔ Mises à jour : restez sur le canal Stable et mettez à jour le serveur dès qu'une nouvelle version sort, car les joueurs doivent utiliser une version compatible. En Alpha, sauvegardez vos ressources avant chaque mise à jour.

Une fois inscrit auprès du master avec sa clé de licence, un serveur public apparaît automatiquement dans le navigateur du launcher Open77 et sur open2077.net. Quelques réglages font la différence :

• ✔ Choisissez un nom clair et une description qui annoncent votre mode de jeu, votre langue et votre ambiance.
• ✔ Ajoutez des tags : le premier tag correspondant à un mode connu détermine la catégorie dans laquelle votre serveur est classé, sinon il apparaît comme « Custom ».
• ✔ Ajoutez une icône et une bannière depuis Warden, indiquez votre site et votre Discord, et partagez votre lien de connexion directe (open77://connect?server=...).
• ✔ Référencez votre serveur dans le classement des serveurs Cyberpunk 2077 de Top-Serveurs pour toucher de nouveaux joueurs grâce aux votes.