Bonsaibauer: Importing a new version from external source

2026-11-07T01:34:47Z

Importing a new version from external source

New page

<languages />



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

 

Op deze pagina kun je sneltoetsen voor ShroudForge-vensters en mod-sneltoetsen bekijken en bewerken die een mod expliciet als <code>control: "keybind"</code> in het eigen <code>extended.mod.json</code> opgeeft.


== Een sneltoets toewijzen ==

Klik op het veld en druk op de gewenste toets of toetsencombinatie. De invoer gebruikt fysieke SDL3-scancodes, zoals <code>SDL:64</code> voor F7, <code>Ctrl+SDL:29</code> of <code>Shift+SDL:100</code>. Zo blijft de fysieke positie van de toets consistent bij verschillende toetsenbordindelingen. SDL geeft leesbare labels voor de huidige indeling van het besturingssysteem. Modificatietoetsen zoals Ctrl, Alt, Shift en Meta moeten exact overeenkomen.

Tijdens het opnemen blokkeert ShroudForge de sneltoetsen van zijn vensters en de opgegeven mod-sneltoetsen in alle processen. De bescherming blijft actief na annuleren of een wijziging van de vensterfocus zolang een toets of muisknop ingedrukt is. Daarna volgt een vaste vertraging van drie seconden. Nieuwe invoer start die vertraging niet opnieuw. Escape kan niet worden opgenomen, met of zonder modificatietoetsen. De game gebruikt Escape voor het pauzemenu en om vensters te sluiten. Daarom annuleert deze toets de opname en blijft de vorige sneltoets behouden. Voor nieuwe F1- of F12-bindingen is bevestiging nodig omdat Enshrouded of Steam deze toetsen kan gebruiken. Een binding opslaan die botst met een andere actieve ShroudForge-sneltoets wordt geblokkeerd.

Gebruik '''Clear''' om een sneltoets uit te schakelen. Voor ShroudForge-vensters kun je de ingebouwde standaardwaarde herstellen. Mod-sneltoetsen blijven onderdeel van de instellingen van de betreffende mod. De velden in de modinstellingen en onder '''Compatibility → Hotkeys''' bewerken dezelfde opgeslagen waarde.


== Sneltoetsen in een ShroudForge-mod ==

Een modmaker geeft een sneltoets op als instelling in <code>extended.mod.json</code>:

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

De mod leest deze instelling via de ShroudForge Lua-API. Het script reageert op de huidige waarde in plaats van een toets vast in de code op te nemen:

<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> bewaart korte toetsaanslagen tussen runtime-updates en retourneert eenmaal per mod en instelling <code>true</code>. Opgeslagen wijzigingen zijn binnen één seconde beschikbaar in de runtime. Gebruik <code>is_keybind_down</code> voor acties die moeten worden herhaald zolang de toets ingedrukt blijft. De oude API <code>is_key_down("F1")</code> tot en met <code>is_key_down("F8")</code> wordt sinds ShroudForge 1.7.6 niet meer ondersteund. Een aanroep logt een migratiebericht en veroorzaakt een Lua-fout. Geef in plaats daarvan een instelling van het type <code>keybind</code> op en wijs die toe via Hotkey Manager onder '''Compatibility → Hotkeys'''. <code>shroudforge.input.keybind_label("pasteKey")</code> retourneert het huidige leesbare SDL-label voor de indeling van het besturingssysteem. De toetsquery werkt wanneer een gamevenster de focus heeft. Alleen een declaratie verandert geen toets die in een script is vastgelegd. De mod moet de waarde via de API lezen en voor de actie gebruiken.


== Conflicten en andere mods ==

ShroudForge meldt conflicten tussen actieve sneltoetsen voor ShroudForge-vensters en opgegeven mod-keybinds. Het opslaan van een nieuwe combinatie die overlapt met een andere actieve toets- en modificatorcombinatie wordt geblokkeerd.

Zelfstandige EML-mods en DLL-mods die hun eigen sneltoetsen beheren, kunnen hier niet betrouwbaar opnieuw worden toegewezen of onderschept. Stel deze sneltoetsen in via de instellingen of configuratie van de betreffende mod, als die optie beschikbaar is. Een EML-mod kan hier ook verschijnen als deze expliciet een overeenkomende <code>keybind</code>-instelling opgeeft in <code>extended.mod.json</code> en daarvoor de ShroudForge Lua-API gebruikt. Dit neemt de controle over zelfstandig beheerde EML- of DLL-sneltoetsen niet over.

[[Category:guide:Shroudforge]]

Keyboard shortcuts/nl - Revision history

Bonsaibauer: Importing a new version from external source