キーボードショートカット

This page is a translated version of the page Keyboard shortcuts and the translation is 100% complete.

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

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

フィールドをクリックして、割り当てたいキーまたはキーの組み合わせを押します。入力には物理的な SDL3 スキャンコードを使用します。例は F7 の SDL:64、Ctrl+SDL:29、Shift+SDL:100 です。これにより、キーボード配列が異なっても物理キーの位置が一貫します。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 の作者は extended.mod.json でショートカットを設定として宣言します。

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

Mod は ShroudForge Lua API を使ってこの設定を読み取ります。スクリプトにキーを直接記述するのではなく、現在の値に応じて動作します。

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

shroudforge.input.was_keybind_pressed("pasteKey") は短いキー入力をランタイム更新間で保持し、Mod と設定ごとに 1 回だけ true を返します。保存済みの変更は 1 秒以内にランタイムへ反映されます。キーを押している間に動作を繰り返す場合は is_keybind_down を使います。以前の is_key_down("F1") から is_key_down("F8") までの API は ShroudForge 1.7.6 以降サポートされていません。呼び出すと移行メッセージがログに記録され、Lua エラーが発生します。代わりに keybind 設定を宣言し、Hotkey Manager の Compatibility → Hotkeys で割り当ててください。shroudforge.input.keybind_label("pasteKey") は現在の OS 配列に対応する読みやすい SDL ラベルを返します。ゲームウィンドウがフォーカスされている間、キーを照会できます。宣言するだけではスクリプト内の固定キーは変わりません。Mod は API から値を読み取り、そのアクションで使用する必要があります。

競合と他の Mod

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

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