INI大师

INI大师
为《红色沙漠》中每个 ASI 插件提供设置窗口。用复选框、滑块、下拉菜单和按键框取代文本编辑器，并且在游戏运行期间也能生效。

简而言之

• INI Master 是一个独立程序。它不需要我的任何其他模组，其他模组也不需要它。
• 它会修改你已有模组的设置，无论是我做的还是别人做的。按各自页面说明的方式安装那些模组，用DMM或手动安装，INI Master都能找到它们。
• 从文件选项卡下载压缩包，解压到任意位置并运行INIMaster.exe。无需使用模组管理器，也不会向游戏中复制任何文件。
  

大多数ASI插件会把设置保存在bin64目录下与自身相邻的ini文件里。想改一项设置，就得先找到文件、读注释，还得祈祷你填的值是插件能接受的。INI Master会自动找到游戏，列出所有带ini文件的插件，并把每个文件变成一页控件，插件作者写的注释就直接当作帮助说明。

为了让模组拥有更好的页面，无论是不是你制作的，指南都在 为模组添加INI主控帮助.

你会得到什么

• 所有插件尽在一份清单。 INI Master 通过 Steam 库列表、Epic 清单或常见安装文件夹找到 Crimson Desert，然后列出 bin64 中的每个 .asi，以及其下 scripts 和 plugins 文件夹中与 ini 相邻的 .asi。如果未找到游戏，请按“Game folder”并选择 Crimson Desert 文件夹或 bin64。列表下方的“Show ini files without a plugin”复选框会添加诸如 OptiScaler.ini 之类的文件。
• 每项设置对应一个控件。 开/关值显示为复选框，带范围的数值显示为滑块，选项列表显示为下拉菜单，按键则显示为一个可按下按键的输入框。将鼠标悬停在该输入框上会列出它接受的所有按键，当模组以代码形式存储按键时还会显示对应代码。每个标签旁边是文件中所命名的按键，便于与指南对照。
• 模组作者编写的帮助内容。 每个键上方的注释将成为其描述。将鼠标悬停在某项设置上可查看完整内容，或点击该项将帮助固定到窗口底部，并显示类型、默认值及帮助来源。
• 游戏过程中发生变化。 开启“边编辑边保存”后，每次更改都会在你操作后片刻写入。会重新读取 ini 的插件能在游戏内立即生效。对于仅在启动时读取 ini 的插件，页面会注明这一点，并将相关设置标记为“下次启动”。
• 回去的路。 每个未保存的更改都会有一个圆点标记。其右侧的两个按钮可以撤销该更改，或者在模组声明了默认值时恢复默认值。会话中每个文件的首次保存会将旧文件复制到备份文件夹，而“更多”中的“打开此ini的备份”会直接跳转到那里。
• 想要原始文件时就选它。 “文件文本”选项卡以文本形式编辑整个 ini 文件。“纯文本值”会将每个控件替换为其原始值，适用于对设置类型的猜测有误时。
  

它不会动你的文件
保存时只会重写你更改过的值。注释、空行、键顺序、间距、行尾和编码都保持原样，因此文件的差异对比只会显示你的修改，不会包含其他内容。

无论文件是 UTF-8、UTF-16 还是原本使用的 Windows 代码页，任何文字系统中的文本都能正确读取和保存。如果某个值包含该代码页无法存储的字符，INI Master 会拒绝保存并指出该字符，绝不会用问号代替它写入。

如果插件在 INI Master 打开时重写了自己的 ini，页面会以新值重新加载，并保留你未保存的编辑内容。

为部分模组提供更好的帮助
注释能让模组完成大部分工作。想要精确类型、范围、标签和默认值的模组制作者可以描述它们，INI Master 会从几个位置读取该描述，后面的位置会覆盖前面的位置：

• 该ini文件自身的注释。
• ;@ ini 中的行。
• 插件旁边的 MyMod.inimeta 文件。
• 同一文件嵌入到 .asi 中，并在插件的资源脚本中加入一行。
  

一个嵌入了它的模组会在列表中显示“内嵌帮助”。 分配拾取者 还有dofo7777的 绯红之路 两者都是。附带多种语言帮助的模组会以 INI Master 正在使用的语言显示，这就是为什么其中一张截图里 Crimson Route 完全显示为中文。

正在设置一个没有帮助信息的模组
你不必是模组的作者，也能为它编写一个像样的页面。任何人都可以为任何模组撰写帮助文档，而且这些内容存放在独立的文件中，因此模组本身永远不会有任何改动。

• 选择该模组并点击“更多”，然后选择“导出元数据模板”。它会保存一个以 ini 文件命名的文件，例如 OptiScaler.ini 对应的 OptiScaler.inimeta，其中包含 INI Master 已从注释中读取的所有内容。
• 编辑它。 .inimeta 文件 指南中列出了每一个字段，从标签和类型到范围、选项、默认值和分组，以及 以多种语言提供帮助 涵盖翻译内容。
• 将文件放入 INIMaster.exe 旁边的 inimeta 文件夹中，然后按 F5 重新扫描。放在 bin64 中 ini 文件旁边也可以，且该位置的副本优先。
  

inimeta 文件夹随 INI Master 一起提供。将完成的文件作为拉取请求发送至 inimeta 在 GitHub 上，或者把它发到 Discord 上，后续版本就能把它带给所有人。

