metin2-client/docs/AVA2-BOSS.md

AVA2 世界 Boss 追踪进度（v1）

2026-10-15。参考 AVA2 uitrack 的世界 Boss 页，只读。服务端见 metin2-server docs/FEATURE-BOSS-TRACK.md。没有移植 AVA2 的传送按钮（它会改变游戏进程）；副本页已经由 mt_dungeons 实现。

与 AVA2 的差异

项目	AVA2	本实现
数据来源	专用封包	原有 /mt_features 查询，种类 bosses（能力位 256）
跨核心	不明（AVA2 服务端源码不在本机）	每个核心用原 HEADER_GG_RELAY 广播自己的 Boss 刷新点，旧核心会忽略
传送	有	无
提醒	有	有：刷新后在聊天框提示，以服务器快照为准

窗口

• 入口：小地图左侧按钮列中的“Boss”（换线按钮下方）。
• 标题“世界Boss”，有“刷新”“上一页/下一页”按钮，每页 8 行。
• 每行显示：
  • [CHn] 或 [共享]（频道 99）、Boss 名、地图名；
  • 状态（存活 a/m、刷新倒计时、即将刷新、不再刷新）、坐标（地图内坐标 /100，ANYWHERE 显示“随机位置”）、刷新周期；
  • “提醒：开/关”按钮，只能对未存活、有计时的 Boss 打开。
• 窗口打开时每 30 秒刷新一次。倒计时按服务器时间和本地经过时间计算。
• 名称：
  • Boss 名取自 nonplayer.GetMonsterName；
  • 地图名用服务端地图编号 → 地图目录（MAPS，取自服务端 map/index）在 localeInfo.MINIMAP_ZONE_NAME_DICT 中查找；
  • 找不到时显示“地图N”。

提醒

• 提醒的键是 (vnum, 地图, 频道, x, y)。
• 窗口关闭时，提醒过的 Boss 计时到期 2 秒后，客户端会主动查询一次。
• 只有新快照显示它存活时，聊天框才提示“X 已在 Y 刷新”，然后清除这条提醒；只到计时不提示。
• 服务器不再列出的 Boss 会被移出提醒。
• 离开游戏（换线、换角色）时，清空快照和提醒。

客户端

• 模块 mt_boss（src/platform/ScriptLib/BossScript.inc），在 PythonBoot.cpp 中安装，挂接 game.GameWindow.Open/Close。
• FeatureServiceScript.inc：
  • 新增 bosses 种类和 boss 行解析（13 项，X/Y 有符号）；
  • 校验 vnum/地图/周期非 0、频道 ≤ 255、alive ≤ max ≤ 255；
  • 一次最多 128 行。

证据

• tests/wiki/test_boss.py（CTest：port.boss）共 5 项通过，覆盖：
  • 入口位置、各状态文字、坐标、分页；
  • 只在确认刷新后提示；
  • 未启用和空列表的提示；
  • 关闭时复位；
  • 地图表。
• tests/wiki/test_service.py 新增 boss 行和旧服务端（cap 255）返回 unsupported 的测试。
• 2026-10-15 联机测试（203，macOS 原生客户端，账号 admin）：
  • 临时开了两个 channel5 核心：13040 放地图 1/21/41/68，13041 放地图 72/5。
  • 从任一核心进入游戏，窗口都列出两个核心的 5 个 Boss（海盗 5001 ×2、2307、1192、5161），倒计时一致。
  • 截图确认布局正常。测试后 channel5 已恢复原配置。

限制和未完成

• 只列出有定时刷新的 Boss 刷新点（regen 文件里 time > 0）；由任务或事件刷出的 Boss 不在列表中。
• 共享频道（game99）的 Boss 要等 game99 换上新服务端才会出现。
• 副本内地图（如 5、72）在 MINIMAP_ZONE_NAME_DICT 中没有名称，显示“地图N”。
• macOS 桌面客户端没有中文字体，窗口文字显示为 ?。
• Android 真机测试未做。