模组设置框架

【标题】
《巫师 3》模组设置框架 MOD 使用指南
【核心介绍】
为《巫师 3》模组提供标准化设置接口，自动解析模组菜单 XML 文件生成可靠配置代码，避免手动读写错误，简化设置调用与响应逻辑。
【安装指南】
1. 下载并安装「modSettingsFramework」；
2. 根据你的游戏版本（原版 / 「血与酒」 / 「石之心」），下载对应版本的「modSettingsFrameworkHooks」；
3. 将两个文件夹同时解压至游戏根目录 `/mods` 文件夹中（缺一不可）；
4. 若存在脚本冲突，请使用 脚本合并工具 手动解决；
> ⚠️ 本 MOD 为纯依赖框架，自身不提供任何游戏内功能，仅服务于其他依赖它的模组。
【功能详情】
✅ 已优化：自动生成设置读取/写入逻辑，替代易出错的手动 `GetVarValue` / `SetVarValue` 调用；
✅ 已优化：支持通过 XML 定义模组菜单结构，框架自动绑定变量与 UI 控件；
✅ 已优化：提供统一事件回调接口，响应开关、滑块等设置变更；
❌ 未修改：不改动游戏画面、音效、模型、剧情等任何游戏内容；
❌ 未修改：不添加新菜单界面、图标或本地化文本；
✨ 额外调整：v0.7+ 版本强制要求 XML 解析与运行时版本严格匹配，提升稳定性。
【使用要求】
– 必须运行《巫师 3》完整版（含「石之心」与「血与酒」扩展包之一或全部）；
– 游戏需为 1.33 或更高版本（旧版兼容性已终止）；
– 不支持非官方汉化补丁覆盖核心脚本文件的环境（可能引发解析失败）。
【兼容性说明】
– 兼容范围：所有基于 XML 定义设置菜单、且明确声明兼容本框架的模组（如「Dynamic Weather Overhaul」「Enhanced Lighting」等）；
– 不兼容模组：仍使用 v0.6 及更早版本框架的模组（如旧版「BetterHUD Settings」）；
– 兼容补丁：暂未推出跨版本兼容补丁；若需混用，请统一升级至 v0.7+ 并重新解析 XML。
【注意事项】
– 安装前请彻底卸载 v0.6 及更早版本的「modSettingsFramework」，残留文件将导致设置无法加载；
– 「modSettingsFrameworkHooks」必须与你的游戏版本完全匹配（例如：安装「血与酒」后需用对应 Hooks）；
– 框架不处理 UI 美化或翻译，相关功能由调用它的模组自行实现；
– 若启用多个依赖该框架的模组，建议按字母顺序加载（如 `a_*.zip` → `z_*.zip`），避免初始化竞争。
【更新日志】
– 2023 年 7 月 15 日：发布 v0.7，重构 XML 解析器，强制版本校验，移除向后兼容逻辑；
– 2023 年 3 月 22 日：新增对「石之心」独立存档的支持，修复多扩展包下配置路径识别异常；
– 2022 年 11 月 8 日：优化内存占用，设置变更回调延迟从 2 帧降至 1 帧。