WPIAO - 将预览物品作为套装穿戴

通过“将预览装备作为服装穿戴（WPIAO）”功能，彻底改变你的《巫师3》游戏体验！

经过一个月的紧张开发，这款模组为《巫师3》带来了强大的服装管理系统，灵感源自《赛博朋克2077》，让你能够轻松创建、预览和切换自定义视觉套装。无论你是追求时尚的猎魔人，还是只想简化物品栏，WPIAO都为你提供了无缝直观的系统，直接集成到游戏界面中。

WPIAO 是做什么的？

基本上是一个《巫师3》的幻化系统。

WPIAO允许你管理和保存多达10套服装组合，每套支持多个装备槽位（如护甲、武器、手套、靴子）。
你可以通过在物品栏菜单中使用预览物品键来搭配服装，为搭配的物品染色，并随时切换套装——所有这些操作都无需离开物品栏菜单。
该模组完全集成在原版物品栏菜单中，无需特殊配置菜单或虚假对话控制。

与改变外观的模组不同，WPIAO 是基于物品而非外观运作的，因此不需要为每套护甲变体或颜色创建实体模板——无论是原版还是为支持槽位设计的自定义模组物品，都应自动兼容。
多件已装备的物品会在它们所属的任何套装中持续存在，并且可以存入仓库或放置在盔甲架上，以避免占用背包中宝贵的重量点数。

这个模组的制作过程并不简单。
为了让其成为可能，开发者必须深入研究装备系统的内部运作机制，在此过程中产生了超过50KB的纯调试代码。
我很乐意将这些代码作为可选文件提供给其他模组制作者学习参考。
但最终的模组应该简单直观，易于使用。

✨ 主要特色

服装管理

• 创建并保存最多10套服装组合：可存储多达10套服装搭配，每套支持多个装备槽位（如护甲、武器、手套、靴子）。

• 即时切换套装：通过热键一键轮换服装！在物品栏菜单中使用X（长按）+A/Y（手柄）或X（长按）+Home/End（键盘）切换套装。注意：部分键盘布局（尤其是笔记本或紧凑键盘）若Home/End键具有其他功能（如滚动），可能需要配合Fn键使用Home/End。

• 开关服装系统：切换到中性状态（无激活服装套装）可禁用服装系统，像未安装模组时一样预览物品。

• 不影响属性数值：实际装备的物品影响角色属性，而外观装备的物品不影响。这允许通过纯物品栏菜单操作，无需任何特定物品外观替换模组或手动文件移动，即可实现任意装备属性与任意同槽位外观的自由搭配。

• 支持过场动画：若过场动画中角色实际装备被卸下，对应外观装备也会同步卸下。若动画结束后游戏自动重新装备动画前的相同物品，外观装备将自动恢复。若过场动画后角色保持未装备状态，外观装备将保持卸下但不会丢失套装设置，仍可通过热键重新装备。

注意： WPIAO不支持更改武器外观。武器并非服装。无法通过WPIAO中为服装设计的方式添加对武器的支持。未来版本可能会实现此功能，但需要投入更多开发精力。

库存与预览功能增强

• 随处存储服装物品：即使装备物品存放在储物箱中或当前未装备，也能保留杰洛特的外观。

• UI视觉反馈：已装备物品会显示便捷的眼睛图标，当前套装外的物品会变暗以清晰区分，而当前套装内的物品则保持高亮。

• 服装染色：可直接对服装物品进行染色，即使它们被存放或不在当前物品栏中。当对已装备物品的槽位使用染料时，将染色服装物品而非装备物品，且无需从储物箱或盔甲架上取下服装物品即可远程操作。

• 物品追踪：无论装备物品被移动至多少个容器中，都会被追踪。但如果装备物品被拆解、丢弃到地面、出售或以其他方式失去明确去向，则将从服装套装中移除。若在未先从盔甲架上取下的情况下开始新游戏+，盔甲架上的物品也将从服装套装中移除。

• 隐藏装备：对未装备服装的已装备物品按下预览键，可在套装中添加一个空槽位，从而隐藏该装备物品的外观。

