BD2 本地服务器

用于本地开发、协议研究和服务端实现练习。服务默认只监听环回地址，不应暴露到公网。

许可与免责声明

本项目原创内容由 Flechazo 保留全部权利，具体中英双语条款见 LICENSE。通过项目权利人指定渠道合法取得副本的人，仅可用于个人学习、研究和本地非商业测试；未经项目权利人事先明确书面许可，禁止向第三方转发、镜像、上传、二次分发项目源码或构建产物，禁止售卖、收费提供、商业化运营或对公众开放基于本项目的服务。公开可见不代表允许转载或再分发。

本项目是非官方开发与研究项目，与 Brown Dust II 及其权利人无隶属或授权关系。游戏名称、商标、客户端、游戏资源和数据归各自权利人所有；本项目的许可不覆盖它们，也不变更第三方依赖的许可证。项目按现状提供，无正确性、安全性、可用性或不侵权保证。使用者须自行确认适用法律、相关协议和第三方权利要求，并自行承担使用、客户端修改及本地服务运行风险。

开发构建

# Go
Push-Location .\go
$env:GOCACHE = (Join-Path $PWD '.cache\go-build')
go test ./...
go build .\cmd\bd2server
Pop-Location

# Haskell
Push-Location .\haskell
cabal build all --enable-tests
cabal test all --test-show-details=direct
Pop-Location

$env:PYTHONDONTWRITEBYTECODE = '1'
python -m unittest discover -s .\tools\python\tests -p 'test_*.py' -v

单文件发布

.\build-release.ps1

脚本构建并测试 Haskell CLI，将它嵌入 Go 服务，最终只生成 .build\bin\bd2server.exe。运行时 helper 位于临时目录并在进程退出时清理，不需要分发第二个可执行文件。Go 构建缓存只写入 go\.cache。运行服务仍需项目的本地配置和资源；“单文件”指两个程序的发布产物合并为一个 exe，不代表把外部资源打进程序。

客户端插件项目

plugins/LocalIdentity/：本地服务端客户端专用插件。
plugins/CaptureEnvironment/：独立原版对照客户端的抓包插件；不要装进本地服务端客户端。

首次安装本地客户端

先设置客户端目录，修改客户端入口，并构建、安装 BD2LocalIdentity.dll：

$clientDir = "<客户端目录>"

.\.build\bin\bd2server.exe patch-client `
  --game-dir $clientDir

dotnet build .\plugins\LocalIdentity\LocalIdentity.csproj `
  -c Release `
  -p:GameDir="$clientDir"

$pluginDir = Join-Path $clientDir 'BepInEx\plugins'
New-Item -ItemType Directory -Force $pluginDir | Out-Null
Copy-Item `
  .\plugins\LocalIdentity\bin\Release\netstandard2.1\BD2LocalIdentity.dll `
  (Join-Path $pluginDir 'BD2LocalIdentity.dll') `
  -Force

客户端必须已经安装并加载 BD2LocalIdentity.dll，否则不能按本地服流程登录。不要把原版抓包插件 BD2CaptureEnvironment.dll 安装进这个客户端。

启动顺序

顺序必须是：

确认 BD2LocalIdentity.dll 已安装在本地客户端的 BepInEx\plugins。
启动服务器。
健康检查返回成功后，再启动游戏客户端。

启动服务器：

Push-Location .\go
& ..\.build\bin\bd2server.exe serve `
  --cdn "<ServerData目录>" `
  --game-data "<GameData目录>" `
  --game-data-version "<GameData版本>"
Pop-Location

启动时先核验资源，Go 再调用内嵌的 Haskell CLI 检查和修复存档；通过后加载账号与玩法服务，最后监听指定地址（默认 127.0.0.1:8080）。本地身份插件目前固定连接该默认地址；要更换地址，需要同步修改插件。

健康检查：

Invoke-WebRequest http://127.0.0.1:8080/healthz

健康检查成功后才能启动本地客户端。服务器尚未监听时启动客户端，会在登录或维护信息阶段连接失败。

修改客户端

构建服务后运行：

.\.build\bin\bd2server.exe patch-client --game-dir "<客户端目录>" --verify
.\.build\bin\bd2server.exe patch-client --game-dir "<客户端目录>"

4.1 KiB Raw Blame History Unescape Escape