安装

WukongMP 服务器当前以以下格式分发：

• 二进制软件包
• Docker 镜像

二进制软件包

下载

平台	架构	下载
Linux	x64	Linux 版下载
Windows	x64	Windows 版下载

安装

将二进制包解压到你选择的位置。

解压后，目录结构应如下所示：

Windows

server/
├── server.exe                 # 主服务器二进制文件
├── config.json                # 配置文件
├── mods/                      # 模组目录
|   ├── WukongMp.Sdk/          # SDK 模组
|   └── WukongMp.PvP/          # 对战模组
├── optional_mods/             # 将其中任意模组移动到 "mods" 文件夹以启用
|   └── WukongMp.Coop/         # 合作模组
├── saves/                     # 游戏存档目录（默认为空）
├── wwwroot/                   # 管理面板资源
├── e_sqlite3.dll              # 依赖项
└── aspnetcorev2_inprocess.dll # 依赖项

Linux

server/
├── server                     # 主服务器二进制文件
├── config.json                # 配置文件
├── mods/                      # 模组目录
|   ├── WukongMp.Sdk/          # SDK 模组
|   └── WukongMp.PvP/          # 对战模组
├── optional_mods/             # 将其中任意模组移动到 "mods" 文件夹以启用
|   └── WukongMp.Coop/         # 合作模组
├── saves/                     # 游戏存档目录（默认为空）
├── wwwroot/                   # 管理面板资源
└── libe_sqlite3.so            # 依赖项

配置

您可以通过编辑 config.json 文件来调整服务器设置。在以下表格中，使用 : 记法来表示嵌套设置。

设置	类型	目的
Server:Port	数字	服务器监听传入连接的端口
Server:Password	string	可选。设置后，玩家在加入时必须在启动器中输入此密码。留空或省略以表示开放服务器。
Telemetry:OptOut	布尔值	设置为 true 即可选择不向 ReadyM 发送匿名遥测。默认值为 false。

备注

服务器:密码 对包括管理员和白名单用户在内的每位玩家都需要通过密码进行验证。受密码保护的服务器在公开服务器列表中显示为带锁的图标。

首次启动

通过运行 server.exe 二进制文件来启动服务器。

首次启动时，服务器在服务器文件夹内创建一个 data/ 目录。该目录包含用于存储持久数据的 web.db 数据库文件。

除非在 config.json 中进行了更改，否则服务器将监听以下端口：

端口	协议	目的
9050	UDP	游戏网络流量（玩家连接、游戏状态同步等）
9050	HTTP	后台管理面板

Docker

也提供了基于 Linux 的 x64 Docker 镜像，供偏好容器化部署的用户使用。

从注册表拉取镜像：

docker pull ghcr.io/readycodeio/wukongmp-server:0.2.4

从镜像中复制配置文件：

docker create --name wukongmp-tmp ghcr.io/readycodeio/wukongmp-server:0.2.4
docker cp wukongmp-tmp:/app/config.json ./config.json
docker rm wukongmp-tmp

运行：

Docker

docker run \
    -p 9050:9050/udp -p 9050:9050/tcp \
    -v ./data:/app/data \
    -v ./mods:/app/mods \
    -v ./saves:/app/saves \
    -v ./config.json:/app/config.json \
    --name wukongmp-server \
    ghcr.io/readycodeio/wukongmp-server:0.2.4

Docker Compose

docker-compose.yml

services:
  server:
    image: ghcr.io/readycodeio/wukongmp-server:0.2.4
    container_name: wukongmp-server
    restart: unless-stopped
    ports:
      - "9050:9050/tcp"
      - "9050:9050/udp"
    volumes:
      - ./data:/app/data
      - ./mods:/app/mods
      - ./saves:/app/saves
      - ./config.json:/app/config.json

important

镜像 不带模组。在启动容器之前，将 WukongMp.Sdk 以及你想要的模式（WukongMp.PvP、WukongMp.Coop）从二进制 ZIP 文件复制到你的 mods/ 卷中。

配置

端口的配置是通过在 docker run 命令或 Docker Compose 文件中重新映射容器端口来完成的。例如，要使用端口 9060 而不是 9050，请将端口部分更改为：

docker-compose.yml

ports:
  - "9060:9060/tcp"
  - "9060:9060/udp"