💻 技术方面

本模组完全基于注解构建，避免直接修改游戏脚本且无需合并。仅兼容游戏最新的4.04热修复版本。

我特别允许以任何方式使用、再利用、扩展、重新利用、改编、修复、修补或将我的模组代码用作基础。

涉及的诡计（技术细节）

这个模组不仅仅是简单地替换某些内容而保持其他部分不变。为了实现所有功能正常运行，我们编写了大量脚本。其中涉及的代码技巧堪比古老的黑魔法！

由于发现这些宝贵信息非常困难，而其成果对模组制作者可能很有帮助，我已尽力创建了注释详尽、自解释的代码，让人能轻松理解模组代码的运行逻辑。

为了分离外观与属性，WPIAO会创建物品的技术性视觉副本，在不影响属性或重量的情况下与真实装备物品同时挂载。这个技术性外观物品并非装备在角色身上，而是与真实装备物品一起挂载在角色实体上。

要实现同时挂载无属性的视觉物品和满属性的装备物品，必须探索物品强制挂载的特性，并通过深入研究内部机制来克服该技术的不稳定性。

能够取得这些进展，全靠我们发现了一个至关重要的物品实体事件——物品附着到实体的事件。这让我们能够检测到非脚本控制的物品装备行为，而是引擎本身的物品挂载行为。

隐藏装备物品的操作则完全相反——技术上解除真实装备物品的挂载，并将其所有属性转移到游戏用于"未装备物品"状态的技术性物品上。整个过程都被完整追踪，一旦设置发生任何变化，就会恢复为默认状态。

调试包（可选，供模组开发者使用）

在制作这个模组过程中获得的关于游戏内部运作机制的见解非常宝贵。而达成这一目标耗费了大量时间和精力，并编写了复杂的调试代码。由于这些调试代码可能帮助其他模组开发者实现其他可能的调整、修改、创建新模组，或出于任何其他目的更好地理解游戏内部机制，因此决定分享为制作此模组而创建的完整调试包。现提供一个独立的调试包用于故障排除——非常适合模组开发者或好奇的玩家。

🛠️ 安装

1. 下载主文件

2. 将 modWearPreviewItemsAsOutfits 解压到你的 mods 文件夹中。

3. 打开文件： [您的文档文件夹路径]\The Witcher 3\input.settings

4. 添加绑定：

   [空上下文]
   IK_X=(动作=WPIAO_预览键)
   IK_Pad_X_SQUARE=(动作=WPIAO_预览键)
   

   注意：这些键位绑定不应更改为任何其他键。它们旨在与物品菜单中预览键的原始绑定相匹配，该预览键在物品栏上下文脚本中定义，仅通过这两个键即可改变原始键的行为，新增两组按键组合：X（按住）+ A/Y（手柄）或 X（按住）+ Home/End（键盘）。 以防万一：不使用这些按键也可以运行模组，但模组将仅限于一套服装，无法切换套装。

5. 如果你想在更换服装套装后（关闭菜单后）播放动画：

   • 下载可选文件 - "WPIAO - 套装切换动画"
   • 将modWearPreviewItemsAsOutfits_setAnim解压到您的mods文件夹中。
   • 感谢Strahlimeier提供触发动画的代码行

6. 如果你使用活跃勋章模组：

   • 下载可选文件 - "WPIAO - Active Medallion兼容性补丁"
   • 将modWearPreviewItemsAsOutfits_AM_Compat解压至你的mods文件夹。

7. 如果使用自定义玩家角色（CPC）模组：

   • 下载可选文件 - "WPIAO - CPC兼容性补丁"
   • 将modWearPreviewItemsAsOutfits_CPC_Compat解压到您的mods文件夹中。
   • 仅支持真实装备模式，在全自定义模式下服装将无法使用（但安装补丁后不会导致游戏崩溃）。

8. 如果你想安装调试包：

   • 下载可选文件 - "WPIAO - 调试文件"
   • 将modWearPreviewItemsAsOutfits_debug_files解压到你的mods文件夹中。
   • 要使用调试包，你需要在《巫师3》中启用 -debugscripts 命令行参数，这样游戏才会生成日志。
   • 推荐使用SnakeTail等工具来查看游戏日志。

