Bonsaibauer: Importing a new version from external source

2026-11-07T00:55:54Z

Importing a new version from external source

New page

<languages />



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

 

Cette page affiche et modifie les raccourcis des fenêtres ShroudForge ainsi que ceux que les mods déclarent explicitement avec <code>control: "keybind"</code> dans leur fichier <code>extended.mod.json</code>.


== Attribuer un raccourci ==

Cliquez sur le champ et appuyez sur la touche ou la combinaison souhaitée. La saisie utilise des codes physiques SDL3, par exemple <code>SDL:64</code> pour F7, <code>Ctrl+SDL:29</code> ou <code>Shift+SDL:100</code>. La position physique reste ainsi cohérente entre les dispositions de clavier. SDL fournit des libellés lisibles pour la disposition actuelle du système d’exploitation. Les modificateurs comme Ctrl, Alt, Shift et Meta doivent correspondre exactement.

Pendant l’enregistrement, ShroudForge bloque ses raccourcis de fenêtre et les raccourcis de mods déclarés dans tous ses processus. Cette protection reste active même après une annulation ou un changement de fenêtre active jusqu’à ce qu’aucune touche ni aucun bouton de souris ne soit maintenu. Un délai fixe de trois secondes commence ensuite, et les nouvelles pressions ne le relancent pas. Échap ne peut pas être enregistrée, seule ou avec des touches de modification : le jeu s’en sert pour son menu de pause et pour fermer ses fenêtres. L’appuyer annule l’enregistrement et garde le raccourci précédent. Une confirmation est requise pour toute nouvelle attribution de F1 ou F12, car Enshrouded ou Steam peut les utiliser. L’enregistrement est bloqué si le raccourci entre en conflit avec un autre raccourci ShroudForge actif.

Utilisez '''Effacer''' pour désactiver un raccourci. Pour les fenêtres ShroudForge, vous pouvez restaurer la valeur par défaut intégrée. Les raccourcis d’un mod restent dans ses propres paramètres. Les champs des paramètres du mod et de '''Compatibility → Hotkeys''' modifient la même valeur enregistrée.


== Raccourcis dans un mod ShroudForge ==

L’auteur du mod déclare le raccourci comme paramètre dans <code>extended.mod.json</code> :

<pre>
{
"settings": {
"pasteKey": {
"value": "SDL:64",
"label": "Coller le plan",
"control": "keybind",
"applyAt": "live"
}
}
}
</pre>

Le mod lit ce paramètre avec l’API Lua de ShroudForge. Il utilise ainsi la valeur actuelle au lieu d’imposer une touche dans le script :

<pre>
return {
on_update = function()
if shroudforge.input.was_keybind_pressed("pasteKey") then
-- Exécuter l’action.
end
end,
}
</pre>

<code>shroudforge.input.was_keybind_pressed("pasteKey")</code> conserve les pressions brèves entre les mises à jour du runtime et renvoie <code>true</code> une fois par mod et paramètre. Les changements enregistrés en direct atteignent le runtime en une seconde au maximum. Utilisez <code>is_keybind_down</code> pour les actions qui doivent se répéter tant que la touche reste enfoncée. L’ancienne API <code>is_key_down("F1")</code> à <code>is_key_down("F8")</code> n’est plus prise en charge depuis ShroudForge 1.7.6. Son appel inscrit un message de migration dans le journal et déclenche une erreur Lua. Déclarez un paramètre <code>keybind</code> et attribuez-le dans le gestionnaire de raccourcis, sous '''Compatibility → Hotkeys'''. <code>shroudforge.input.keybind_label("pasteKey")</code> renvoie le libellé lisible actuel de SDL pour la disposition du système d’exploitation. La lecture des touches fonctionne lorsqu’une fenêtre du jeu est active. La déclaration seule ne remplace pas une touche codée en dur dans le script. Le mod doit lire cette valeur avec l’API et l’utiliser pour son action.


== Conflits et autres mods ==

ShroudForge signale les conflits entre les raccourcis actifs de ses fenêtres et les raccourcis déclarés par les mods. L’enregistrement ne peut pas créer un nouveau conflit entre des raccourcis actifs dont la touche et les modificateurs se chevauchent.

Les mods EML autonomes et les mods DLL qui gèrent leurs propres raccourcis ne peuvent pas être réattribués ou interceptés de façon fiable ici. Configurez-les dans les paramètres ou le fichier de configuration du mod, si celui-ci le permet. Un mod EML peut aussi apparaître ici s’il déclare explicitement un paramètre <code>keybind</code> correspondant dans <code>extended.mod.json</code> et utilise l’API Lua de ShroudForge. Ses raccourcis EML ou DLL gérés indépendamment ne sont pas repris pour autant.

[[Category:guide:Shroudforge]]

Keyboard shortcuts/fr - Revision history

Bonsaibauer: Importing a new version from external source