shenleiandClaude Opus 5.5
aeb67f3c9c
A tree close to the camera is drawn by RenderPCBlocker, not RenderTree, so background.SetVisiblePart(PART_TREE, 0) left it on screen. Skip tree blockers while PART_TREE is hidden. Live screenshots on the 203 test core confirm the tree, the GM mark and the weapon glow now disappear. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
57 lines
3.7 KiB
Markdown
57 lines
3.7 KiB
Markdown
# AVA2 显示开关适配进度（v1）
|
||
|
||
2026-10-15。只改了 metin2-client，服务端不需要改动。参考了 AVA2 的 `ENABLE_GRAPHIC_ON_OFF`（`InstanceBase.cpp` 中 `__CanRender` 的 effect_level 0–4）和 `HIDE_OBJECTS`（`background.SetVisiblePart`）。
|
||
|
||
## 与 AVA2 的差异
|
||
|
||
| 项目 | AVA2 | 本实现 |
|
||
| --- | --- | --- |
|
||
| 特效等级 | 0–4，在渲染判断里跳过 | 相同的 5 档；在 `CInstanceBase::Update` 中对角色挂载的特效调用 Active/Deactive，不改渲染路径 |
|
||
| 摆摊、宠物、坐骑的显示范围 | 有 | 不移植：经典版没有离线摆摊和宠物 |
|
||
| 树木、云 | `background.SetVisiblePart` | 相同，使用原有接口 |
|
||
| 名字、伤害数字 | 原有选项 | 窗口内加了快捷开关，仍然写原来的 systemSetting，退出时由原配置保存 |
|
||
|
||
## 特效等级
|
||
|
||
| 等级 | 显示的特效 |
|
||
| --- | --- |
|
||
| 0 全部特效 | 全部 |
|
||
| 1 只看怪物特效 | 自己、怪物、灵石 |
|
||
| 2 只看玩家特效 | 自己、其他玩家 |
|
||
| 3 只看自己特效 | 只有自己 |
|
||
| 4 关闭全部特效 | 无，包括自己 |
|
||
|
||
## 客户端
|
||
|
||
- C++：
|
||
- `CEffectManager::ActiveEffectInstance`。
|
||
- `CActorInstance::SetAttachingEffectShown`：对已挂载的特效调用 Active/Deactive；关闭期间新挂载的特效也会立即 Deactive。使用 Deactive 而不是 Hide，避免和刺客隐身的 Show/Hide 冲突。
|
||
- `CPythonSystem::Get/SetEffectLevel`，越界值按 0 处理；不写入 metin2.cfg。
|
||
- `systemSetting.SetEffectLevel/GetEffectLevel`。
|
||
- `CInstanceBase::__UpdateEffectShown`，每帧在 `Update` 开头按上表判断。
|
||
- `CMapOutdoor::RenderPCBlocker`：离镜头近、挡住角色的树会作为遮挡物（PC blocker）单独绘制，不经过 `RenderTree`，所以原来关闭树木后这类树仍然显示。现在隐藏树木时跳过遮挡物中的树。AVA2 有同样的问题。
|
||
- 模块 `mt_display`（`src/platform/ScriptLib/DisplayScript.inc`），在 `PythonBoot.cpp` 中安装：
|
||
- 入口是小地图旁“拾取”下方的“显示”按钮。
|
||
- 窗口“显示设置”包含 5 个特效等级、显示树木、显示云、总是显示名字、显示伤害数字，`【】` 表示当前选中。
|
||
- 设置保存在客户端目录的 `mt_display.cfg`，格式为“特效等级 树木 云”，默认 `0 1 1`，损坏时回到默认值。
|
||
- 特效等级在启动时生效；树木和云在进入游戏（`GameWindow.Open`）时生效。
|
||
|
||
## 证据
|
||
|
||
- `tests/wiki/test_display.py`（CTest：`port.display`）共 3 项通过，覆盖：
|
||
- 默认值、配置文件读写、损坏的配置；
|
||
- 进入游戏时生效，窗口按钮、配置保存、名字和伤害开关；
|
||
- 5 档和 C++ 规则一致。
|
||
- `test_pickup.py`（7 项）和 `test_switchbot.py`（6 项）仍然通过。
|
||
- 2026-10-15 联机测试（203 测试核心 channel5，macOS 原生客户端，账号 admin）：
|
||
- 切到等级 4 并关闭树木后，配置为 `4 0 1`；恢复后为 `0 1 1`。
|
||
- 截图确认窗口布局正常。
|
||
- 用 `/goto 646 798` 走到离树约 7 米的位置截图对比：等级 4 时 GM 标志和武器光效消失；关闭树木后树消失（修复遮挡物问题之前，这棵树仍然显示）；恢复后都回来。
|
||
|
||
## 限制和未完成
|
||
|
||
- 只控制挂载在角色上的特效（装备光效、buff、种族特效）。单独播放的特效和飞行特效（技能弹道、命中特效）不受影响。
|
||
- macOS 桌面客户端没有中文字体，窗口文字显示为 `?`（原版界面同样乱码）；Android 使用 CFF FreeType，不受影响。
|
||
- 树的影子烘焙在地形阴影图里，关闭树木后地面上仍有树影（与 AVA2 相同）。
|
||
- Android 真机测试未做。
|