KeyboardNav

KeyboardNav

改进游戏仅使用键盘的操作支持。

KeyboardNav预览查看大图

关于

此模组专为希望仅使用键盘、无需依赖鼠标的玩家设计。它为大多数菜单提供了基础的键盘支持，实现了用于快速浏览特定菜单的便捷按键绑定，防止光标在使用动作时碍事，并允许你使用键盘独立控制光标。

然而，此模组仍在开发中，一些原版菜单和界面目前尚不支持，最明显的是：

  • 标题画面
  • 从罗宾或法师处发起、绘制或升级建筑的界面

在这些问题修复之前，你仍然需要鼠标或触控板来与这些菜单交互并加载你的存档。

功能与按键绑定

菜单导航：

此模组强制启用手柄模式，并定义一个（或多个）按键，用于在菜单中模拟左键点击。仅凭这两项功能，就能为大多数支持游戏手柄模式的菜单提供基础支持。默认情况下，在菜单中按 空格键 和 回车键 都将执行左键点击。

物品栏网格按键绑定：

为了更快地浏览物品栏和箱子，此模组为每一行和每一列定义了一个按键，让你只需按两个键就能跳转到任意格子。这些按键绑定存储为一个数组，允许你添加额外的条目，以适应那些扩展这些物品栏大小的模组。

默认情况下，列被编号为 1234567890[]，行被编号为 ZXCVBNM,。这些是可配置的，标签会更新以匹配相应的字母。

示例图片

其他菜单按键绑定：

为了更高效地使用键盘，此模组为各种菜单特定操作定义了特殊的按键绑定，例如整理物品栏、打开箱子颜色选择器、切换标签页，以及自动添加到箱子的堆叠中。

目前可用的功能有：

  • 上一个/下一个标签页（默认为 TAB/LEFT SHIFT + TAB）
  • 整理菜单的主物品栏（默认为 O）
  • 整理菜单的次级物品栏，即箱子物品栏下方显示的玩家物品栏（默认为 I）
  • 从物品栏填充箱子堆叠（默认为 U）
  • 切换箱子颜色选择器（默认为 P）
  • 将手持物品移至垃圾桶（不会自动扔掉物品，只是将光标移到垃圾桶上）（默认为 Y）

光标移动：

为防止光标碍事并转移动作和工具按钮的焦点，此模组会在正常游戏过程中将光标吸附到农夫正前方的格子上。然而，有时你可能需要将光标移动到屏幕上的其他位置（例如，移动家具）。按住光标修饰键（默认为 LEFT SHIFT）将使移动键（如 WASD）移动光标而不是玩家。

或者，你也可以在玩家不移动时使用鼠标输入来移动光标，或通过关联的按键（默认为 Z）禁用键盘模式。

覆盖游戏设置：

当键盘模式启用时，此模组会自动覆盖游戏设置以打开手柄模式。当键盘模式禁用时，手柄模式将恢复为该存档的默认设置。

兼容性

此模组理论上与添加了更大箱子（你可以在 config.json 的列表中添加额外的按键绑定）以及任何其他支持原版手柄模式的自定义菜单的模组兼容，也兼容如 Dialogue Keys 等添加其他键盘支持功能的模组。但是，与任何特定模组的兼容性均未经测试。

它不支持不支持原版手柄模式的模组菜单，例如 GMCM。你仍然可以使用鼠标操作这些菜单，但无法使用键盘导航。如果你是模组作者，并希望让你的模组与键盘导航兼容，请参考原版菜单是如何实现手柄模式支持的。

所有添加的按键绑定都可以在 config.json 文件中配置，以防冲突。该文件会在你首次加载带有此模组的存档时，在模组文件夹中生成。（编辑 config.json 时，请注意标记为“INFO”的配置字段仅提供该组配置的信息，更改它们不会产生任何效果。）

开发路线图

以下是我希望在此模组中添加或修复的内容，大致按优先级排列：

  1. 支持存档选择界面
  2. 支持建筑界面（选择建造位置或升级建筑时）
  3. 在原版设置菜单中设置快捷键时禁用键盘快捷键（目前需要先禁用键盘模式，否则模组的按键绑定会干扰）
  4. 更多便捷按键绑定：
    • 从堆叠中拾取 1 个
    • 拆分物品栏堆叠
    • 丢弃物品
    • 打开社区中心收集包菜单
    • 使用数字键选择存档
  5. 能够设置并自动恢复特定模式的默认按键绑定（部分实现）
  6. 性能优化等
  7. 当光标被吸附到玩家身上时使其不可见（可配置）
  8. 支持标题画面上的非 wasd 按键
  9. 自定义设置页面（远期目标）

如果你遇到任何我未提及需要修复的不受支持的菜单或问题，请告诉我。

许可与贡献

此模组是开源的。有关许可和贡献信息，请查看 Codeberg 仓库。

安装说明

要安装，请将解压后的 KeyboardMod 文件夹移动到你的模组文件夹中。如果你想编辑默认按键绑定，请在模组运行时加载一个存档以生成配置文件。