Files
metin2-client/docs/AVA2-SWITCHBOT.md
T
shenleiandClaude Opus 5.5 6b1d21a2c5 Add switchbot (自动洗练) window for the server mt_switchbot command
Embedded module mt_switchbot: a paced request queue (0.3 s gap, one in
flight, 4 s timeout -> unsupported), atomic attrs lists from the server,
two alternatives of up to 5 targets, 10-1000 roll limits, live state and
stop reasons. Entry button under the wiki button by the minimap. The
selection follows the server-reported cell when the item moves mid-run
and falls back to the same vnum when it moves while idle.

Live tested against 203 (channel-5 test core, port 13040) with the macOS
native client.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 19:45:14 +09:00

4.4 KiB
Raw Blame History

AVA2 自动洗练适配进度(v1,不含属性锁定)

2026-10-15。修改了 metin2-client 和 metin2-server,AVA2 代码只作参考。服务端规则和协议见 metin2-server/docs/FEATURE-SWITCHBOT.md。

与 AVA2 的差异

项目 AVA2 本实现
窗口 新增 SWITCHBOT 物品窗口,5 个物品槽加 1 个道具槽 不新增窗口类型,物品留在背包,按物品 ID 绑定;每个角色同一时间只洗 1 件
洗练执行 自己实现消耗和 ChangeAttribute,绕过手动检查和 ItemLog 每次都调用原 UseItem,检查、概率、日志、扣道具都和手动洗练一样;71151/76023 仍只能洗等级上限 ≤40 的武器和衣服
速度 0.1 秒一次 0.25 秒一次(约 4 次/秒)
物品被移动 拦截移动、交易、出售等路径 每次洗练前重新检查:物品不在背包、已装备、易主时停止(item_gone);交易、商店、仓库、合成界面打开时停止(busy)
换线 / 下线 通过 P2P 转移,继续洗 直接停止,不离线洗练

匹配规则和 AVA2 相同:最多 2 套方案,每套 1–5 条“属性 ≥ 阈值”;任意一套全部达标就停止,只看前 5 条普通属性。

客户端

  • 模块 mt_switchbot(src/platform/ScriptLib/SwitchbotScript.inc),在 PythonBoot.cpp 中安装。入口是小地图旁“百科”按钮下方的“洗练”按钮。
  • 物品:扫描背包里至少有一条属性的武器和防具,用 < > 切换。洗练道具:扫描子类型为 USE_CHANGE_ATTRIBUTE 的道具,显示数量。次数上限可选 10、50、100、200、500、1000。
  • 可选属性和最大值由服务端 attrs 下发,客户端不自己推算。添加属性时分页点选;阈值用 -/+ 调整,步长为最大值的 1/5,默认取最大值。
  • 运行时锁定所有设置,实时显示次数、剩余道具、停止原因和当前 5 条属性。停止时在聊天框提示;达标时如果窗口已关闭,会自动打开。
  • 命令间隔至少 0.3 秒,同一时间只有一个请求在等待回复。4 秒没有回复就显示“服务器尚未启用自动洗练”。attrs 只接受完整、连续的回复,不完整的整批丢弃。
  • 文字都用 GBK 可编码的字符(不用 ◀/▶/⚠)。

证据

  • tests/wiki/test_switchbot.py(CTest:port.switchbot)共 6 项通过,覆盖:
    • 请求节流和合并;
    • 不完整的 attrs 回复被拒绝;
    • start 命令的拼装和校验;
    • state/error 解析和超时;
    • 和服务端的原因码、错误码、上限一致;
    • 窗口流程:扫描 → 读取属性 → 选属性 → 开始 → 达标提示。
  • 脚本能在 Python 2.7 下编译。tests/wiki/test_service.py 仍然通过。
  • 2026-10-15 联机测试(203 额外开的测试核心 channel5/first,端口 13040,使用隔离编译的 game;macOS 原生客户端,账号 admin,物品为背包 33 格的剑 279,道具 71084):
    • 上限 10 次:洗满 10 次后停止(limit),约 4 次/秒。
    • 两套方案、阈值 1:第 18 次达标(matched)。
    • 已经达标的物品:0 次就停止,不扣道具。
    • 洗练中把物品从 33 格移到 90 格:继续洗,窗口跟到 90 格;点停止后显示 stopped。
    • 洗练中退出客户端:服务端立即停止。
    • log.log 中 CHANGE_ATTRIBUTE 共 72 行,和总次数一致。
    • 截图里窗口布局正常。仓库自带的 Client 是英文 cp1252 locale,所以中文显示为 ????;需要 zh locale 客户端才能看到中文。
  • 联机测试发现并修复了两个窗口问题,test_switchbot.py 已加回归用例:
    • 洗练中移动物品后,选中项会跳到别的物品:现在按服务端报告的格子跟随。
    • 空闲时移动物品后选中项丢失:现在退而按相同 vnum 匹配。
  • 服务端 tests/features/test_switchbot.py 和 test_queries.py 通过。203 的隔离目录 /root/metin2-features-dev 完整编译通过。

未完成

  • Android 真机测试;busy、no_scroll 只有单元测试,没有联机验证。
  • macOS 构建需要 -DMT_40250_SOURCE=<含 EterPack/EterPack.cpp 的源码目录> 来生成 pack 密钥,否则 system.py 读不出来(RunMain Error)。本机没有 40250 源码,这次用的是 AVA2 的 TEST/3. Source BIN/Client,两者密钥相同。
  • 服务端还没有部署到 203 正式环境。
  • 属性锁定(阶段 6 后半):需要单独的存储设计。