Como criar um servidor de Cyberpunk 2077 com Open77

O Open77 (OPEN//77) é a plataforma multijogador comunitária de Cyberpunk 2077. Alojar o seu próprio servidor de Cyberpunk 2077 permite-lhe:

• Jogar em grupo em Night City: roleplay, mundo livre (freeroam), deathmatch ou battle royale.
• Criar os seus próprios modos de jogo com recursos Lua 5.4 e interfaces web (WebUI).
• Personalizar o mundo: veículos, mapas, NPCs, cyberware, clima e mods distribuídos automaticamente aos jogadores.
• Dinamizar uma comunidade desde o início de uma cena multijogador ainda jovem, onde ainda há espaço para fazer um nome.

O Open77 funciona segundo o mesmo princípio que o FiveM para o GTA V: um servidor dedicado, uma chave de licença gratuita, um painel de administração web e recursos em script. O servidor é fornecido pronto a jogar com o modo Freeroam: pode abrir um mundo em poucos minutos e depois fazê-lo evoluir.

O servidor Open77 é deliberadamente leve: não precisa de Cyberpunk 2077, nem do motor REDengine, nem dos dados do jogo. Verifique estes pontos antes de começar:

• ✔ Sistema : Windows x64 ou Linux x64 (Debian); o runtime .NET está incluído no arquivo: não há nada mais a instalar
• ✔ Hardware : A documentação oficial não fixa um mínimo; a título indicativo, um VPS com 2 a 4 núcleos e 4 GB de RAM é suficiente para começar, a aumentar consoante os seus recursos Lua e o número de jogadores
• ✔ Jogo : Não é necessária qualquer instalação de Cyberpunk 2077 na máquina do servidor
• ✔ Jogadores : Cada jogador deve possuir o Cyberpunk 2077 na versão 2.31 com a expansão Phantom Liberty, em Windows 10 ou 11 de 64 bits, e dispor de acesso Alpha
• ✔ Alojamento : O seu PC para testar, depois um VPS ou um servidor dedicado para um servidor aberto 24/7

Para fazer o download do servidor e registá-lo no master Open77, precisa de uma conta com acesso Alpha e de uma chave de licença gerada a partir do keymaster.

/alpha apply

O servidor dedicado Open77 descarrega-se a partir da página Host do site oficial. O arquivo contém o servidor e o seu runtime .NET, o modo Freeroam pronto a jogar, o Warden (assistente de configuração e painel web) e o runtime Lua 5.4.

1. Vá a open2077.net/host com a sua conta Alpha e escolha o canal Stable (recomendado) em vez de Unstable
2. Faça o download do arquivo para o seu sistema: .zip para Windows, .tar.gz para Linux, e verifique a sua soma SHA-256 apresentada na página
3. Descompacte o arquivo numa pasta dedicada ao seu servidor
4. Execute Start.cmd no Windows ou ./start.sh no Linux (ou diretamente o executável Open77.Server)

Indicar a chave de licença

O método recomendado consiste em passar a chave através da variável de ambiente OP77_LICENSE_KEY, para nunca a escrever em texto simples num ficheiro de configuração:

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

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

O Warden é o painel de administração web fornecido com o servidor Open77, o equivalente do txAdmin para o FiveM. No primeiro arranque, se não existir nenhum ficheiro server.jsonc, abre-se um assistente no navegador.

http://localhost:11780

O ficheiro server.jsonc (um JSON que aceita comentários) reúne toda a configuração do servidor. O assistente gera um; eis os blocos essenciais a conhecer:

{
  "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 do servidor apresentado no navegador de servidores do launcher
• identity.visibility - Visibilidade no diretório: public (listado), unlisted ou private (apenas por convite)
• network.port / network.publicEndpoint - Porta de jogo UDP (11778 por defeito) e endereço público que os jogadores utilizam para se ligar
• query - Ativa a consulta de informações do servidor e define o mapa e o modo de jogo anunciados
• masterServer - Registo junto do master Open77; deixe licenseKey como null para ler a chave a partir da variável OP77_LICENSE_KEY
• warden.bind - Endereço de escuta do painel Warden, a manter em local

Argumentos de arranque

Num VPS, também pode passar tudo como argumentos de arranque: --no-setup ignora o assistente, --public-ip anuncia o seu IP público e --max-players fixa o número máximo de jogadores. Adicione --check-config para validar a configuração sem iniciar o servidor.

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

Todo o conteúdo do seu servidor (modos de jogo, HUD, scripts, mapas, veículos) toma a forma de recursos: pacotes de scripts Lua 5.4, permissões e ficheiros web que o servidor carrega e distribui aos jogadores. Estão organizados por categoria na pasta 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

O manifesto open77.lua

Cada recurso possui um ficheiro open77.lua que declara o seu nome, a sua versão, os seus scripts de servidor, de cliente e partilhados, a sua interface web e as permissões de que necessita. Os scripts de servidor nunca são enviados aos jogadores.

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

Gerir os recursos a partir da consola

Depois de adicionar uma pasta, reanalise os manifestos com refresh, depois inicie o recurso com ensure. Os comandos start, stop, restart e resources (lista) também estão disponíveis, assim como o recarregamento a quente a partir do Warden.

refresh
ensure garage
restart garage
stop garage

Vem do FiveM?

O Open77 retoma muitos conceitos do FiveM e disponibiliza aliases de compatibilidade: Citizen.CreateThread, Wait, RegisterCommand, os eventos e os exports funcionam, e o fxmanifest.lua torna-se open77.lua. Em contrapartida, as natives do GTA (Citizen.InvokeNative, RequestModel, RequestAnimDict) não existem: um script FiveM tem de ser adaptado, não apenas copiado. Se está a começar no FiveM, consulte também o nosso guia para criar um servidor FiveM.

Base de dados MySQL / MariaDB

Para guardar dados (personagens, inventários, veículos), ative o bloco database do server.jsonc. Apenas o MySQL e o MariaDB são suportados. A string de ligação, no formato MySqlConnector, deve ser passada preferencialmente através da variável OP77_DATABASE_CONNECTION, e cada recurso que a acede deve declarar a permissão database.access.

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

O Open77 consegue instalar automaticamente os mods de que o seu servidor necessita (ArchiveXL, TweakXL, veículos, mapas) antes do arranque do jogo: os jogadores não têm nada a fazer manualmente e não precisam de reiniciar para entrar.

Os três estatutos de segurança

• Verified - mod verificado pela equipa Open77, qualquer tipo de conteúdo permitido (incluindo executável), distribuído pela plataforma
• Unverified - apenas dados inertes são aceites (.archive, .tweak, .xl, ficheiros INI do motor), alojados pelo seu servidor
• Blocked - mod recusado: os jogadores não podem entrar num servidor que o exija

O Open77 utiliza uma porta UDP para o jogo e uma porta TCP para o download dos recursos pelos jogadores. Para que o seu servidor seja acessível a partir da Internet, estas duas portas devem estar abertas.

Portas a abrir

• UDP 11778 (por defeito): tráfego de jogo, alterável com network.port ou --port
• TCP 11779 (por defeito): download dos recursos e dos mods pelos jogadores
• TCP 11780 : painel Warden, a manter em local, não o abra publicamente

Exemplos de regras de 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

O Warden centraliza a administração do seu servidor de Cyberpunk 2077 a partir do navegador:

• Consola em direto: ler os registos (logs) e executar comandos de servidor
• Moderação dos jogadores: avisar, expulsar, banir e gerir a lista de banidos, enviar comunicados
• Gestão dos recursos Lua com recarregamento a quente, sem reiniciar o servidor
• Contas de administrador com permissões limitadas por função, além do ícone e da bandeira do servidor

• ✔ Backups: copie regularmente o seu server.jsonc, a sua pasta resources/ e a sua base de dados para fora da máquina. Automatize: um backup manual acaba sempre por ser esquecido.
• ✔ Atualizações: mantenha-se no canal Stable e atualize o servidor assim que surja uma nova versão, porque os jogadores devem utilizar uma versão compatível. Durante a Alpha, faça backup dos seus recursos antes de cada atualização.

Uma vez registado junto do master com a sua chave de licença, um servidor público aparece automaticamente no navegador do launcher Open77 e em open2077.net. Algumas configurações fazem a diferença:

• ✔ Escolha um nome claro e uma descrição que anunciem o seu modo de jogo, a sua língua e o seu ambiente.
• ✔ Adicione tags: a primeira tag correspondente a um modo conhecido determina a categoria em que o seu servidor é classificado, caso contrário aparece como «Custom».
• ✔ Adicione um ícone e uma bandeira a partir do Warden, indique o seu site e o seu Discord, e partilhe o seu link de ligação direta (open77://connect?server=...).
• ✔ Referencie o seu servidor na classificação dos servidores de Cyberpunk 2077 do Top-Games para alcançar novos jogadores graças aos votos.