保存作用域配置

创作者: WheresWolfgang

已更新:2026-06-04 12:32:43

12KB

下载

前置 MOD

使用保存作用域配置时将自动安装

BepInEx 5配置管理器

651KB

关于此 MOD

为需要根据当前加载存档来应用配置设置的Silksong模组提供的API插件。

保存范围配置是一款适用于《空洞骑士：丝之歌》模组的小型BepInEx辅助/API插件。

大多数 BepInEx 配置项为全局设置，即一项配置适用于所有存档。而“存档范围配置”则允许模组定义按存档位独立存储的设定。当你加载存档1时，配置管理器显示存档1的设置；加载存档2时，则自动切换为存档2的设置。

这主要是其他模组所依赖的前置组件。除非某个模组明确要求安装，否则通常无需在此进行任何配置。请查阅需求说明，了解使用此API的模组列表。

它的作用

为每个存档位单独存储配置值。
检测到存档变动。
当活动存档更改时更新配置管理器。
未加载存档时隐藏对应的存档设置。
允许模组同时保留全局设置与存档专属设置。

安装

安装 BepInEx 5 含配置管理器.
将zip文件解压到Silksong目录中。

你最终应该得到：

[Steam安装目录]\steamapps\common\空洞骑士：丝之歌\BepInEx\plugins\SaveScopedConfig.dll

给玩家
该模组本身不添加任何游戏玩法功能。它是一个供其他模组使用的API/依赖项，用于保存特定存档的设置参数。
若其他模组将“保存作用域配置”列为前置需求，请优先安装本模组，或与本模组同时安装。

模组作者须知
添加依赖项：

[BepInDependency(SaveScopedConfigPlugin.PluginGuid)]

导入API：

使用 WheresWolfgang.SaveScopedConfig；

基本用法：

private SaveScopedConfigFile saveConfig;
private SaveScopedConfigEntry<bool> enabled;

private void Awake()
{
    saveConfig = SaveScopedConfig.For(this);
    已启用 = saveConfig.Bind("通用", "已启用", true, "为此存档启用此模组。");
}

private void OnDestroy()
{
    saveConfig.Dispose();
}