vW3-FrameW

vW3 - FrameW 1.1.0

《巫师 3 重制版》（次世代版）PC 5.01 版本的模块化框架与连接器层。

FrameW 为独立模块提供共享核心，并为模组作者提供与游戏系统对接的通用连接器。安装一次核心，即可添加所需的 FrameW 模块。每个模块都有自己的 mod 文件夹和独立的 WitcherScript 文件；游戏会自行编译这些脚本。

1.1.0 版（API 1.14）新增内容： 用于菜单、HUD、导航、世界地图、列表和卡牌游戏的呈现切面；电影帧率连接器；字体连接器；带加载包和自定义提示的加载画面；以及适用于所有图钉（包括原版图钉）的地图图钉连接器。新增连接器在下文中以该颜色显示。

为什么使用 FrameW？

遵循 FrameW 约定的模块使用共享连接器，而不是替换相同的游戏脚本。核心会合并兼容的贡献，例如地图标记和 HUD 可见性规则。在只能由一个提供者控制某项功能的情况下（例如 HUD 尺寸或地图图标包），你在框架菜单中选择提供者。

这使得符合规范的模块无需脚本合并即可协同工作。你可以独立添加或移除模块，或在 选项 > 模组 > vW3 FrameW 下将其关闭。任何模块需要核心时，请保持核心已安装。FrameW 不会自动将现有模组转换为模块。

连接器概览

这些是提供连接器的领域，而非核心启用的玩法更改列表。实际功能由模块提供；各个连接器有各自的限制。

• HUD 与任务追踪器： 可见性、不透明度、支持的缩放与定位、上下文条件与淡入淡出；生命/耐力显示、增益、任务追踪器、敌人/Boss 显示、物品信息、消息及其他受支持的 HUD 元素。自定义文本、绘制、世界标签和 NPC 语音过滤器。 新增 - HUD 呈现： 可分别选择生命体征、状态条、增益、快捷槽、任务追踪器、消息流、交互提示、敌人名称、氧气、马匹和船只显示的样式、布局和时机。仅涉及呈现；生命、耐力、效果和任务状态保持不变。
• 世界地图、小地图和罗盘： 自定义图钉和标记、类别、筛选标签页、叠加层、图钉文本和徽章、任务等级信息、图标包、基础地图和小地图图块集；小地图缩放/旋转、罗盘贡献、距离标签和快速旅行规则。 新增 - 地图图钉连接器： 针对每个图钉（包括原版图钉）的标签、描述、图标、色调、缩放、光环以及图标周围五个位置的徽章；用于隐藏或重排单个图钉的图钉通道；地图控制（居中到某个位置、显示某个区域）以及图钉被选中或使用时的的事件；地图上的模块 UI：工具提示布局、文本面板、键盘和手柄提示，以及模块自己的 Flash 影片。 新增 - 地图呈现： 视口和导航行为、日志和图例布局、战争迷雾样式和数据，以及现有的基础地图和图标包槽位。 新增 - 导航切面： 小地图边框、布局、图钉样式和天气显示；罗盘标签和效果；标记可见性、发现和碰撞规则。
• 物品栏、物品、商店和制作： 装备事件和等级检查、物品栏槽位和工具提示装饰、物品筛选和槽位选择、耐久损耗、制作成本、商店价格和交易事件、战利品可见性和拾取事件、消耗品规则、充能和补充提供者。 新增 - 集合： 物品栏、制作、炼金和书籍的列表顺序；列表间距；纸娃娃和物品预览样式；径向菜单样式和选择呈现。
• 战斗、耐力和法印： 伤害修饰符、耐力消耗和法印强度；命中/死亡通知、攻击蓄力和特殊攻击充能事件；格挡、反击、终结技、肢解、动作缓冲和目标选择的规则。效果通知和增益免疫规则。
• 径向菜单和输入： 径向菜单中的模块条目、打开/关闭/选择通知、输入观察、自定义操作和按键绑定声明，以及受支持的内置操作（包括法印选择）的提供者选择。
• 玩家、摄像机、马匹和船只上下文： 冲刺/跳跃规则、装备和可用物品事件、摄像机提供者槽位；骑乘/船只 HUD 条件、马匹耐力/恐慌和船只生命 HUD 元素。这些是特定的钩子，而非通用的载具或摄像机大修。
• 菜单和设置： 模块开关、提供者选择、模块设置和更改通知；菜单生命周期、角色菜单数据装饰、预设和设置保存事件。 新增 - 菜单动效： 菜单动画、标签页和提示行为与样式、工具提示行为和布局，均可独立选择。
• 新增 - 加载画面： 每次加载和快速旅行都会成为一个加载操作，模块可以读取。加载包提供区域图像、纹章、本地化区域标题、加载指示器、图像动效及其自己的字体。提示可以保持原版、跟随区域或隐藏；模块可以添加自己的提示文本，支持最多 18 种语言，并选择提示字体、大小和颜色。同一时间只有一个加载包处于活动状态。
• 新增 - 字体： 包可以自带 TrueType 字体（及其许可证），其他连接器通过 ID 使用它，例如加载画面标题和提示。
• 新增 - 卡牌游戏呈现： 卡牌、效果、天气和横幅的时机，以及呈现样式。卡牌、牌组、分数、规则和对手保持原版。
• 新增 - 电影帧率： 模块可以为菜单和卡牌游戏影片提供帧率（原版、60、120 或 144）。你在框架菜单的“电影帧率”页面为每个影片选择一项；该选择在核心 UI 使用 Dev-Kit 工具重建后生效。这是构建时选择，而非实时切换。
• 存档、会话和世界事件： 游戏开始、玩家生成、加载完成、世界变化、场景/战斗转换和会话结束；存档开始/存档完成通知、任务事实、游戏事件、定居点进入/退出以及模块之间的消息。
• UI 影片和图标： 核心修补的世界地图、小地图、径向菜单和 HUD 标签影片暴露共享 UI 扩展。模块可以提供自己的图标和受支持的地图图形，而无需各自替换这些影片。 新增 - 影片切面： 核心现在拥有所有原版影片路径，并在其中提供 47 个独立的呈现选项。模块提供设置和自己的图像，绝不替换 SWF；空选项保持原版。

