写法与生效规则#

1
[配置节]
2
参数名=参数值
3
; 分号开头是注释

• 开关写 0 / 1；键盘绑定写 Windows Virtual-Key Code。
• 普通 INI 路径使用单个反斜杠，如 DEVICE\aime.txt。
• 修改已有配置节和键，不要为每次修改重复添加同名节。
• 默认读取工作目录的 segatools.ini；设置 SEGATOOLS_CONFIG_PATH 后以该文件为准。
• 修改后退出游戏及相关 amdaemon，再通过启动脚本重启。
• 下文“模板值”是随附 INI 的显式值；“缺省值”是省略键时的源码回退值，两者可能不同。
• [aimeio] / [mai2io] 选择外部 DLL 后，内置卡号、键盘映射参数是否仍生效取决于该 DLL。

[vfs]：游戏数据路径#

VFS 默认启用，amfs 和 appdata 不允许为空。

option= 留空在 Hook 中只产生警告；游戏版本本身仍可能依赖更新数据。

此处绝对路径相对路径皆可。

[aime]：读卡器模拟和虚拟卡#

内置实现省略 aimeGen 时为 1，有效卡文件不存在时可在刷卡时生成 20 位数字卡号；DEVICE 应存在且可写。已有卡号文件应备份。

可选补充：

1
[aime]
2
aimeGen=1
3
felicaPath=DEVICE\felica.txt
4
felicaGen=0

这是添加到已有 [aime] 节的字段。FeliCa 文件为 16 个十六进制字符；其自动生成默认关闭。读取顺序为已有 Aime → 已有 FeliCa → 按开关生成卡号。

如果你采用的版本是 SDGB ，那么 aime 配置 enable 设置为 0 即可，别问我为什么，你要是能通过 aime 卡登录上 SDGB 请速速联系我，我 v 你个舞神（

[vfd]：机台文字显示屏#

enable=1 模拟 VFD GP1232A02A FUTABA 设备；0 关闭。它是机台文字显示设备，不是游戏主显示器。maimai 的 Hook 默认把 VFD 放在 COM2。

[dns]：网络服务目标#

default=127.0.0.1 是模板值，不能直接视作可用配置。

写服务端的实际主机名或 IP，例如 default=192.168.1.100；服务端在本机时也应使用可访问的局域网地址。该项只重定向网络服务目标，不会启动或实现服务端。

如果你要使用 WAHLAP PowerOn（华立开机认证），请将 default 设置为 ai.sys-allnet.cn 。

[netenv] 与 [keychip]：网络模拟和机台身份#

模板说明：禁用 netenv 后，subnet 应匹配真实局域网，并使用游戏要求的 192.168.* 网段。

省略 [netenv] enable 时源码为 0；省略 [keychip] subnet 时为 192.168.100.0。因此不要随意删除模板字段。

keychip.id 是模拟加密狗的序列号，用来向游戏提供机台身份。 俗称狗号，如果你要连接官服，此字段是必须的，由于机台身份码为商业机密，此处我不能给出可以使用的具体值，如有需求请自行寻找。

1
[keychip]
2
id=A69E-01A88888888
3
region=8

[pcbid]：主板 MAIN ID#

serialNo=ACAE01A99999999 是游戏所见的主板编号。要求 15 个字符，错误长度会使初始化失败；按模板格式不带连字符。

此配置在非必要情况下建议不启用。

[system]：ALLS 系统配置#

这些设置作用于 AMFS 下已有的 sysfile.dat。首启尚未生成文件时可能不生效，需要正常生成有效文件后重启；源码要求其大小为 0x6000。启用后会在启动时重新应用 INI 设置。

dipsw1 的 Server 是店内游戏分发角色，外部认证/存档服务仍需另行提供。

[led15070]：机台灯板#

enable=1 模拟 837-15070-04 灯板，控制机台及按钮灯的协议交互；0 关闭。maimai 默认使用 COM21 / COM23 两块灯板。

启用模拟不代表键盘 RGB 或外接灯带会自动亮。真实灯光输出需要合适的 IO DLL 或硬件适配。

如果你的手台带灯光，请咨询你的供应商。

[unity]：Unity / Mono 集成#

例如 targetAssembly=\Mods\Loader.dll（仅做示例），该文件必须实际存在并兼容此加载方式。当前源码描述是先查找 Doorstop.Entrypoint:Start，再回退 *:Main。

注意：targetAssembly 如果没有确定的配置项，将此字段留空，不要填写右值。

[aimeio] / [mai2io]：外部 IO 驱动#

两节均只有 path=：

应使用匹配的 x64 DLL 和受支持的游戏 IO API。

路径选择顺序：

1. 对应 INI 的非空 path。
2. SEGATOOLS_AIMEIO_PATH 或 SEGATOOLS_MAI2IO_PATH。
3. SEGATOOLS_IO_ROOT 下的 aimeio.dll 或 mai2io.dll。
4. 内置实现。

