# 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/40250/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/40250/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/40250/prepare_runtime.sh
sh tools/40250/start_server.sh
sh tools/40250/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 探针

FreeBSD 不能启用 Godot extension，但顶层 CMake 提供了 host-only 模式：

```sh
cmake -S . -B build-classic \
  -DMTGODOT_BUILD_EXTENSION=OFF \
  -DMTGODOT_BUILD_NET_TOOLS=ON \
  -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/第二账号准备后通过 Godot UI 或对应 `M2Client`
intent 逐项操作：好友 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 不同的测试构建。