我需要哪个文件？

主文件 - 核心： 共享运行时、框架菜单、连接器服务和修补后的 UI 影片。正常游玩请安装此文件，然后单独安装你选择的模块。核心是基础；连接器列表并不意味着它会安装所有示例功能。

可选文件 - Dev-Kit： SDK 文档、模板和开发工具，以及供模组作者使用的 25 个示例/测试模块。示例涵盖地图、HUD 规则、标记/罗盘、战斗/耐力、连接器、UI 影片和图标提供者选择、呈现切面、电影帧率，以及带有自己字体和提示的加载包。它们演示 API，可能会故意更改玩法或显示测试图形；请只安装你打算查看的示例。正常游玩不需要 Dev-Kit。

要求

• 《巫师 3 重制版》（次世代版），PC 5.01 版本。其他游戏版本不在本版本的支持目标范围内。
• 每个 FrameW 模块都需要核心；满足该模块声明的任何附加要求。
• 使用 FrameW 游玩不需要脚本合并、WMM、ASI/DLL 插件或后台进程。
• 对于使用 Dev-Kit 工具的作者：需要 Python 3.11 或更新版本。SDK 的编译检查和 UI 构建需要 REDkit，但游玩已安装的模块不需要。

安装与移除

安装： 使用 FOMOD 安装程序，或将提供的 Mods/ 和 bin/ 内容手动复制到游戏文件夹；先安装核心，然后安装你选择的模块。 卸载： 删除所选模块自己的 mod 文件夹及其在 bin/ 下提供的菜单/配置文件（不要删除共享的 Mods/ 或 bin/ 文件夹）；只有在移除需要核心的模块后才移除核心。 从 1.0.0 更新： 用 1.1.0 替换核心；现有的 1.0.0 模块继续正常工作。

兼容性与限制

FrameW 协调使用其约定的模块；它不能保证与所有外部模组兼容。替换相同脚本或方法的模组可能会绕过连接器或导致脚本编译错误。重复的脚本名称、冲突的数据/资源路径以及不兼容的玩法更改仍可能发生冲突。

只能加载一份 UI 影片。另一个模组替换世界地图、小地图、径向菜单、HUD、菜单或加载画面 SWF 可能会禁用相应的 FrameW 扩展，或使其使用回退视觉效果。独占提供者选择会选定一个实现；它们不会组合两个替换项。请遵循每个模块自己的依赖和移除说明，尤其是当它更改已保存游戏内容时。

致模组作者

从 Dev-Kit 的入门指南、模块约定、服务指南和 API 参考开始。使用唯一前缀和你自己的脚本文件夹，通过核心注册，并对其拥有的入口点使用其连接器。SDK 提供验证和编译检查工具。可用的钩子有定义的范围；FrameW 不通过这些连接器提供任意原生引擎、AI、动画或任务内容编辑。