FuzzyBot: Updating to match new version of source page

2026-11-06T23:44:17Z

Updating to match new version of source page

New page

<languages />



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

 

Hier siehst und änderst du Fensterkürzel von ShroudForge sowie Mod-Tastenkürzel, die ein Mod ausdrücklich als <code>control: "keybind"</code> in seiner <code>extended.mod.json</code> 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 <code>SDL:64</code> für F7, <code>Ctrl+SDL:29</code> oder <code>Shift+SDL:100</code>. 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 <code>extended.mod.json</code>:

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

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:

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

<code>shroudforge.input.was_keybind_pressed("pasteKey")</code> merkt auch kurze Tastendrücke zwischen zwei Runtime-Updates und liefert pro Mod und Einstellung einmal <code>true</code>. Live gespeicherte Änderungen erreichen die Runtime innerhalb einer Sekunde. Für Aktionen, die während des Haltens wiederholt werden sollen, verwende <code>is_keybind_down</code>. Die frühere API <code>is_key_down("F1")</code> bis <code>is_key_down("F8")</code> 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 <code>keybind</code>-Einstellung und weise sie im Hotkey-Manager unter '''Kompatibilität → Tastenkürzel''' zu. <code>shroudforge.input.keybind_label("pasteKey")</code> 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 <code>keybind</code>-Einstellung in <code>extended.mod.json</code> deklariert und die ShroudForge-Lua-API dafür verwendet. Seine unabhängig verwalteten EML- oder DLL-Kürzel werden dadurch nicht übernommen.

[[Category:guide:Shroudforge]]

Keyboard shortcuts/de - Revision history

FuzzyBot: Updating to match new version of source page