协和设置

协和设置

一个功能丰富的配置框架,适用于Stardew Valley模组,具有统一的设置浏览器、可自定义主题、配置文件管理、控制器导航、诊断功能以及可选的GMCM兼容性。



[center]

**⚠ 实验性提醒**

[/center]

> Accord Settings 目前处于公开测试阶段。

> **请在新建存档上测试后再用于主游玩存档。**

> **开发过程中仍可能出现意外问题。**


[center]**

# Accord Settings

*为兼容的星露谷物语模组提供统一的设置界面。*

**版本 0.1.0 — 公开测试版**

**[/center]**


[center]**
[图片]
[/center]

Accord Settings 是星露谷物语模组的配置平台。它为所有兼容的模组提供一个共享且一致的设置界面。
玩家无需打开单独的配置菜单,即可通过一个统一的界面浏览已注册的模组、搜索其设置、切换页面并管理其配置。
该框架包含其自身的导航系统、配置档案、主题、诊断、控制器支持以及面向模组开发者的公共 API。


[center]

[图片]

Accord Settings 主界面。
**[/center]


[center]**
[图片]
[/center]

共享模组设置浏览器,支持页面、分类、搜索、排序和收藏夹。
面向模组开发者的公共设置 API 和 SDK。
* 配置档案,支持保存、加载、复制、备份、导入和导出。
* 鼠标、键盘和控制器导航。
* 自定义主题、强调色、面板样式和界面尺寸预设。
* 事务性控制,包含应用、保存、取消和重置功能。
* 内置诊断,针对设置、UI、翻译、输入和性能。
* 可选的 GMCM 兼容性,适用于支持的注册。
* 框架及兼容模组的翻译支持。


[center]**
[图片]
[/center]

Accord Settings 支持广泛的配置控件:

开关
滑块
* 下拉菜单
* 数字输入框
* 文本输入框
* 按键绑定
* 颜色控件
* 颜色选择器
* 页面和分区
* 工具提示
* 动态选项状态

兼容的模组可以通过公共 API 注册其设置,而无需从头创建完全自定义的配置菜单。

[center]**
[图片]

在 Accord Settings 中显示的设置。
**[/center]


[center]**
[图片]
[/center]

界面可通过主题、强调色、面板样式、边框、可读性设置和协调的界面尺寸预设进行自定义。
预定义的布局预设会自动调整面板、图标、控件、边框和间距,以在不同屏幕分辨率下保持界面清晰。


[center]

[图片]

带有自定义控件和实时预览的深色主题。

[图片]

受星露谷物语启发的经典主题。
**[/center]



[center]**
[![图片](https://i.imgur.com/D4KnAbG.png)]
**[/center]

*配置档案允许玩家创建和管理完整的模组配置。*

* 创建多个档案。
* 保存当前设置。
* 加载现有档案。
* 复制档案。
* 为不同的存档使用单独的档案。
* 创建自动备份。
* 导入和导出配置。

[center]**
[![图片](https://staticdelivery.nexusmods.com/mods/1303/images/49382/49382-1784505681-1610383923.png)]

*配置档案管理。*
**[/center]


[center]**
[图片]
[/center]

Accord Settings 包含其自身的控制器导航系统,用于:

主选项卡
模组列表
* 配置页面
* 控件设置
* 对话框
* 屏幕键盘

控制器支持是框架界面的一部分,因此集成的模组无需实现单独的导航系统。


[center]**
[图片]
[/center]

Accord Settings 为星露谷物语模组开发者提供了一个公共 API 和 SDK。
该 API 可用于:

注册兼容的模组。
创建配置页面。
* 添加类别和分区。
* 注册标准设置控件。
* 访问主题信息。
* 使用配置档案。
* 显示自定义操作和诊断。
* 响应已保存或已更改的设置。

> 开发者文档和集成示例将在公开测试阶段不断扩充。


[center]**
[图片]
**[/center]

通用模组配置菜单 (GMCM) 是可选的。
当安装了 GMCM 时,支持的注册可以导入到 Accord Settings 浏览器中。复杂或不支持的自定义控件可以继续将原始的 GMCM 界面作为后备方案使用。
Accord Settings 不会替换或包含 GMCM。使用原生 Accord Settings API 的模组可以在没有 GMCM 的情况下工作。


[center]**
[图片]
[/center]

星露谷物语 1.6+
SMAPI 4.0+
* 通用模组配置菜单 — 可选


[center]**
[图片]
**[/center]

1. 安装 SMAPI。
2. 下载 Accord Settings。
3. 将 AccordSettings 文件夹解压到你的星露谷物语 Mods 目录中。
4. 通过 SMAPI 启动游戏。


[center]**
[图片]
**[/center]

* Accord Settings 会取代 GMCM 吗?
不会。GMCM 是可选的,仍可作为不支持或高度定制控件的后备方案。
*所有模组都会自动出现在 Accord Settings 中吗?
不会。模组必须支持 Accord Settings API 或使用兼容的导入注册。
*没有 GMCM 时,Accord Settings 能工作吗?
可以。使用原生 Accord Settings API 的模组不需要 GMCM。
*框架支持控制器吗?
支持。控制器导航直接内置于框架界面中。
*这是一个最终版本吗?
此版本是公开测试版。仍可能出现错误、视觉变化和 API 修改。


[center]**
[图片]
[/center]

版本 0.1.0 — 公开测试版

首个公开测试版发布。
* 共享模组设置浏览器。
* 公共设置 API。
* 配置档案。
* 主题和外观系统。
* 鼠标、键盘和控制器支持。
* 内置诊断。
* 可选的 GMCM 兼容性。


[center]

> 版本 0.1.0 — 公开测试版
>
> 欢迎提交兼容性报告、反馈、错误报告和建议。

[/center]