AML使用教程

本页面的内容是关于AML(Acaly Mod Loader）的介绍和其使用教程。

什么是AML

AML，全称为Acaly's Another Mod Loader，是一个使用C#开发的GS游戏Mod加载器，用于加载特殊格式的Mod。

AML是Grief Syndrome这个游戏中第二次注入式Mod Loader的尝试。第一次是使用C++开发的NML（Natsu's New Mod Loader）。

相比传统的gs03.dat形式的Mod，AML可以实现的功能多了很多，甚至可以和连机器的功能进行互动。

对一般玩家而言，AML常用的功能包括：

• 多个Mod的同时加载。
• 改进的Replay的录制压缩和可调速回放功能。
• 游戏加载速度的优化。
• 连机器汉化和稳定性优化。
• AML自身有独占的新角色Mod——帕秋莉Mod，详情请参照帕秋莉。

目前的最新版本为1.1版本。

安装方法

下载文件解压后，直接把aml文件夹和Launcher.exe放到游戏所在的文件夹中即可。

AML启动器界面说明

预设管理页面

注意:示例图中的帕秋莉/小町不属于默认安装预设

AML启动器目前增加了“预设”功能。

• 目前的Mod只有前两页有用。第三页开始是各Mod的详细设置页面。
• 目前只有选人界面Mod提供了详细设置。但是选人界面的详细设置的功能都可以从第一页选择“狗狗”、“草草”等预设的方式指定。

以下是部分预设具体对应的功能：

• (默认)：包括一部分AML推荐的功能（加载优化）。
• 重选：允许选择相同角色。
• 狗狗：开放所有关卡。
• 狗狗重选：同时启用狗狗和重选功能。
• 草草：类似gs03版草草，包括了停版选择，角色重选，修改等级的功能。
• 其他预设：如果安装了其他Mod（如图书Mod），这里可能会显示更多内容，用来启用相关的功能。

一些设置方式和效果如下：

• 默认：原生态。
• 默认+帕秋莉：帕秋莉（图书）Mod，一级蔷薇开始。
• 默认+草草：基本等同原草草Mod（除显血功能外）。
• 默认+草草+帕秋莉：帕秋莉带草草。
• 默认+草草+（在插件列表中）小怪血条：原草草Mod（除显血功能外）+新血条Mod。

组件列表页面

注意:示例图中的帕秋莉/小町不属于默认安装组件

这个页面初始会列出(默认)预设中包括的组件。可以在这个页面增加新的组件，会和“预设管理”中启用的功能合并。

• 小怪血条：左上角显示每个种类的小怪的当前剩余血量大致比例。
• 加载优化：默认启用，加快关卡加载速度。
• 选关界面：用来控制狗狗、草草等选项，不建议手动启动，请使用第一页的预设。

快捷方式

AML启动器目前增加了“快捷方式”功能。在启动选项窗口中选择“创建快捷方式...”可以将当前所选的启动选项保存到快捷方式。

• 快捷方式保存位置为游戏所在文件夹。
• 快捷方式目前有三种模式：单机模式（直接启动游戏），联机模式（直接启动联机器）和启动器模式（启动AML启动器，可以再进行修改）。

AML内置功能

新选人界面

如果在AML中选择了草草、狗狗、图书等依赖于选人界面的功能，AML会覆盖掉GS原选人界面，并使用新的选人界面。

进入选人界面后，三个框框分别对应1P 2P 3P，可使用上下方向键切换角色，使用左右方向键切换形态和其他功能。

• 默认状态下左右切换形态（如果没有其他形态则不能切换）。按A可以选择其他功能（见下）来切换。如果没有其他功能则按A无效。
• 形态是指黑的黑长直和麻花，以及图书的单、双、五属性。
• 其他功能包括草草中的等级、图书的属性、图书的日符/月符等。

举例：1P在带草草Mod的情况下选择1级麻花：

• 按两下上，切换到晓美焰。
• 按一下左（或右）切换到麻花形态。
• 按一下A，从切换形态调整到草草的切换等级。这时等级数字会开始闪烁。
• 按住左，调低等级到1。
• 按Z确认进入游戏。

反作弊模式

目前的AML添加了新的反作弊模式，联机和播放rep时必须使用完全相同的gs03 Mod，否则可能会发生不同步。

如果加载了AML的Mod（包括AML中的图书、草草等），则此功能默认开启。

如果没有加载AML Mod则此功能默认不开启，因此增加此功能对已经存在的rep不会造成影响。

如果希望关闭反作弊模式（通常用于播放旧rep，或已经发现此模式有严重bug影响录制rep等情况），可以修改aml/config/Core.ini中的CompatibleMode=1。请注意开启和关闭情况下录制的rep互相不同步。

GS03加载

AML1.1版本可以代理加载gs03格式的Mod。

功能启用

这一功能是由单独的AML Mod（GS03加载）负责的。这一Mod没有对应的预设，因此默认情况下不会启用。

要启用这一功能，最简单的方法是在“组件列表”选项卡中勾选“GS03加载”，然后在“GS03加载”选项卡中勾选需要的Mod。

启用这一功能的一个更为自动化的方式是手动编写预设，可以用预设来加载特定的gs03格式Mod。请参考大图书馆群2020冬季活动中使用的预设文件或询问AML作者，这里不作进一步说明。

Mod识别（针对普通玩家）

gs03加载时只会扫描aml/config/GS03Loader.ini中SearchPath指定的路径（相对于游戏本体的相对路径）。随AML发布的配置文件中使用的是gs03mods文件夹。

gs03文件的识别只和文件内容有关，和文件名无关，因此下载mod后只要放在指定路径下即可，可以随意命名。

gs03文件的识别使用外置（手动）和内置（自动）两种信息。支持自动识别的Mod会自动被AML识别，不支持的Mod需要在aml/config/GS03LoaderMods.txt文件中保存相关信息。

随AML发布的aml/config/GS03LoaderMods.txt文件保存了常见Mod的信息用于Mod的识别。如果需要添加其他Mod的信息请询问AML作者。

Mod识别（针对Mod开发者）

内置信息依靠gs03 Mod资源包中amlmetadata.txt文件。格式为JSON：{ "Name": "testmod", "DisplayName": "测试Mod" }。

外置信息的具体含义为：

• Name: 启动器识别代码，不能包含特殊符号（半角空格、句号、逗号、分号），应当保证唯一性。这个唯一性包括了同名Mod的不同版本。可以参考已有Mod的格式。
• DisplayName: 启动器窗口显示名称。
• Crc32: 标准CRC32代码，32位无符号整数以10进制显示。
• Size: 文件大小。
• LastWord: 文件最后4字节的数据，小端序转换为32位无符号整数，以10进制显示。
• CheckBytePosition: 可选。CRC32和最后4字节以外的额外检查位置。指定为0则忽略这项检查。
• CheckByteValue: 可选。CheckBytePosition位置开始的4字节数据，小端序转换为32位无符号整数，以10进制显示。
• 为了增强兼容性和发布的便捷性，新制作的gs03 Mod如果希望被AML的gs03加载功能所识别，应当使用内置信息的方式，而不是单独发布外置信息。

随AML发布的gs03mods文件夹中自带了几个最基本的Mod作为示例。后续会单独发布一个AML支持的Mod的整合包。

个别情况下，如果Mod文件被删除或改名（包括将游戏文件夹整体移动），识别可能会出现问题，请手动删除aml/cache/GS03LoaderModsCache.txt文件来重新识别。

连机参数匹配（见下）会匹配GS03加载功能所使用的列表（支持同步和检测）。在同步模式下如果主机端使用了客户端不存在的gs03 Mod，则会在游戏启动时提示。

Replay录制

AML1.1版本中replay录制功能已经从独立的插件合并入AML本体。

1.1版本的AML不会加载旧版本的replay录制插件，因此保留旧的录制插件不会影响功能，但是仍然建议手动删除旧的ReplayRecorder.dll。

AML1.1版本录制的replay文件扩展名为repx，是对原rep文件格式保留了一定程度兼容性的扩展格式。其区别主要在于增加了对压缩和自定义信息的支持。

关于压缩

相同游戏时间下，尤其是游戏时间较长的情况下，开启了压缩的repx文件的大小会远远小于无压缩的rep/repx文件。开启了压缩模式的repx文件在没有使用AML启动的gso中无法识别（会识别成空rep）。

repx文件的压缩模式默认情况下只在加载了AML的Mod情况下启用（类似反作弊模式），但是可以在Core.ini中进行修改（Compression=always/compatible/never）。

这里尊重用户的选择，压缩选项默认为compatible模式（仅在有AML Mod情况下启用），但是强烈建议经常联机的玩家修改为always模式。

压缩格式的repx需要用AML启动的gso来播放。也可以用单独的工具转换为普通的rep文件，但这个工具暂时不随AML1.1发布，如有需要可以联系作者acaly。

关于自定义信息

目前repx文件不会添加任何自定义信息，但是未来版本的AML或AML插件可能会增加相关的功能（如Mod列表、玩家id等）。

提示

在任何情况下你都可以在gso.ini中开启或关闭gso本身的replay录制功能。

• 若关闭则表示仅依赖AML的replay（当然，不用AML的情况下会没有replay），配合always压缩模式可以大幅度降低replay的硬盘占用空间。
• 若开启作则可以作为AML录制的补充和双重保险。
• 关于gso.ini中的replay录制功能选项这里不做详细介绍。

内置的Replay回放加速

原本的游戏加速器Mod被合并入AML本体，并在播放replay时自动启用。

由于游戏加速器基本仅用于播放replay，新版的AML不再单独提供游戏加速器Mod，但是旧版的游戏加速器仍然能够被新版的AML启动。如果希望加速游戏仍然可以使用这种方式。

原本的游戏加速器提供的标题栏fps显示功能可以在Core.ini中修改ShowFps=1来启用。

连机问候语

作为单独的AML Mod提供支持，在连机器连接成功后向其他人发送问候信息（自报家门）。默认启用。

• 问候的内容在aml/user/User.ini文件中Greeting一行中指定。留空则禁用。

连机器汉化

连机器的界面文字翻译为中文，并更换为中文字体。

• 游戏内文字更换为中文字体。

由于是默认启用的插件，如果不希望使用，可以手动删掉对应的文件（TranslateGSO.dll）。

Mod列表匹配

AML1.1版本增加了Mod列表自动匹配功能。

• 这里的Mod列表指的是AML的Mod而非gs03的Mod，但在启用了GS03加载功能的情况下，GS03加载列表也会被匹配。手动修改gs03.dat文件加载的mod不受AML控制，因此不能被匹配。

Mod列表匹配有三个模式：同步模式(sync)、检测模式(check)、禁用(disabled)。在Core.ini中进行修改（ModCheckMode）。

• 三种模式只影响客户端（客机）的行为。
• 同步模式下的客户端会向服务器端（主机）询问Mod列表，并更新自己的启动参数来匹配服务器端。
• 检测模式下的客户端会向服务器端询问Mod列表，但是不会更新自己的启动参数，而是在连接窗口中显示Mod是否匹配。
• 禁用模式下客户端不会询问Mod列表。
• 默认模式为检测(check)模式，但是强烈建议经常连机的玩家修改为同步(sync)模式。

这一功能与gso以及旧版AML是兼容的。

Mod列表匹配只匹配功能性Mod（加载优化等Mod不在匹配范围内）。

增强的网络同步检查

AML1.1版本对gso的网络同步数据包进行了改进，增加了一个完整性检查，应该能够进一步降低网络问题导致的不同步概率。

这一功能与gso以及旧版AML兼容。在有一方使用非AML启动的gso或旧版AML的情况下不会进行这个检查。