《鸣潮》的 xeondev 私服简要运行教程（2.3 版本）

当前，CN 2.3.0测试服已发布。此文档及上游项目已支持此版本。感谢 xavo95 和 xeondev。

此文档针对CN 2.3.0测试服，不保证在未来正确无误。

目前，私服仅支持基本操作和抽卡，不支持怪物自然生成和任务。请确认您真的需要私服，时间和精力同样昂贵。

加入私服作者的 Discord 服务器免费获取全部所需文件。

xeondev 的私服是免费的，任何通过付费购买的软件都是诈骗。

也有一个其他人制作的视频教程，可以与此教程相互补充，但以本文优先。

需求

基本的英语阅读能力
能操作 Windows 下的命令行
理解 Windows 下路径、Git、命令行的基本概念
访问国际互联网
可选：有基本软件开发经验

为了确保万无一失，请确保用户文件夹名只包含 ASCII 字符。

必要的工具

请提前安装这些工具，不提供教程。

Scoop 命令行应用管理器
VSCode 文本编辑器
Visual Studio（使用 C++ 的桌面开发） Rust/C++ 编译环境需求

步骤

所有涉及的 URL 都可以在私服作者的 Discord 服务器中的已标注消息找到。

我们将使用 Windows 11 下的 Windows Terminal（终端）和 PowerShell，而非命令提示符。假定您的游戏安装和开发目录都位于D:下。

下载测试版游戏客户端

下载CN 测试版启动器，使用 Discord 中的文件（filechecklist.json、krfeapp.dat和KRApp.conf）修补启动器，即可免登录下载客户端：

`1`	`To work it new 2.0.0.0 place filechecklist.json and krfeapp.dat under <launcher_folder/2.0.0.0> and KRApp.conf under <launcher_folder/2.0.0.0/Assets>`

假定启动器安装在D:\Program Files\Wuthering Waves(Beta)。

准备环境

打开 Windows 终端（不需要管理员权限），执行：

1
2
3
4
5
6
7
scoop install main/git
scoop install main/rustup
scoop install main/postgresql
scoop install extras/protobuf

rustup update
pg_ctl start

在执行pg_ctl start后，保持此窗口开启，数据库在此处运行。

这里安装的数据库超级用户为postgres，密码为空。

克隆源码并构建 Patch DLL

在D:下新建文件夹WuWaPS，在资源管理器中进入此文件夹，右键空白处，选择“在终端中打开”。

执行：

1
2
3
4
5
git clone --recursive https://git.xeondev.com/wickedwaifus/wicked-waifus-rs.git
git clone https://git.xeondev.com/wickedwaifus/wicked-waifus-win-patch.git
git clone https://git.xeondev.com/xavo95/launcher.git
cd wicked-waifus-win-patch
.\build.bat

构建 Patch DLL 完成后，将D:\WuWaPS\wicked-waifus-win-patch\build\regular\wicked-waifus-win-cn_beta_2_3_0-regular.dll复制到D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64下。

https://git.xeondev.com/wickedwaifus/wicked-waifus-win-patch/releases或许有已构建的 DLL，可直接使用。

下载补丁 Pak

在https://git.xeondev.com/wickedwaifus/wicked-waifus-pak/releases/tag/2.3.0下载补丁 Pak，将下载的rr_fixes_100_p.pak复制到D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Content\Paks。

构建服务器并试运行

在D:\WuWaPS\wicked-waifus-rs下打开终端（在资源管理器中进入此文件夹，右键空白处，选择“在终端中打开”）。

逐个执行，并在服务器构建完成并运行时按下 Ctrl + C 终止运行服务器：

1
2
3
4
5
cargo run --bin wicked-waifus-config-server
cargo run --bin wicked-waifus-hotpatch-server
cargo run --bin wicked-waifus-login-server
cargo run --bin wicked-waifus-gateway-server
cargo run --bin wicked-waifus-game-server

此时，由于尚未建立对应的数据库，服务器程序可能会异常退出，暂时忽略。

新建数据库`shorekeeper`

在开始菜单打开pgAdmin 4，选择Add New Server，General-Name和Connection-Host name/address均填入127.0.0.1，点击Save即可连接。

在左侧服务器列表中，右键127.0.0.1，选择Create-Database，Database填入shorekeeper，点击Save。

下载并安置`launcher`

下载https://git.xeondev.com/xavo95/launcher/src/branch/master/samples/ww.toml和https://git.xeondev.com/xavo95/launcher/releases的最新版本launcher.exe。

将它们复制到D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64下，并将ww.toml重命名为config.toml。

编辑config.toml并保存：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
[launcher]
executable_file = 'Client-Win64-Shipping.exe'
cmd_line_args = '-fileopenlog'
current_dir = 'D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64'
dll_list = ['D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64\wicked-waifus-win-cn_beta_2_3_0-regular.dll']

[environment]
#environment = ['TESTVAR1=AAAAAA', 'TESTVAR2=AAAAAA']
#use_system_env = true
#environment_append = false

正式运行服务器程序

在D:\WuWaPS\wicked-waifus-rs打开五个终端（在资源管理器中进入此文件夹，右键空白处，选择“在终端中打开”），分别执行：

1
2
3
4
5
cargo run --bin wicked-waifus-config-server
cargo run --bin wicked-waifus-hotpatch-server
cargo run --bin wicked-waifus-login-server
cargo run --bin wicked-waifus-gateway-server
cargo run --bin wicked-waifus-game-server

确保它们没有异常退出。

通过`launcher`运行游戏客户端

一些教程会建议您在此关闭所有的代理软件，您可以这样操作。
实际上，如果您的代理软件可以正确处理127.0.0.1，那么或许可以不关闭它们。

在D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64右键launcher.exe，选择“以管理员身份运行”。

或者：

右键开始菜单按钮，选择“终端管理员”，执行：

1
2
cd "D:\Program Files\Wuthering Waves(Beta)\Wuthering Waves (Beta) Game\Client\Binaries\Win64"
.\launcher.exe

如果没有发生任何错误，应该可以使用任意 ID 进入游戏。

配置游戏服务器

第一次运行后，D:\WuWaPS\wicked-waifus-rs下会自动生成服务器配置文件。其中，gameserver.toml用于配置实际的游戏体验。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
service_id = 2

[database]
host = "localhost:5432"
user_name = "postgres"
password = ""
db_name = "shorekeeper"

[service_end_point]
addr = "tcp://127.0.0.1:10004"

[gateway_end_point]
addr = "tcp://127.0.0.1:10003"

[game_server_config]
resources_path = "data/assets/game-data"
load_textmaps = true
# Do not change yet, issues to be solved
quadrant_size = 1000000

[asset_config]
asset_url = "https://git.xeondev.com/wickedwaifus/wicked-waifus-data/releases/download/pioneer_2.3.1/bundle.zip"
buffer_size = 268435456

[default_unlocks]
unlock_all_roles = true
unlock_all_roles_max_level = false
unlock_all_roles_all_sequences = false
unlock_all_mc_elements = true
unlock_all_weapons = false
unlock_all_adventures = false
unlock_all_functions = true
unlock_all_guides = false
unlock_all_tutorials = false
unlock_all_teleporter = false

[default_unlocks]下的配置可以修改为true以实现对应的功能。修改后请停止并重新启动对应的服务器程序（这里是wicked-waifus-game-server）。

需求