Bonsaibauer: Importing a new version from external source

2026-11-07T01:34:52Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-hotkeys.svg|thumb|left|600px|Keyboard shortcuts]]

 

此页面可查看和编辑 ShroudForge 窗口快捷键，以及模组在自己的 <code>extended.mod.json</code> 中明确声明为 <code>control: "keybind"</code> 的快捷键。


== 分配快捷键 ==

单击输入框，然后按下所需的按键或组合键。输入使用物理 SDL3 扫描码，例如 F7 对应的 <code>SDL:64</code>、<code>Ctrl+SDL:29</code> 或 <code>Shift+SDL:100</code>。这样可确保不同键盘布局下物理按键的位置一致。SDL 会根据当前操作系统布局提供易读的标签。Ctrl、Alt、Shift 和 Meta 等修饰键必须完全匹配。

录制时，ShroudForge 会在所有进程中屏蔽其窗口快捷键和已声明的模组快捷键。取消录制或窗口焦点变化后，只要仍有按键或鼠标按钮处于按下状态，保护就会继续生效。随后会开始固定的三秒延迟，新输入不会重置该延迟。无论是否带修饰键，都不能录制 Escape。游戏使用它打开暂停菜单和关闭窗口，因此按下 Escape 会取消录制并保留原来的快捷键。绑定新的 F1 或 F12 需要确认，因为 Enshrouded 或 Steam 可能会使用它们。保存与其他启用的 ShroudForge 快捷键冲突的绑定会被阻止。

选择 '''Clear''' 可禁用快捷键。对于 ShroudForge 窗口，你可以恢复内置默认值。模组快捷键仍属于各自模组的设置。模组设置中的字段和 '''Compatibility → Hotkeys''' 下的字段会编辑同一个已保存值。


== ShroudForge 模组中的快捷键 ==

模组作者会在 <code>extended.mod.json</code> 中将快捷键声明为一项设置：

<pre>
{
"settings": {
"pasteKey": {
"value": "SDL:64",
"label": "Paste blueprint",
"control": "keybind",
"applyAt": "live"
}
}
}
</pre>

模组通过 ShroudForge Lua API 读取此设置。它会响应当前值，而不是在脚本中写死某个按键：

<pre>
return {
on_update = function()
if shroudforge.input.was_keybind_pressed("pasteKey") then
-- Run the action.
end
end,
}
</pre>

<code>shroudforge.input.was_keybind_pressed("pasteKey")</code> 会在运行时更新之间保留短按，并且每个模组和设置只返回一次 <code>true</code>。已保存的实时更改会在一秒内传到运行时。对于按住时需要重复执行的操作，请使用 <code>is_keybind_down</code>。旧的 <code>is_key_down("F1")</code> 到 <code>is_key_down("F8")</code> API 从 ShroudForge 1.7.6 起不再受支持。调用它会记录迁移消息并引发 Lua 错误。请改为声明 <code>keybind</code> 设置，并在 Hotkey Manager 的 '''Compatibility → Hotkeys''' 中为其分配按键。<code>shroudforge.input.keybind_label("pasteKey")</code> 会根据当前操作系统布局返回易读的 SDL 标签。游戏窗口处于焦点时可以查询按键。仅声明设置不会更改脚本中写死的按键。模组必须通过 API 读取此值并将它用于相应操作。


== 冲突和其他模组 ==

ShroudForge 会报告启用的 ShroudForge 窗口快捷键与已声明模组按键绑定之间的冲突。如果按键和修饰键组合重叠，保存时会阻止新增的快捷键冲突。

独立的 EML 模组和自行管理快捷键的 DLL 模组无法在此处可靠地重新映射或拦截。如果模组提供相关选项，请在各自的设置或配置中指定快捷键。如果 EML 模组在 <code>extended.mod.json</code> 中明确声明了匹配的 <code>keybind</code> 设置，并通过 ShroudForge Lua API 使用它，也可以显示在此处。这不会接管由 EML 或 DLL 独立管理的快捷键。

[[Category:guide:Shroudforge]]

Keyboard shortcuts/zh - Revision history

Bonsaibauer: Importing a new version from external source