Come creare un server Cyberpunk 2077 con Open77

Open77 (OPEN//77) è la piattaforma multiplayer comunitaria di Cyberpunk 2077. Ospitare il tuo server Cyberpunk 2077 ti permette di:

• Giocare in multiplayer a Night City: roleplay, freeroam, deathmatch o battle royale.
• Creare le tue modalità di gioco con risorse Lua 5.4 e interfacce web (WebUI).
• Personalizzare il mondo: veicoli, mappe, NPC, cyberware, meteo e mod distribuiti automaticamente ai giocatori.
• Costruire una community fin dagli inizi di una scena multiplayer ancora giovane, dove c'è ancora spazio per farsi un nome.

Open77 funziona secondo lo stesso principio di FiveM per GTA V: un server dedicato, una chiave di licenza gratuita, un pannello di amministrazione web e risorse scriptate. Il server viene fornito pronto all'uso con la modalità Freeroam: puoi aprire un mondo in pochi minuti e poi farlo evolvere.

Il server Open77 è volutamente leggero: non necessita né di Cyberpunk 2077, né del motore REDengine, né dei dati del gioco. Verifica questi punti prima di iniziare:

• ✔ Sistema : Windows x64 o Linux x64 (Debian), il runtime .NET è incluso nell'archivio: non c'è nulla da installare in più
• ✔ Hardware : La documentazione ufficiale non fissa un minimo; a titolo indicativo, un VPS da 2 a 4 core con 4 GB di RAM è sufficiente per iniziare, da aumentare in base alle tue risorse Lua e al numero di giocatori
• ✔ Gioco : Non è necessaria alcuna installazione di Cyberpunk 2077 sulla macchina server
• ✔ Giocatori : Ogni giocatore deve possedere Cyberpunk 2077 in versione 2.31 con l'espansione Phantom Liberty, su Windows 10 o 11 a 64 bit, e disporre dell'accesso Alpha
• ✔ Hosting : Il tuo PC per i test, poi un VPS o un server dedicato per un server aperto 24 ore su 24

Per scaricare il server e registrarlo sul master Open77, hai bisogno di un account con accesso Alpha e di una chiave di licenza generata dal keymaster.

/alpha apply

Il server dedicato Open77 si scarica dalla pagina Host del sito ufficiale. L'archivio contiene il server e il suo runtime .NET, la modalità Freeroam pronta all'uso, Warden (assistente di avvio e pannello web) e il runtime Lua 5.4.

1. Vai su open2077.net/host con il tuo account Alpha e scegli il canale Stable (consigliato) piuttosto che Unstable
2. Scarica l'archivio per il tuo sistema: .zip per Windows, .tar.gz per Linux, e verifica l'hash SHA-256 indicato nella pagina
3. Decomprimi l'archivio in una cartella dedicata al tuo server
4. Avvia Start.cmd su Windows o ./start.sh su Linux (oppure direttamente l'eseguibile Open77.Server)

Impostare la chiave di licenza

Il metodo consigliato consiste nel passare la chiave tramite la variabile d'ambiente OP77_LICENSE_KEY, per non scriverla mai in chiaro in un file di configurazione:

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

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

Warden è il pannello di amministrazione web fornito con il server Open77, l'equivalente di txAdmin per FiveM. Al primo avvio, se non esiste alcun file server.jsonc, un assistente si apre nel browser.

http://localhost:11780

Il file server.jsonc (un JSON che accetta i commenti) raggruppa tutta la configurazione del server. L'assistente ne genera uno; ecco i blocchi essenziali da conoscere:

{
  "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 - Nome del server mostrato nel browser dei server del launcher
• identity.visibility - Visibilità nella directory: public (elencato), unlisted o private (su invito)
• network.port / network.publicEndpoint - Porta di gioco UDP (11778 di default) e indirizzo pubblico che i giocatori usano per connettersi
• query - Attiva l'interrogazione delle informazioni del server e definisce la mappa e la modalità di gioco annunciate
• masterServer - Registrazione presso il master Open77; lascia licenseKey su null per leggere la chiave dalla variabile OP77_LICENSE_KEY
• warden.bind - Indirizzo di ascolto del pannello Warden, da mantenere in locale

Argomenti di avvio

Su un VPS, puoi anche passare tutto come argomenti di avvio: --no-setup ignora l'assistente, --public-ip annuncia il tuo IP pubblico e --max-players fissa il numero massimo di giocatori. Aggiungi --check-config per validare la configurazione senza avviare il server.

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

Tutto il contenuto del tuo server (modalità di gioco, HUD, script, mappe, veicoli) si presenta sotto forma di risorse: pacchetti di script Lua 5.4, permessi e file web che il server carica e distribuisce ai giocatori. Sono organizzate per categoria nella cartella 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

Il manifesto open77.lua

Ogni risorsa possiede un file open77.lua che dichiara il suo nome, la sua versione, i suoi script server, client e condivisi, la sua interfaccia web e i permessi di cui ha bisogno. Gli script server non vengono mai inviati ai giocatori.

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

Gestire le risorse dalla console

Dopo aver aggiunto una cartella, rianalizza i manifesti con refresh, poi avvia la risorsa con ensure. Sono disponibili anche i comandi start, stop, restart e resources (elenco), così come il ricaricamento a caldo da Warden.

refresh
ensure garage
restart garage
stop garage

Vieni da FiveM?

Open77 riprende molti concetti di FiveM e propone alias di compatibilità: Citizen.CreateThread, Wait, RegisterCommand, gli eventi e gli export funzionano, e fxmanifest.lua diventa open77.lua. Le native di GTA (Citizen.InvokeNative, RequestModel, RequestAnimDict), invece, non esistono: uno script FiveM deve essere adattato, non semplicemente copiato. Se sei alle prime armi con FiveM, consulta anche la nostra guida per creare un server FiveM.

Database MySQL / MariaDB

Per salvare i dati (personaggi, inventari, veicoli), attiva il blocco database del server.jsonc. Sono supportati solo MySQL e MariaDB. La stringa di connessione, in formato MySqlConnector, va passata preferibilmente tramite la variabile OP77_DATABASE_CONNECTION, e ogni risorsa che vi accede deve dichiarare il permesso database.access.

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

Open77 sa installare automaticamente i mod di cui il tuo server ha bisogno (ArchiveXL, TweakXL, veicoli, mappe) prima dell'avvio del gioco: i giocatori non devono fare nulla manualmente e non hanno bisogno di riavviare per entrare.

I tre stati di sicurezza

• Verified - mod verificato dal team Open77, qualsiasi tipo di contenuto consentito (incluso eseguibile), distribuito dalla piattaforma
• Unverified - sono accettati solo dati inerti (.archive, .tweak, .xl, file INI del motore), ospitati dal tuo server
• Blocked - mod rifiutato: i giocatori non possono entrare in un server che lo richiede

Open77 utilizza una porta UDP per il gioco e una porta TCP per il download delle risorse da parte dei giocatori. Perché il tuo server sia accessibile da Internet, queste due porte devono essere aperte.

Porte da aprire

• UDP 11778 (di default): traffico di gioco, modificabile con network.port o --port
• TCP 11779 (di default): download delle risorse e dei mod da parte dei giocatori
• TCP 11780 : pannello Warden, da mantenere in locale, non aprirla pubblicamente

Esempi di regole firewall

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 centralizza l'amministrazione del tuo server Cyberpunk 2077 dal browser:

• Console in diretta: leggere i log ed eseguire comandi server
• Moderazione dei giocatori: avvisare, espellere, bannare e gestire la lista dei bannati, inviare annunci
• Gestione delle risorse Lua con ricaricamento a caldo, senza riavviare il server
• Account amministratore con permessi limitati per ruolo, più l'icona e il banner del server

• ✔ Backup: copia regolarmente il tuo server.jsonc, la tua cartella resources/ e il tuo database fuori dalla macchina. Automatizza: un backup manuale finisce sempre per essere dimenticato.
• ✔ Aggiornamenti: resta sul canale Stable e aggiorna il server non appena esce una nuova versione, perché i giocatori devono usare una versione compatibile. In Alpha, esegui il backup delle tue risorse prima di ogni aggiornamento.

Una volta registrato presso il master con la sua chiave di licenza, un server pubblico appare automaticamente nel browser del launcher Open77 e su open2077.net. Alcune impostazioni fanno la differenza:

• ✔ Scegli un nome chiaro e una descrizione che annuncino la tua modalità di gioco, la tua lingua e la tua atmosfera.
• ✔ Aggiungi dei tag: il primo tag corrispondente a una modalità conosciuta determina la categoria in cui il tuo server viene classificato, altrimenti appare come « Custom ».
• ✔ Aggiungi un'icona e un banner da Warden, indica il tuo sito e il tuo Discord, e condividi il tuo link di connessione diretta (open77://connect?server=...).
• ✔ Inserisci il tuo server nella classifica dei server Cyberpunk 2077 di Top-Games per raggiungere nuovi giocatori grazie ai voti.