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]]

 

Questa pagina mostra e modifica le scorciatoie delle finestre di ShroudForge e quelle delle mod dichiarate esplicitamente da una mod come <code>control: "keybind"</code> nel proprio <code>extended.mod.json</code>.


== Assegnare una scorciatoia ==

Fai clic sul campo e premi il tasto o la combinazione desiderata. L'input usa codici SDL3 fisici, ad esempio <code>SDL:64</code> per F7, <code>Ctrl+SDL:29</code> o <code>Shift+SDL:100</code>. In questo modo la posizione fisica del tasto resta coerente con i diversi layout di tastiera. SDL fornisce etichette leggibili per il layout del sistema operativo corrente. I modificatori come Ctrl, Alt, Shift e Meta devono corrispondere esattamente.

Durante la registrazione, ShroudForge blocca le scorciatoie delle proprie finestre e quelle dichiarate dalle mod in tutti i processi. La protezione resta attiva anche dopo l'annullamento o un cambio di finestra attiva, finché un tasto o un pulsante del mouse è premuto. Poi parte un ritardo fisso di tre secondi, che un nuovo input non reimposta. Non è possibile registrare Escape, con o senza modificatori. Il gioco lo usa per il menu di pausa e per chiudere le finestre, quindi premendolo la registrazione viene annullata e la scorciatoia precedente resta attiva. Le nuove assegnazioni F1 o F12 richiedono una conferma perché Enshrouded o Steam potrebbero usarle. Non è possibile salvare un'assegnazione in conflitto con un'altra scorciatoia ShroudForge attiva.

Usa '''Clear''' per disabilitare una scorciatoia. Per le finestre ShroudForge puoi ripristinare il valore predefinito integrato. Le scorciatoie delle mod restano nelle impostazioni di ciascuna mod. I campi nelle impostazioni della mod e in '''Compatibility → Hotkeys''' modificano lo stesso valore salvato.


== Scorciatoie in una mod ShroudForge ==

L'autore di una mod dichiara una scorciatoia come impostazione in <code>extended.mod.json</code>:

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

La mod legge questa impostazione tramite l'API Lua di ShroudForge. Usa il valore corrente invece di codificare un tasto fisso nello script:

<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> conserva le pressioni brevi tra gli aggiornamenti del runtime e restituisce <code>true</code> una volta per ogni mod e impostazione. Le modifiche salvate in tempo reale raggiungono il runtime entro un secondo. Usa <code>is_keybind_down</code> per le azioni da ripetere mentre il tasto è premuto. La precedente API <code>is_key_down("F1")</code> fino a <code>is_key_down("F8")</code> non è supportata da ShroudForge 1.7.6. Chiamarla registra un messaggio di migrazione e genera un errore Lua. Dichiara invece un'impostazione <code>keybind</code> e assegnala in Hotkey Manager, sotto '''Compatibility → Hotkeys'''. <code>shroudforge.input.keybind_label("pasteKey")</code> restituisce l'etichetta SDL leggibile corrente per il layout del sistema operativo. La query del tasto funziona quando una finestra del gioco è attiva. La sola dichiarazione non modifica un tasto codificato nello script. La mod deve leggere questo valore tramite l'API e usarlo per l'azione.


== Conflitti e altre mod ==

ShroudForge segnala i conflitti tra le scorciatoie attive delle finestre ShroudForge e i keybind dichiarati dalle mod. Il salvataggio impedisce nuovi conflitti tra scorciatoie attive quando le combinazioni di tasti e modificatori si sovrappongono.

Le mod EML autonome e le mod DLL che gestiscono le proprie scorciatoie non possono essere rimappate o intercettate in modo affidabile qui. Configura quelle scorciatoie nelle impostazioni o nella configurazione della mod, se l'opzione è disponibile. Una mod EML può apparire qui anche se dichiara esplicitamente un'impostazione <code>keybind</code> corrispondente in <code>extended.mod.json</code> e la usa tramite l'API Lua di ShroudForge. Questo non assume il controllo delle scorciatoie EML o DLL gestite in modo indipendente.

[[Category:guide:Shroudforge]]

Keyboard shortcuts/it - Revision history

Bonsaibauer: Importing a new version from external source