Bonsaibauer: Importing a new version from external source

2026-11-07T01:34:48Z

Importing a new version from external source

New page

<languages />



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

 

このページでは、ShroudForge のウィンドウ用ショートカットと、Mod が <code>extended.mod.json</code> で <code>control: "keybind"</code> として明示的に宣言した Mod 用ショートカットを表示、編集できます。


== ショートカットを割り当てる ==

フィールドをクリックして、割り当てたいキーまたはキーの組み合わせを押します。入力には物理的な SDL3 スキャンコードを使用します。例は F7 の <code>SDL:64</code>、<code>Ctrl+SDL:29</code>、<code>Shift+SDL:100</code> です。これにより、キーボード配列が異なっても物理キーの位置が一貫します。SDL は現在の OS 配列に対応した読みやすいラベルを表示します。Ctrl、Alt、Shift、Meta などの修飾キーは完全に一致する必要があります。

記録中、ShroudForge はすべてのプロセスでウィンドウ用ショートカットと宣言済み Mod ショートカットをブロックします。キャンセル後やウィンドウのフォーカスが変わった後も、キーまたはマウスボタンが押されている間は保護が続きます。その後、固定の 3 秒間の遅延が始まり、新しい入力でもリセットされません。Escape は修飾キーの有無にかかわらず記録できません。ゲームでは一時停止メニューとウィンドウを閉じる操作に使われるため、押すと記録がキャンセルされ、以前のショートカットが維持されます。新しい F1 または F12 の割り当てには確認が必要です。Enshrouded または Steam が使用する可能性があるためです。ほかのアクティブな ShroudForge ショートカットと競合する割り当ては保存できません。

ショートカットを無効にするには '''Clear''' を選択します。ShroudForge のウィンドウでは組み込みの既定値に戻すこともできます。Mod ショートカットは各 Mod の設定の一部です。Mod 設定内のフィールドと '''Compatibility → Hotkeys''' のフィールドは、同じ保存値を編集します。


== ShroudForge Mod のショートカット ==

Mod の作者は <code>extended.mod.json</code> でショートカットを設定として宣言します。

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

Mod は 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> は短いキー入力をランタイム更新間で保持し、Mod と設定ごとに 1 回だけ <code>true</code> を返します。保存済みの変更は 1 秒以内にランタイムへ反映されます。キーを押している間に動作を繰り返す場合は <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> は現在の OS 配列に対応する読みやすい SDL ラベルを返します。ゲームウィンドウがフォーカスされている間、キーを照会できます。宣言するだけではスクリプト内の固定キーは変わりません。Mod は API から値を読み取り、そのアクションで使用する必要があります。


== 競合と他の Mod ==

ShroudForge は、アクティブな ShroudForge ウィンドウ用ショートカットと宣言された Mod キーバインドの競合を報告します。キーと修飾キーの組み合わせが重なるアクティブなショートカット間では、新しい競合が生じる割り当てを保存できません。

単独で動作する EML Mod や独自にショートカットを管理する DLL Mod は、ここで確実に再割り当てまたはインターセプトできません。Mod にその設定がある場合は、各 Mod の設定または構成でショートカットを指定してください。EML Mod が <code>extended.mod.json</code> で一致する <code>keybind</code> 設定を明示的に宣言し、ShroudForge Lua API で使用する場合は、ここに表示されることもあります。独立して管理されている EML または DLL のショートカットをこの機能が引き継ぐことはありません。

[[Category:guide:Shroudforge]]

Keyboard shortcuts/ja - Revision history

Bonsaibauer: Importing a new version from external source