🎮 使用方法

1. 打开物品栏菜单
2. 将物品装备到当前套装中： 按 X（手柄）或 X（键盘）键，就像预览物品时那样。进入预览后，该物品就会被添加到装扮中。
   寻找物品上的眼睛图标以确认它已激活。
3. 更换服装套装：按住 X（手柄）或 X（键盘），然后使用 A/Y（手柄）或 Home/End（键盘）循环切换套装。
   您将看到确认切换的通知。
   带有眼睛图标的高亮物品属于当前套装，而带有眼睛图标的灰暗物品属于另一套装（未激活）。
4. 染色服装： 装备一件物品后，直接使用染料——无需实际装备该物品即可染色

⚠️ 警告/兼容性问题/可能的错误

该模组对物品栏菜单脚本进行了大量修改

该模组专为原版物品栏菜单设计。
本模组不修改任何 .redswf 文件。
因此，基于原版物品栏菜单且未大幅改动脚本的 .redswf 文件修改类模组应可兼容。
根据 Strahlimeier 的反馈，WPIAO 已与 Vladimir UI 进行过测试并确认可用。
其他大幅修改物品栏菜单脚本或彻底重制物品栏菜单的模组可能存在严重兼容性问题。
尽管本模组仅使用注解且不直接编辑脚本，但若其他模组对物品栏菜单脚本改动过大，
虽可能与本模组共同编译，但会引发bug甚至致命错误。
如遇此类兼容性问题请提交报告，我将尝试在本章节下列出，但无法保证会发布补丁。

该模组追踪玩家角色上物品装备的变动。

简单来说，这意味着当任何涉及模组所影响插槽的变更发生时（若该插槽上存在服装物品），模组会对事件作出响应并可能重新装配正确的物品。也就是说，如果另一个模组试图以类似方式对类似事件进行类似操作，就可能发生冲突并导致错误。

目前我遇到的唯一与WPIAO以这种方式冲突的模组是《自定义玩家角色》。通过添加兼容性补丁解决了这个问题——该补丁位于单独的可选文件中。仅真实装备模式获得支持，而在完全自定义模式下服装系统将无法运作（但安装了补丁后不会造成任何破坏）。

使用的诡计水平确实留下了很大的问题空间

请注意，该模组较为复杂。尽管在开发过程中手动检查了超过500个测试用例，但仍有可能遗漏某些问题，甚至可能是重大缺陷。请发现此类问题并报告，即便无法修复，也能警示其他用户。

该模组会将修改后的数据保留在存档中。理论上卸载模组后仍可继续游玩，但为确保所有改动对原版物品的影响最小化，请在卸载前将所有套装中的外观物品全部卸下。若问题仍未解决且出现异常，则可能需要通过控制台移除受影响的物品，并添加一个未受模组影响的原始副本。

🎉 愚人节惊喜！（2025年4月1日）

觉得这只是精心设计的愚人节恶作剧？
服装、染色收藏品、快捷键切换、超过500个测试用例——
听起来4月1号这天好得不像真的，对吧？
骗到你啦！但转折来了：这可不是玩笑！
WPIAO是100%真实的，功能齐全，
准备彻底革新你的《巫师3》衣橱。
亲自试试看吧！

我的其他模组

• 能力艺术家 - 用诱变剂绘制能力（次世代）
• 杂交猎魔人套装加成与猎魔人十字弩套装加成（次世代版）
• 合并黄色能力（技能）（次世代版）
• 非战斗状态肾上腺素系统重制（次世代版）
• 获得耐受性 - 延迟恢复 - 代谢提升 - 快速代谢 - 调整（次世代版）
• 修复新游戏+中"碎片之刃"和"冬之刃"的复制问题
• 新游戏+ 全凯尔莫罕装备（次世代版）
• 众多增益效果列表 - 突破限制（次世代版）
• 新游戏+模式中的菜单和文本教程已恢复（次世代版）