Tastenkürzel

Keyboard shortcuts

Hier siehst und änderst du Fensterkürzel von ShroudForge sowie Mod-Tastenkürzel, die ein Mod ausdrücklich als control: "keybind" in seiner extended.mod.json deklariert.

Ein Kürzel belegen

Klicke auf das Feld und drücke die gewünschte Taste oder Kombination. Die Eingabe verwendet physische SDL3-Tastencodes, zum Beispiel SDL:64 für F7, Ctrl+SDL:29 oder Shift+SDL:100. Dadurch bleibt die Tastenposition über verschiedene Tastaturlayouts hinweg gleich. SDL liefert die lesbare Beschriftung passend zum aktuellen Betriebssystemlayout. Zusatztasten wie Ctrl, Alt, Shift und Meta müssen genau übereinstimmen.

Während der Aufnahme sperrt ShroudForge seine Fensterkürzel und die deklarierten Mod-Kürzel prozessübergreifend. Die Sperre bleibt auch nach Abbruch oder Fokuswechsel bestehen, bis keine Taste und keine Maustaste mehr gedrückt ist. Danach läuft eine feste Frist von drei Sekunden, die neue Eingaben nicht zurücksetzen. Escape lässt sich nicht aufnehmen, auch nicht mit Zusatztasten: Das Spiel nutzt die Taste für sein Pausenmenü und zum Schließen seiner Fenster. Ein Druck darauf bricht die Aufnahme ab und behält das bisherige Kürzel. Neue Belegungen mit F1 oder F12 erfordern wegen möglicher Funktionen von Enshrouded und Steam eine Bestätigung. Ein Konflikt mit einem anderen aktiven ShroudForge-Kürzel blockiert das Speichern.

Mit Löschen deaktivierst du ein Kürzel. Für ShroudForge-Fenster kannst du den eingebauten Standard wiederherstellen. Mod-Tastenkürzel bleiben Teil der eigenen Mod-Einstellungen. Die Felder in den Mod-Einstellungen und unter Kompatibilität → Tastenkürzel bearbeiten denselben gespeicherten Wert.

Tastenkürzel in einem ShroudForge-Mod

Ein Mod-Autor deklariert das Kürzel als Einstellung in extended.mod.json:

{
  "settings": {
    "pasteKey": {
      "value": "SDL:64",
      "label": "Bauplan einfügen",
      "control": "keybind",
      "applyAt": "live"
    }
  }
}

Der Mod liest diese Einstellung über die ShroudForge-Lua-API aus. Damit reagiert er auf den aktuell eingestellten Wert, statt eine feste Taste im Skript zu verwenden:

return {
    on_update = function()
        if shroudforge.input.was_keybind_pressed("pasteKey") then
            -- Die Aktion ausführen.
        end
    end,
}

shroudforge.input.was_keybind_pressed("pasteKey") merkt auch kurze Tastendrücke zwischen zwei Runtime-Updates und liefert pro Mod und Einstellung einmal true. Live gespeicherte Änderungen erreichen die Runtime innerhalb einer Sekunde. Für Aktionen, die während des Haltens wiederholt werden sollen, verwende is_keybind_down. Die frühere API is_key_down("F1") bis is_key_down("F8") wird seit ShroudForge 1.7.6 nicht mehr unterstützt. Ein Aufruf protokolliert einen Migrationshinweis und löst einen Lua-Fehler aus. Deklariere stattdessen eine keybind-Einstellung und weise sie im Hotkey-Manager unter Kompatibilität → Tastenkürzel zu. shroudforge.input.keybind_label("pasteKey") liefert die aktuelle lesbare SDL-Beschriftung für das Betriebssystemlayout. Die Tastenabfrage funktioniert bei fokussiertem Spielfenster. Eine Deklaration allein ändert keine fest im Skript hinterlegte Taste. Der Mod muss den Wert über diese API abfragen und für seine Aktion verwenden.

Konflikte und fremde Mods

ShroudForge weist auf Konflikte zwischen aktiven, von ShroudForge verwalteten Fensterkürzeln und deklarierten Mod-Keybinds hin. Aktive Kürzel mit überlappender Taste und Modifikatorkombination können beim Speichern nicht neu in Konflikt gebracht werden.

Eigenständige EML-Mods und DLL-Mods, die ihre eigenen Tastenkürzel verwalten, lassen sich hier nicht zuverlässig umbelegen oder abfangen. Stelle solche Kürzel in den Einstellungen des jeweiligen Mods oder in dessen eigener Konfiguration ein, sofern der Mod das anbietet. Auch ein EML-Mod kann hier erscheinen, wenn er ausdrücklich eine passende keybind-Einstellung in extended.mod.json deklariert und die ShroudForge-Lua-API dafür verwendet. Seine unabhängig verwalteten EML- oder DLL-Kürzel werden dadurch nicht übernommen.