玩星露谷装了一堆模组，结果发现某些功能的按键和游戏操作冲突了？或者想把模组的快捷键改成自己顺手的位置？这篇帖子帮你彻底搞懂星露谷模组的按键绑定系统——从配置方法到所有可用键值，一篇文章全搞定。

配置模组的按键绑定

配置按键绑定一共四步，非常简单：

1. 安装模组：先把模组装好，确保放在游戏目录的 Mods 文件夹内。
2. 至少运行一次游戏：通过 SMAPI 启动游戏并加载一次该模组，让它自动生成配置文件 config.json。
3. 找到配置文件：在对应模组的文件夹内找到 config.json，用任意文本编辑器（记事本、VS Code 都行）打开。
4. 修改按键值：找到你想要修改的按键选项，把值改成下方按键表中列出的代码。

禁用模组的按键绑定

如果你不想使用某个模组的某个快捷键，直接把对应的按键值设为 None 即可禁用该绑定。例如：

{
  "SummonTractor": "None"
}

这样该功能的快捷键就被完全取消了。

找到按键的代码

下方的按键表列出了所有可用的键值，但不同键盘布局可能导致某些键的名称不确定。SMAPI 提供了一个内置命令帮你实时查询：

1. 运行游戏。
2. 在 SMAPI 控制台窗口（不是游戏内，是那个黑色命令行窗口）中输入 test_input 命令。
3. 在游戏中按下你想要测试的按键。
4. SMAPI 窗口会立刻显示你所按的键对应的代码值。

这个方法最准确，尤其是对于非标准键盘或笔记本键盘上一些特殊按键。

预留绑定

多人联机模式中，聊天框绑定的按键（默认为 T 键）是预留的，不能被模组覆盖。如果你的模组快捷键设成了 T，在联机时可能会被聊天框拦截。

Android 上的按键绑定

Android 版本的 SMAPI 支持物理按键绑定，但可用按键非常少（只有音量升/降键）。解决方案是使用 虚拟键盘模组：

1. 游戏左上角会出现一个键盘图标。
2. 点击图标显示已配置的按钮。
3. 点击按钮触发对应操作。

要添加新的虚拟按键：

1. 先运行一次游戏生成默认的 config.json。
2. 打开 Mods/VirtualKeyboard/config.json。
3. 在 buttons 区域按相同格式添加新按键。添加时，将新按键的 X 值设置为前一个按键的 X 值 + 96。

所有可用按键值

键盘按键

通用按键

数字小键盘

控制键

特殊键（展开查看）

控制器按键

鼠标按键

移动端按键

实际配置示例

以 Tractor Mod 为例，它的默认召唤键是 Backspace，如果你想改成 T 以外的键（比如 F5），打开 TractorMod/config.json，找到 Controls 部分：

{
  "Controls": {
    "SummonTractor": "F5",
    "DismissTractor": "F5",
    "HoldToActivate": "None",
    "IncreaseDistance": "PageUp",
    "ReduceDistance": "PageDown"
  }
}

修改保存后，重载存档即可生效。设为 "None" 表示禁用该按键。

对于模组创建者

这些按键常量来自 SMAPI 的 SButton 统一枚举，是 SMAPI 输入系统的一部分。它统一了控制器、键盘和鼠标按键的表示方式，所有遵循 SMAPI 标准 API 的模组都可以直接使用这些键值来实现按键绑定功能。

本文标签：#按键绑定 #星露谷物语 #StardewValley #SMAPI #模组配置 #config.json #新手教程 #键位设置