给模组制作者
完整格式见 元数据.md，它也在下载文件的docs文件夹中。它以 INI Master 从纯注释中读取的内容，因此在添加任何内容之前请先检查，因为排版良好的注释可能已经足够了。 将其嵌入插件中 这是你 .rc 文件中的一行，并且 游戏运行中重新加载 展示如何在不重启的情况下获取编辑内容，并告知玩家。

该 SDK文件夹 持有 敌人主控.h，附带一个用于在没有资源脚本的情况下嵌入文件的宏，以及一个用于在游戏运行时重新读取你的ini文件的小型监视器，此外 一个可用的示例插件 同时使用两者。在应用中，“更多”→“导出元数据模板”会根据INI Master已从你的注释中读取的内容生成一个初始的.inimeta文件，因此你可以从自己的文本开始。

语言
英语、德语、法语，以及简体中文和繁体中文。当 Windows 设置为其中一种语言时，INI Master 会以该语言启动，其他语言则统一使用英语。此外，在“语言”选项中选择另一种语言会立即切换窗口语言。

翻译是一个纯文本文件，左边是英文，右边是你的语言。此外，Translate INI Master 会打开该文件夹并在其中放入一个全新的模板，并且 TRANSLATING.md 解释了其余部分。

安装

• 从“文件”选项卡下载INIMaster-1.2.8.zip，或从 GitHub 发布，并将其解压到任意位置，例如 Documents\INI Master。
• 运行 INIMaster.exe。
  

这是一个独立的可执行文件，适用于64位Windows 10或11系统。无需安装.NET，以普通用户身份运行即可，不会请求管理员权限。

通过Definitive Mod Manager安装的插件会像其他插件一样显示。DMM会在其mods文件夹中保留自己的副本，并将插件及其ini文件复制到bin64中，而bin64中的ini文件正是插件读取以及INI Master编辑的那个文件。DMM不会改动你在那里的编辑。已使用DMM 3.2.0测试，经过挂载Mods以及插件被关闭再重新开启后，编辑过的ini文件保持不变。

更新
启动时，INI Master 会向 GitHub 查询是否有更新的版本，并在下载任何内容之前先询问你。选择否，它就不会再就该版本进行提示。此外，“检查更新”可随时再次查询，同一菜单也可关闭启动时的检查。除非新版本携带与你当前运行副本相同的签名证书，否则不会安装任何内容。

正在卸载 正在删除你解压到的文件夹。它的设置、备份和你自己的翻译都存放在 %LOCALAPPDATA%\INIMaster，所以如果你想彻底清除，也要删除那个文件夹。移除它时不会更改任何模组文件。

兼容性

• 任何游戏版本均可。INI Master仅读写文本文件，从不接触游戏本体或其内存，因此游戏补丁不会影响其正常运行。
• 任何带有ini文件的ASI插件，无论出自谁手。即使ini文件中没有注释，也会为其创建页面，只是标签更为简洁。
• 与游戏同时运行或在游戏关闭时运行。顶部栏会显示游戏是否正在运行。
  

已知限制

• 仅凭注释来看，设置的类型只是一种猜测。用文字描述的数字，可能更适合滑块却显示为文本框，也可能相反。遇到这种情况时，“纯文本值”会显示原始值，而模组制作者提供的元数据则能彻底修正这一问题。
• 插件是否会在游戏运行期间重新读取其ini文件，只有插件自己知道。INI Master可以在模组元数据注明时告知你，或者当其注释中写着“picked up while the game runs”之类的内容时告知你。对于其他任何模组，页面会显示无法判断。
• 它会查看 bin64 及其 scripts 和 plugins 文件夹，这些位置 终极ASI加载器 默认从加载。放在其他任何位置的插件都不会显示。
  

如果出了什么问题
在“漏洞”选项卡上发布，或 在GitHub上提交问题 使用你正在编辑的模组时，你改了什么以及发生了什么。如果存档出了问题，%LOCALAPPDATA%\INIMaster\backups 里的文件就是 INI Master 改动之前的版本，把该文件和当前的 ini 一起附上，就能准确看出改动了什么。

文件
1.2.8 的 SHA-256：

4011b9eca55eb3f14b7e39251bccacb5b303a0845e48601f1f358f436397237e INIMaster-1.2.8.zip
eb7e09e5304d978f264b4d73f98025cb22fefb533b1c97d22938c49c4d3c8f58 INIMaster.exe

它们与 GitHub 发布版本中的文件一致。

VirusTotal对其扫描过的两个版本均未标记任何威胁。1.2.8版本的INIMaster.exe在68个引擎中0个报毒，zip压缩包在66个引擎中0个报毒；1.2.6版本则在70个引擎中0个报毒，64个引擎中0个报毒。报告如下： 该可执行文件 和 拉链.

INIMaster.exe 已进行代码签名，在“属性”的“数字签名”中显示为 Seth Walker。它仅因一件事联网：向 api.github.com 检查更新，以及在你确认后从 GitHub 下载更新。它读取注册表仅用于查找 Steam。它会写入你编辑的 ini 文件及其备份，以及自身在 %LOCALAPPDATA%\INIMaster 中的设置。

来源与许可
MIT 许可。源代码和构建说明见 GitHub： github.com/shin2344234/ini-master

Discord 和 Patreon
Shin234的模组与杂项 是Discord，用于提问和查看正在进行的内容。Bug最好发布在Bug标签页或作为GitHub问题提交，以便得到跟踪。
Patreon 是 patreon.com/cw/Shin234 在以下位置有帖子 patreon.com/cw/Shin234/posts所有发布的内容都保持免费，不会为此有所保留。