如何使用 Open77 创建 Cyberpunk 2077 服务器

Open77（OPEN//77）是 Cyberpunk 2077 的社区多人游戏平台。托管您自己的Cyberpunk 2077 服务器可以让您：

• 在 Night City 中与他人一起游玩：角色扮演、Freeroam、死亡竞赛或大逃杀。
• 通过 Lua 5.4 资源和网页界面（WebUI）创建您自己的游戏模式。
• 自定义游戏世界：载具、地图、NPC、义体、天气，以及自动分发给玩家的模组。
• 在这个尚处起步阶段、仍有机会脱颖而出的多人游戏生态中，凝聚属于您自己的社区。

Open77 的运作原理与 GTA V 的 FiveM 相同：专用服务器、免费的授权密钥、网页管理面板与脚本化资源。服务器开箱即附带可直接游玩的 Freeroam 模式：您可以在几分钟内开启一个世界，然后逐步完善它。

Open77 服务器刻意做得十分轻量：既不需要 Cyberpunk 2077，也不需要 REDengine 引擎或游戏数据。请在开始前确认以下几点：

• ✔ 系统 : Windows x64 或 Linux x64（Debian）：.NET 运行时已包含在压缩包中，无需额外安装任何内容
• ✔ 硬件 : 官方文档未设定最低配置；作为参考，配备 2 至 4 核与 4 GB 内存的 VPS 即可起步，具体需视您的 Lua 资源与玩家数量进行提升
• ✔ 游戏 : 服务器所在机器无需安装 Cyberpunk 2077
• ✔ 玩家 : 每位玩家都必须拥有 2.31 版本并安装 Phantom Liberty 扩展包的 Cyberpunk 2077，运行在 64 位 Windows 10 或 11 上，并具备 Alpha 访问权限
• ✔ 托管 : 测试时使用您自己的电脑，24 小时不间断运行的服务器则使用 VPS 或专用服务器

要下载服务器并将其注册到 Open77 的 master，您需要一个拥有 Alpha 访问权限的账号，以及从 keymaster 生成的授权密钥。

/alpha apply

Open77 专用服务器可从官网的 Host 页面下载。压缩包中包含服务器本体及其 .NET 运行时、可直接游玩的 Freeroam 模式、Warden（启动向导与网页面板）以及 Lua 5.4 运行时。

1. 使用您的 Alpha 账号访问 open2077.net/host，并选择 Stable 频道（推荐），而非 Unstable 频道
2. 下载与您系统对应的压缩包：Windows 使用 .zip，Linux 使用 .tar.gz，并核对页面上显示的 SHA-256 校验值
3. 将压缩包解压到一个专用于您服务器的文件夹中
4. 在 Windows 上运行 Start.cmd，或在 Linux 上运行 ./start.sh（也可以直接运行 Open77.Server 可执行文件）

填写授权密钥

推荐的方法是通过环境变量 OP77_LICENSE_KEY 传递密钥，从而避免将其以明文形式写入配置文件：

Linux :

export OP77_LICENSE_KEY="op77_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
./start.sh

Windows :

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

Warden 是 Open77 服务器自带的网页管理面板，相当于 FiveM 中的 txAdmin。首次启动时，如果不存在 server.jsonc 文件，浏览器中会打开一个启动向导。

http://localhost:11780

server.jsonc 文件（一种支持注释的 JSON 格式）汇集了服务器的全部配置。向导会自动生成该文件；以下是需要了解的关键配置块：

