winkawaks.ini 手动配置详解

ini 文件在哪

WinKawaks/
├── winkawaks.ini      ← 主配置文件
├── cheats/
├── eeprom/
├── ini/               ← 某些运行时生成的子配置
├── saves/
└── recordings/

winkawaks.ini 在 WinKawaks 根目录，是一个标准的 Windows INI 格式文本文件（分节 + 键值对），可以用记事本或任何文本编辑器打开编辑。

典型结构

一个简化的 winkawaks.ini 示例：

[WinKawaks]
FullScreen=0
WindowSize=640
Videomode=1
SoundEnabled=1
DefaultROMPath=roms
DefaultSavePath=saves
Language=English

[KeyPlayer1]
Up=W
Down=S
Left=A
Right=D
Button1=J
Button2=K
Button3=L
Start=1
Coin=5

[KeyPlayer2]
Up=UP
Down=DOWN
Left=LEFT
Right=RIGHT
Button1=Num1
Button2=Num2
Button3=Num3
Start=2
Coin=6

常用参数说明

[WinKawaks] 主段

参数	默认值	含义
FullScreen	0	启动时是否自动全屏（1=是）
WindowSize	640	启动时窗口宽度（像素）
Videomode	1	视频模式（1=Hardware 硬件加速）
SoundEnabled	1	是否启用声音
DefaultROMPath	roms	默认 ROM 目录（可以改成绝对路径）
DefaultSavePath	saves	默认存档路径

[KeyPlayerN] 玩家按键

每个玩家独立一段，键名 Button1 到 Button6、方向 Up/Down/Left/Right、Start、Coin 等。键值是 Windows 虚拟键码对应的字符串（W/S/A/D/UP/DOWN 等）。

通常不需要手动编辑这里——直接在模拟器 Redefine Keys 窗口里改更直观。模拟器会在你保存按键时自动把新值写回这个 ini。

什么时候手动改 ini

场景一：强制窗口启动

比如你在全屏模式下黑屏，需要强制窗口化：

关闭模拟器
用记事本打开 winkawaks.ini
找到 [WinKawaks] 段里的 FullScreen= 行
如果值是 1 改成 0，没有就加一行 FullScreen=0
保存，重新启动模拟器 → 强制窗口模式

场景二：改变 ROM 目录

想把 ROM 目录移到 D:\roms 这样的独立位置：

把 roms/ 文件夹移动或复制到 D:\roms
编辑 ini 里的 DefaultROMPath=roms 改成 DefaultROMPath=D:\roms
重启模拟器后从新路径扫描 ROM

场景三：多套配置切换

不同游戏可能想要不同的窗口大小、滤镜组合、按键方案：

配置好一套设置后，从 Game 菜单 Save Current Configuration To Config File 保存为 kof.ini
玩另一款游戏时 Save 为 mslug.ini
下次切换时 Load Configuration From Config File 读回来即可

修改前先备份

手动编辑 ini 之前建议先复制一份（比如改成 winkawaks.ini.bak），改错了可以恢复。模拟器运行中不要编辑 ini——它会在退出时把内存里的配置写回，覆盖你的手动修改。