石英

【标题】
《7 Days to Die》石英（Quartz）UI 框架 MOD 使用指南
【核心介绍】
为《7 Days to Die》提供可扩展的 UI 开发框架，支持模组作者通过 XML 或 C 快速添加新控件与交互逻辑，无需修改游戏源码。
【安装指南】
1. 下载：获取对应游戏版本的「Quartz」MOD 包（v3.0.0 适配《7 Days 1.0》；v2.2.0–v2.3.0 适配 A21.2；v2.0.0–v2.1.0 适配 A21–A21.1；v1.7.1 及以下适配 A20）；
2. 解压：使用 WinRAR 或 7-Zip 解压压缩包；
3. 粘贴：将解压出的 `0-Quartz` 文件夹复制到游戏根目录 `/Mods` 文件夹（或 `%AppData%/7DaysToDie/Mods`），覆盖同名文件；
4. 验证：确认路径 `Mods/Quartz/ModInfo.xml` 存在；
5. 关键前置操作：必须关闭 Easy Anti Cheat（客户端与服务器端均需关闭），否则 MOD 无法加载；
6. 启用依赖：安装依赖「Quartz」后，再安装基于它构建的 UI 模组（如「SMX」）。
【功能详情】
✅ 已优化：新增可直接在 XUI XML 中调用的 XUi 控件（如自定义按钮、进度条等）；
✅ 已优化：新增可绑定至任意 UI 元素的 XUi 控制器（支持动态数据绑定与事件响应）；
❌ 未修改：不改变游戏原有 UI 布局、贴图或文字内容；
✨ 额外调整：所有功能同时兼容 C 模组调用，支持深度 UI 扩展开发。
【使用要求】
– 必备条件：游戏版本须与「Quartz」版本严格匹配（见安装指南第 1 步）；
– 强制要求：客户端与服务器端均需安装「Quartz」，且 Easy Anti Cheat 必须全程关闭；
– 运行环境：仅支持 Windows 平台（Linux/macOS 未测试，不保证可用）。
【兼容性说明】
– 兼容范围：所有基于 XUI 系统开发的 UI 模组（需明确声明支持 Quartz）；
– 不兼容模组：任何启用 Easy Anti Cheat 的模组或服务器；
– 兼容补丁：暂未推出针对 Easy Anti Cheat 的兼容方案。
【注意事项】
– 关闭 Easy Anti Cheat 的操作请参考官方说明或社区教程（视频链接仅作参考，非本 MOD 提供）；
– 若服务器未同步关闭 Easy Anti Cheat，客户端将无法连接；
– 安装后若 UI 无变化，请确认所用 UI 模组是否真正依赖「Quartz」并已正确加载。
【更新日志】
– 2023 年 10 月 15 日 新增 v3.0.0 版本，适配《7 Days 1.0》；
– 2023 年 3 月 22 日 发布 v2.3.0，修复 A21.2 下部分控制器初始化异常；
– 2022 年 8 月 5 日 初始开源发布（v1.0.0），支持 A20 全版本。