{
  "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 - 在启动器服务器浏览器中显示的服务器名称
• identity.visibility - 在目录中的可见性：public（公开列出）、unlisted（不列出）或 private（仅限邀请）
• network.port / network.publicEndpoint - 游戏使用的 UDP 端口（默认 11778）以及玩家用来连接的公开地址
• query - 启用服务器信息查询，并设置对外显示的地图和游戏模式
• masterServer - 向 Open77 master 进行注册；将 licenseKey 保留为 null，以便从 OP77_LICENSE_KEY 变量中读取密钥
• warden.bind - Warden 面板的监听地址，请保持为本地地址

启动参数

在 VPS 上，您也可以将所有设置通过启动参数传递：--no-setup 跳过向导，--public-ip 用于声明您的公开 IP，--max-players 用于设定最大玩家数。添加 --check-config 可在不启动服务器的情况下验证配置。

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

您服务器的所有内容（游戏模式、HUD、脚本、地图、载具）都以资源的形式存在：这些资源包含 Lua 5.4 脚本、权限声明以及网页文件，由服务器加载并分发给玩家。它们按类别存放在 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

open77.lua 清单文件

每个资源都拥有一个 open77.lua 文件，用于声明其名称、版本、服务器端/客户端/共享脚本、网页界面以及所需的权限。服务器端脚本永远不会发送给玩家。

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

通过控制台管理资源

添加文件夹后，使用 refresh 重新扫描清单文件，然后使用 ensure 启动该资源。start、stop、restart 以及 resources（列出列表）等指令同样可用，此外还可以通过 Warden 进行热重载。

refresh
ensure garage
restart garage
stop garage

从 FiveM 转来？

Open77 借用了许多 FiveM 的概念，并提供了兼容性别名：Citizen.CreateThread、Wait、RegisterCommand、事件（events）与导出（exports）均可正常使用，而 fxmanifest.lua 则变为 open77.lua。但 GTA 的原生函数（Citizen.InvokeNative、RequestModel、RequestAnimDict）并不存在：FiveM 脚本必须进行适配，而不能直接复制使用。如果您刚接触 FiveM，也可以参考我们的FiveM 服务器创建指南。

MySQL / MariaDB 数据库

要保存数据（角色、库存、载具），请启用 server.jsonc 中的 database 配置块。仅支持 MySQL 和 MariaDB。建议通过 OP77_DATABASE_CONNECTION 变量传递符合 MySqlConnector 格式的连接字符串，并且每个访问数据库的资源都必须声明 database.access 权限。

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

Open77 能够在游戏启动前自动安装服务器所需的模组（ArchiveXL、TweakXL、载具、地图）：玩家无需手动操作，也不需要重启游戏即可加入。

三种安全状态

• Verified - 经 Open77 团队审核的模组，允许任何类型的内容（包括可执行文件），由平台负责分发
• Unverified - 仅接受静态数据（.archive、.tweak、.xl、引擎 INI 文件），由您的服务器负责托管
• Blocked - 被拒绝的模组：玩家无法加入要求使用该模组的服务器

Open77 使用一个 UDP 端口进行游戏通信，使用一个 TCP 端口供玩家下载资源。要让您的服务器可从互联网访问，这两个端口都必须开放。

需要开放的端口

• UDP 11778 （默认）：游戏流量，可通过 network.port 或 --port 修改
• TCP 11779 （默认）：供玩家下载资源与模组
• TCP 11780 ：Warden 面板，请保持为本地地址，切勿公开开放

防火墙规则示例

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 让您可以在浏览器中集中管理您的 Cyberpunk 2077 服务器：

• 实时控制台：查看日志并执行服务器指令
• 玩家管理：警告、踢出、封禁并管理封禁名单，发送公告
• 管理 Lua 资源并支持热重载，无需重启服务器
• 按角色限制权限的管理员账号，以及服务器图标与横幅的设置

• ✔ 备份：定期将您的 server.jsonc、resources/ 文件夹以及数据库复制到机器之外。请实现自动化：手动备份终究会被遗忘。
• ✔ 更新：请保持在 Stable 频道，并在新版本发布后尽快更新服务器，因为玩家必须使用兼容的版本。在 Alpha 阶段，请在每次更新前备份您的资源。

服务器一旦使用授权密钥向 master 注册，公开服务器就会自动出现在 Open77 启动器的服务器浏览器中，以及 open2077.net 网站上。以下几项设置会带来明显差异：

• ✔ 选择一个清晰的名称，并撰写能体现您的游戏模式、语言与氛围的描述。
• ✔ 添加标签：与已知模式相匹配的第一个标签，决定了您的服务器被归入的分类，否则它会显示为「Custom」。
• ✔ 通过 Warden 添加图标与横幅，填写您的网站与 Discord，并分享您的直接连接链接（open77://connect?server=...）。
• ✔ 将您的服务器提交到 Top-Games 的Cyberpunk 2077 服务器排行榜，借助投票吸引新玩家。