layout: restructure into src/ tests/ android/ scripts/ tools/

- extension/src/{port,platform,codepage} -> src/; native_render -> src/host
  (+ dxt, shaders/); libgr2 -> src/gr2; extension/third_party -> third_party
- extension/tests -> tests/port, libgr2/tests -> tests/gr2
- android-native -> android (build.sh, push-client.sh moved in)
- script -> scripts; tools/40250 -> tools/server; oracle -> tools/granny-oracle;
  perf tools -> tools/perf
- all build trees under build/ (native, release, android, port-gate)
- xrender:: CMake aliases -> mt::; port-map ledger impl paths rewritten

No code changes. ctest 15/15, port_gate macos+android PASS, port_map check 0 errors.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
shenlei
2026-09-29 19:08:19 +09:00
co-authored by Claude Opus 5.5
parent 70710477cf
commit a46093104c
2817 changed files with 13728 additions and 13744 deletions
+96
View File
@@ -0,0 +1,96 @@
# 40250 FreeBSD + MySQL live E2E
这组脚本把文档里最后一个不能在 macOS 本机完成的前置变成可执行入口:
1. 在 FreeBSD jail/VM 准备 40250 server tree、MySQL 和 32-bit toolchain。
2. 导入 `metin2_mysql_dump/{account,common,log,player}.sql`。
3. 编译(或使用已编译的)`game` / `db`,安装 server runtime links。
4. 启动 db、auth、channel 1–4 和 game99。
5. 用 `net_classic_e2e_host` 验证 DH2/CTR、登录、选角和 `PHASE_GAME`。
当前 Mac 环境没有 FreeBSD 或 MySQL server,因此这里只能完成脚本、构建配置和
离线协议测试;不能把真实服结果冒充为已执行。脚本均使用环境变量,避免把本机
路径或密码写死到工程中。
## 复制/准备目录
```sh
export MT40250_ROOT=/usr/metin2
export MT40250_DUMP_ROOT=/usr/metin2_mysql_dump
```
`MT40250_ROOT` 必须是包含 `src/server` 和 `server/` 的 40250 server tree。
官方 Makefile 默认把二进制放到 `/usr/metin2/server/share/bin`,所以推荐保持
这个路径;若使用其他路径,必须同时确保 Makefile 的 `GAMEDIR`/`DBDIR` 指向
对应 runtime 目录。
## FreeBSD 安装与编译
依赖由管理员按镜像版本安装,典型组合如下(具体包名以目标 FreeBSD 版本为准):
```sh
pkg install gmake clang-devel mysql80-server mysql80-client
sh tools/server/build_server.sh
```
源码 Makefile 是 40250 原版,使用 `clang++-devel`、`-m32`、静态 MySQL client、
Crypto++ 8.4.0 和 FreeBSD 系统库;`build_server.sh` 会执行原始的 `gmake -C
src/server all`,失败时应保留完整编译输出修复 jail 的 32-bit/库依赖。
## 初始化数据库
先启动 MySQL,再执行:
```sh
export MT40250_MYSQL_ROOT_PASSWORD='你的 root 密码' # 不设置则每次交互式 -p
export MT40250_DB_PASSWORD=password # 必须与 CONFIG 一致,默认 password
sh tools/server/setup_mysql.sh
```
脚本创建 `account/common/log/player`,并同时建立 `metin2@localhost` 与
`metin2@127.0.0.1`;这是因为 CONFIG 使用 TCP `127.0.0.1`,而旧 Readme 只写了
`localhost`。导入后会执行最小连接检查。
## 启停 40250 服务
```sh
sh tools/server/prepare_runtime.sh
sh tools/server/start_server.sh
sh tools/server/stop_server.sh
```
`start_server.sh` 使用仓库自带 CONFIG:auth `11000`、channel1/first `13000`,
并启动 channel1–4 与 game99。每个进程的 stdout/stderr 写入其 runtime 目录的
`console.log`,PID 只记录在 `$MT40250_ROOT/.mt40250-pids`;停止脚本只终止这份
PID 文件中的进程。可用 `MT40250_CHANNELS='1'` 只启动 channel1,或设置
`MT40250_START_GAME99=0` 跳过 game99。
## 编译/运行 classic 探针
顶层 CMake 提供独立的 host-only 协议探针:
```sh
cmake -S . -B build-classic \
-DMT_BUILD_NET_TOOLS=ON \
-DMT_BUILD_PORT=OFF \
-DCMAKE_BUILD_TYPE=Release
cmake --build build-classic --target net_classic_e2e_host -j2
build-classic/net_classic_e2e_host 127.0.0.1 13000 test_account test_password 0 30
```
探针成功的判据是输出 `PASS PHASE_GAME`,并且打印主角 VID、实体数、背包槽位数
和等级。它不会自动创建角色、交易、购买或移动仓库物品;这些操作属于有副作用的
fixture 测试,应在测试账号/NPC/第二账号准备后通过原生客户端逐项操作:好友 add/remove、exchange start/item/gold/accept/cancel、
NPC safebox checkin/checkout/move、mall checkout、Cube open/add/delete/make。
## 40250 配置核对
- `auth/CONFIG`: `PORT 11000`。
- `channel1/first/CONFIG`: `PORT 13000`,`MAP_ALLOW` 包含起始地图。
- 所有 CONFIG 的 DB 端口是 `15000`,由 `server/db/conf.txt` 控制。
- `PLAYER_SQL` 指向 `player`,auth 的 `PLAYER_SQL` 指向 `account`,两者与原服
源码约定一致。
- `service.h` 默认定义 `_IMPROVED_PACKET_ENCRYPTION_`;classic 客户端必须走
DH2 + CTR,不能用“明文配置项”绕过。若专门做明文诊断,必须复制源码、重新
编译 game,并把它视为与 shipped server 不同的测试构建。