物品浏览器

描述

游戏中每一件物品，一键即得。物品浏览器是 Apocrypha Menu Framework 中的一个页面，列出了《巫师 3》、《石之心》、《血与酒》以及免费 DLC 所定义的所有物品——超过 4,000 件，并带有它们在游戏中的真实名称——并可将其中任意一件放入杰洛特的物品栏。同时搜索全部内容，按类别筛选，以 3D 方式查看物品翻转，保留收藏，并一次性添加一整堆药水或制作材料。

它就是《上古卷轴 5：天际》和《上古卷轴 4：湮灭 重制版》中的物品浏览器，被带到了《巫师 3》：同一个页面，同一个理念，以《巫师 3》的方式实现。

生成式 AI 披露： 本模组的代码、翻译、本页面的文本及其横幅均由生成式 AI（Claude）生成，由作者在游戏内指导并测试。本页面已相应标记。

主要功能

• 搜索所有来源。 一个搜索框即可按名称——或按游戏自身的物品名称——搜索游戏中的所有物品，并按名称列出匹配结果；物品卡片会显示其类型、来源、重量、价值以及游戏内的物品名称。关闭搜索即可按来源逐个浏览：本体游戏、《石之心》、《血与酒》以及每个免费 DLC。
• 一键添加。 每行开头是“查看”、收藏星标和“添加”——对于任何成堆持有的物品（药水、剑油、炸弹、原料、制作组件、弩箭、符文和雕文、染料、修理工具、食物）还带有一个“数量”滑块——然后是物品名称。单件装备则添加一件。
• 以 3D 方式查看物品。 “查看”会在框架的菜单列表上方打开物品卡片：物品本身——剑、护甲、十字弩、战利品、面具等，超过 1,100 个模型直接从游戏自身的文件中读取——打光并旋转展示。可拖动它、使用方向键或右摇杆旋转；使用滚轮、+ / - 或左摇杆缩放。没有模型的物品会显示游戏自身的物品栏图标。已染色的护甲以默认染料颜色显示，与游戏着色方式一致。
• 显示所选物品。 开启后，卡片会跟随高亮项：用方向键沿列表下移，每件物品会依次显示，无需按“查看”，同时可用右摇杆旋转它。菜单关闭时该功能会自动关闭。
• 可放置的卡片。 卡片可停靠在菜单列表上方，使整个页面在它旁边保持可见。拖动其标题即可将其放到任意位置，或设置“面板横跨”/“面板下移”/“面板尺寸”——用鼠标或手柄均可——它会停留在你放置的位置。
• 按类别筛选。 十六个开关：武器、弩箭、护甲、图纸和配方（与其制成的物品分开列出）、药水/剑油/炸弹、炼金原料、制作组件、符文/雕文/染料、修理工具、食物、书籍、昆特牌、马具、战利品、钥匙、杂物——下方还有更细的类型（钢剑和银剑、手套、靴子……）。可按名称、价值或重量排序。任务物品带有标记，且可隐藏。
• 收藏。 为任何物品加星标，即可在“收藏”标签页中再次找到它，并可使用“添加”、“数量”和“查看”。收藏在会话之间保留。
• 同样为手柄而设计。 每个控件都可通过方向键访问；框架的屏幕键盘可输入到搜索框中；B 键关闭卡片。
• 十一种语言——英语、日语、韩语、中文、俄语、德语、法语、西班牙语、意大利语、波兰语和捷克语——跟随框架的语言设置，物品名称使用游戏自身的语言。
• 无需脚本合并。 本模组的脚本仅通过注解向游戏脚本添加内容；不替换任何游戏脚本。

物品添加方式

该页面无法直接调用游戏脚本，因此它将每个请求交给模组自己的小型脚本，该脚本使用游戏自身的添加物品调用——与控制台使用的相同——来添加物品，并返回应答。物品在世界运行时到达：如果游戏在菜单后方处于暂停状态，它们会在你返回游戏的瞬间落位，页面在等待时会显示相应提示。

安装说明

• 先按照其页面所述安装 Apocrypha Menu Framework（1.0.2 或更高版本）。
• 使用模组管理器（Mod Organizer 2 或 Vortex）将物品浏览器作为普通模组安装，或将压缩包中的 bin 和 Mods 文件夹复制到游戏文件夹中。
• 打开框架并选择物品浏览器。

已知限制

• 其他模组添加的物品（Brothers In Arms、The Stable 等）暂未列出。
• 护甲的布料部分（衣摆、披风）不会绘制在 3D 物品上，且护甲以其制作时的姿势显示（双臂张开）。
• 添加物品在扮演杰洛特游玩时生效。

调试

最快途径：Discord 上的 Apocrypha Realm Modding Hub——在与你的报告匹配的论坛（bug-reports、feature-requests、patch-requests、mod-conversion-requests）中发帖；那里的提交会直接进入处理流程。 如需提交错误报告，请发送 bin\x64_dx12\ItemExplorer\ItemExplorer.log（在 Mod Organizer 2 下为 overwrite 文件夹）：每次添加、每次模型读取和每次图标查找都会被记录。在 ItemExplorer.ini 中设置 uLogLevel=0 以记录所有内容。

前置需求

《巫师 3：狂猎 - 重制版》	补丁 5.0 或更高版本，DirectX 12
Apocrypha Menu Framework	1.0.2 或更高版本——提供页面、通往游戏脚本的桥接、屏幕键盘、图片和 3D 视图；按照其页面所述安装（Mod Organizer 2 配合 Root Builder，或 Vortex 配合 ASI 加载器）

兼容性说明

物品浏览器不替换任何游戏文件。它从你的安装中以只读方式读取游戏自身的物品定义、名称、图标和模型。其脚本包装了玩家对象的一个方法（通过注解），可与其他对玩家对象进行注解的模组叠加；替换整个 playerWitcher.ws 的模组也可使用，只要其副本保留了游戏自身的 UpdateGamepadTriggerEffect 计时器（当前的模组都保留了）。

致谢

CD PROJEKT RED——《巫师 3》，物品浏览器从你的安装中读取其物品定义、名称、图标和模型。 《上古卷轴 5：天际》和《上古卷轴 4：湮灭 重制版》的物品浏览器（同一作者）——本版本延续的设计。 dingdio 的 Witcher3-Blender-Tools——其对游戏模型格式的文档指导了模型读取器（从零编写）。 Dear ImGui（Omar Cornut）、spdlog（Gabi Melman）、{fmt}（Victor Zverovich）和 zlib（Jean-loup Gailly 与 Mark Adler）——见下载包中的 THIRD_PARTY_NOTICES.md。

支持我的工作

如果本模组对你有用，你可以在 Patreon 上支持这项工作。 每个模组都保持免费并采用 GPL；支持让整个流程持续运转。

源码

GPL-3.0-or-later：github.com/ApocryphaRealm/ItemExplorerW3，每个版本均有标记。 本包为 v1.0.0（发布标签）。