
MLD的按键绑定
一张游戏内表格,列出星露谷物语所有按键绑定,包括原版和模组,支持重新绑定、冲突高亮和逐行重置。按F9即可打开,无需翻找选项菜单和每个模组自己的配置页面。
查看大图功能
一张表管理所有按键
原版部分涵盖操作、使用工具、菜单、日志、地图、移动、聊天、表情、奔跑、切换工具栏以及全部十二个物品栏槽位,外加取消。模组部分则纳入所有已安装模组通过 Generic Mod Config Menu 注册的按键绑定——无需逐个模组打补丁,也无需手动维护兼容列表。

就地重新绑定
点击按键单元格,然后按下你想要的新按键。原版绑定会写入游戏自身的设置;模组绑定会交还给拥有它的模组,因此每个绑定都通过其正常的配置路径保存。

修饰键组合
对于支持按键组合的模组选项,按住 Ctrl、Shift 或 Alt 再按下最终按键,即可绑定诸如 LeftCtrl + K 这样的组合。已有的组合会按原样显示,因此你可以看到完整的绑定,而不仅仅是最后一个按键。
在你确认之前不会写入任何内容
所有更改都会先暂存:待处理的行会被标记,底部的状态栏会统计它们,撤销会移除最后一个更改,放弃则会丢弃全部更改。只有应用才会真正写入游戏和你的模组。

冲突检测
任何被绑定到多个操作的按键都会被高亮显示,因此冲突在你战斗中撞上它之前就能看见。冲突只会被报告,而不会被阻止——游戏本身允许重复绑定。

实时搜索
输入即可按按键、操作名称、模组名称或模组 ID 进行筛选。在表格任意位置开始输入,搜索框就会接管;Esc 会取消焦点并保留筛选条件。

重置单个绑定,或全部重置
每一行都有自己的重置按钮,而全部重置会在确认对话框后将所有绑定暂存回默认值。对于模组绑定,按键图鉴会通过一个临时的配置类副本计算出每个模组的默认值,因此重置一个按键不会抹掉该模组的其他设置。
标题界面和游戏内
有些模组只允许在标题界面编辑其配置。该表格在标题界面也能打开,而当某个绑定在游戏内被锁定时,该行会变灰,并通过工具提示告诉你应该去哪里修改。
只读行会说明原因
鼠标按键、原版次要按键和固定绑定无法更改,但将鼠标悬停在它们上面会明确告诉你原因,而不是默默无反应。
本地化
包含英语和简体中文;表格会跟随游戏的语言设置。
前置要求
- Stardew Valley 1.6 或更高版本
- SMAPI 4.0 或更高版本
- Generic Mod Config Menu - 可选但推荐。没有它时,表格仍会列出所有原版绑定,但模组绑定来自 GMCM 的注册表,因此不使用 GMCM 的模组将不会出现。
安装
- 安装 SMAPI。
- 将此压缩包解压到你的 Stardew Valley/Mods 文件夹,使最终路径为 Mods/MLD's Keybind/manifest.json。
- 可选:安装 Generic Mod Config Menu 以支持模组按键绑定。
- 通过 SMAPI 启动游戏。
卸载时,删除 Mods/MLD's Keybind 即可。你的按键绑定会保持你离开时的状态,因为它们存在于游戏的设置和每个模组自身的配置中。
使用方法
- F9 打开和关闭表格。
- 点击按键单元格,然后按下新按键。Esc 取消捕获。
- 在最终按键前按住 Ctrl、Shift 或 Alt 来绑定组合键(仅限支持组合键的模组选项)。
- 按应用保存暂存的更改,按撤销丢弃最后一个更改,按放弃丢弃全部更改。
- 使用搜索框,或直接开始输入,以缩小列表范围。
- 点击某一行的重置以恢复该单个绑定;全部重置会在确认后恢复所有绑定。
- Esc 关闭表格——它会依次取消按键捕获、搜索框和重置确认。
配置
在 Generic Mod Config Menu 的“MLD's Keybind”下,或在 Mods/MLD's Keybind/config.json 中,只有一个设置:
- 打开按键 - 打开表格的按键。默认:F9。
表格本身无需配置:每次打开时,它都会根据游戏的设置和 GMCM 的注册表重新构建。
模组按键绑定的读取方式
按键图鉴会向 SMAPI 请求 Generic Mod Config Menu API,遍历 GMCM 已注册的配置菜单,并挑选出值为按键(单个按钮或按键组合列表)的选项。读取和写入这些选项会经过 GMCM 使用的相同对象,每次写入都会触发所属模组自身的保存回调——这就是为什么更改能在重启后保留,并出现在该模组的配置文件中。
默认值的学习过程不会触碰你的实时设置:会创建一个模组配置类的临时实例,读取其值,然后立即放回真实的配置对象。如果某个模组将其配置存放在不寻常的位置,且无法安全读取默认值,按键图鉴会退回到该模组自身的重置例程,仅针对你询问的单个按键,然后将其他所有选项恢复为之前的值。
兼容性
- 仅客户端。可以安全地添加到现有存档,并可在多人游戏中使用。
- 没有 Harmony 补丁,没有覆盖游戏代码,没有新增资源。
- 适用于任何通过 GMCM 注册按键绑定的模组,包括配置仅在标题界面可编辑的模组。
- 独立于 UI 模组——表格自行绘制,不依赖 Content Patcher、SpaceCore 或类似框架。
已知限制
- 从未向 GMCM 注册其按键绑定的模组无法被列出。如果某个模组未出现在表格中,几乎总是这个原因。
- 鼠标按键和原版次要按键会显示,但无法在此重新绑定。
- 绑定可能冲突;表格会高亮显示,但不会阻止你。
- 少数模组存储配置的结构无法被安全检查。它们的按键仍然会出现,但可能是只读的,或通过模组自身的例程重置,而不是像其他绑定那样被暂存。
故障排除
表格无法打开。 检查是否已有其他菜单打开,以及打开按键是否被其他模组拦截。该按键可以在 GMCM 中更改。
某个模组的按键绑定缺失。 打开 SMAPI 控制台,查找以“Keybind:”开头的行。它们会说明哪些配置菜单无法读取,以及原因。
某个模组的行在游戏内变灰。 该模组只允许在标题界面编辑其配置。从标题界面打开按键图鉴,该行就会变为可编辑。
更改没有生效。 在 SMAPI 控制台中查找指明操作和模组的警告——该模组拒绝了写入,日志行会说明是哪一个。
致谢
由 MLD 制作。基于 SMAPI 和 spacechase0 的 Generic Mod Config Menu API 构建。感谢两者让模组配置如此易于访问。
欢迎反馈、错误报告和缺失模组的情况——SMAPI 日志是最有用的附件。 如何联系作者?
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。