因此 path= 不一定等于内置 IO，还要检查环境变量。根目录推导的文件不存在会回退内置 IO；显式填写错误路径则会尝试加载并可能失败。

这些 IO 路径支持 Windows 环境变量展开，例如 path=%SEGATOOLS_IO_ROOT%\mai2io.dll。不要据此推断所有 INI 路径字段都支持环境变量展开。

同样需要注意的是：这两条配置项在你没有对应内容时，建议置空。

[io4]：维护与投币键#

还支持：

1
[io4]
2
enable=1
3
foreground=1

此处代码块内容在官方模板上未列出，由我阅读源码发现支持的字段，不保证绝对可用性，但由我测试未得出负面影响。

enable 控制 IO4 板模拟；foreground=1 仅在识别到游戏窗口处于前台时轮询 IO4 输入，源码缺省也是 1。这些是加入已有节的字段。

游戏窗口未获得焦点时，优先检查焦点；foreground=0 才允许后台轮询。此项不等于对所有独立输入线程统一限制。

[button]：外围按钮与选择键#

enable=1 启用内置 IO 的两组环键和选择键；0 跳过这部分轮询。测试、服务和投币在该判断前处理，不会被此开关一并关闭；触摸也是单独的通道。

有独立的游戏 DebugInput 或其他输入来源时，可按实际接法关闭，避免同一按键重复进入游戏；该开关本身不会开启游戏 DebugInput。

参数范围为 p1Btn1..p1Btn9、p2Btn1..p2Btn9。1–8 为环键，按模板顺时针顺序排列；9 为选择键。省略的键使用下表默认值：

[touch]：触摸板模拟和触摸区域键位#

区域名只能使用当前 sensor_map 中的 A1–A8、B1–B8、C1–C2、D1–D8、E1–E8，每位玩家共 34 个区域。

写法例如：

1
[touch]
2
p1Enable=1
3
p2Enable=1
4
p1DebugInput=1
5
p2DebugInput=0
6
p1TouchA1=0x54
7
p1TouchC1=0x47
8
p1TouchC2=0x47

此例启用两块触摸板模拟，但只把 1P 键盘映射为触摸；T 对应 A1，G 同时对应两个中心触点，其他未写的映射仍用源码默认值。

默认触摸键位如下，只有该侧 DebugInput 开启时才采集：

这意味着默认按 T 会同时触发 1P 的 A1/B1/D1/E1，而不是只触发 A1。要独立控制区域，须逐项覆盖相关绑定。

注意：此处的配置不建议更改模板内容，如果你采用的是手台方案，会通过 COM 口进行读取，而不应当更改此处内容。

轮椅配置#

在绝大多数情况下，mai2.ini​ 中配置的内容都是游戏本体自带的。我们现在在这里需要配置的是让游戏忽略错误并且以开发模式运行。同时这里还可以开启歌曲全解和自定义一 PC 的歌曲数量。

1
[AM]
2
Target = 0
3
DummyLED = 1
4
DummyChime = 1
5
DummyTouchPanel = 1
6
IgnoreError = 1
7
DummyCodeCamera=1
8
DummyPhotoCamera=1
9
QrCameraId=0
10

11
[Sound]
12
Sound8Ch=0
13

14
[Debug]
15
AllOpen=0
16
AllMap=0
17
AllCollection=0
18
AllChara=0
19
MaxTrack=3
20
Debug=1
21

22
[DebugVersion]
23
DebugMajorVersion=1
24
DebugMinorVersion=45
25
DebugReleaseVersion=00

其中 Target 是游戏是否以生产环境运行的开关。它控制比如说开了之后游戏会把 ErrorLog 之类的文件夹放在 Y: 盘里，但是关了之后这些文件就会被放在当前目录下。

Dummy 开头的那些就是假如你没有对应的硬件就开启，会加载虚拟的。

AllOpen 是开启歌曲全解。

DebugVersion 可以设置游戏认为自己是的版本号。

以上是经过他人验证的可稳定使用的配置。
如果你不满足于这种轮椅般的稳定配置，那么接下来的内容————要开始加速了哦！

超速配置#

阅前提示：此段内容除去与上方轮椅配置相同的部分，剩余部分为我阅读 MaiMai DX 源码后得出的可能能够使用的配置。
由于内容太过繁多，我无法一一进行测试，故我也不保证可用性，使用时请自行测试。
毕竟是“超速”配置，所以出点意外也是很正常的对吧（
只因为可能出错就不配置超速配置？这是弱者的思维！所以如果你使用某项配置发现能够正常使用，请联系我进行更新以上内容。

吐槽：艹拟冯，傻福日本人写的什么构式代码？建议所有人去品鉴一下源码（

配置要开始加速了哦