🎮 GameEngine

./scripts/build.sh           # 交互：选构建目标（默认服务器版），再问是否连 Web 版一起构
./scripts/start_server.sh    # 一键开服：无头服务端 + websockify 桥（顺带发 WEB 页面）

脚本的执行位已由 git 记录（scripts/*.sh 在索引里是 100755），克隆/拉取后直接可跑。 若你手上是很早以前的克隆，执行位可能还是旧的，chmod +x scripts/*.sh 一次即可。

build.sh 两个交互问题的含义：

免交互写法：./scripts/build.sh server web（参数可任意组合 server / desktop / web）。

脚本内部就是调预设，等价于：

cmake --preset server && cmake --build --preset server --parallel "$(nproc)"

单元测试（秒级、完全离线：跳过 SDL/Box2D，只编纯逻辑模块）：

cmake --preset tests && cmake --build --preset tests && ctest --preset tests

# 桌面版（CMake 会自动把 Asset/ 拷到 exe 旁）
cmake --preset client
cmake --build --preset client
.\build\bin\GameEngine.exe

# 无头服务端
cmake --preset server
cmake --build --preset server

# 单元测试（秒级、完全离线：跳过 SDL/Box2D，只编纯逻辑模块）
cmake --preset tests
cmake --build --preset tests
ctest --preset tests

# Web 版（WASM，需要 emsdk；产物 build-web\web\ 四件套：html/js/wasm/data）
.\scripts\build_web.ps1

# 一键开服（服务端 exe 菜单开服 + websockify 桥 + 发 WEB 页面）
.\scripts\start_bridge.ps1

每个构建目录该用什么开关，一律由预设决定，不再手敲 -D：

cmake --preset client|server|web|tests   # 配置（自动选好 binaryDir 与各项开关）
cmake --build --preset <同名>             # 编译
ctest --preset tests                      # 跑测试
cmake --list-presets                      # 看有哪些

预设以 -D 形式下发，而 -D 每次配置都覆盖缓存——所以预设值即权威值，不会出现「旧 build 目录缓存压过文件默认值」的问题。

预设不指定生成器，用 CMake 的平台默认。Linux 上默认就是 Unix Makefiles；Windows 上默认取决于本机装了什么（本机 CMake 的默认是 Visual Studio，而本项目在 Windows 上只支持 MinGW），所以 Windows 上首次配置某个构建目录时要显式加 -G "MinGW Makefiles"——一旦该目录的缓存建好了，后续就不用再带。要换别的生成器同理，命令行加 -G 即可覆盖。

三种角色：

flowchart LR
    subgraph Browser["浏览器"]
        W["WASM 网页客户端"]
    end
    W -->|"ws://IP:8081"| B["websockify 桥"]
    B -->|"TCP :6666"| S[("游戏服务端")]
    D["桌面客户端"] -->|"直连 TCP :6666"| S

桥只服务网页玩家；桌面客户端 TCP 直连。服务端对两种玩家一视同仁。

Asset/config.json（构建时拷到 exe 旁 / Web 版打进 .data 包）：