Scorciatoie da tastiera

Keyboard shortcuts

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

Assegnare una scorciatoia

Fai clic sul campo e premi il tasto o la combinazione desiderata. L'input usa codici SDL3 fisici, ad esempio SDL:64 per F7, Ctrl+SDL:29 o Shift+SDL:100. 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 extended.mod.json:

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

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

return {
    on_update = function()
        if shroudforge.input.was_keybind_pressed("pasteKey") then
            -- Run the action.
        end
    end,
}

shroudforge.input.was_keybind_pressed("pasteKey") conserva le pressioni brevi tra gli aggiornamenti del runtime e restituisce true una volta per ogni mod e impostazione. Le modifiche salvate in tempo reale raggiungono il runtime entro un secondo. Usa is_keybind_down per le azioni da ripetere mentre il tasto è premuto. La precedente API is_key_down("F1") fino a is_key_down("F8") non è supportata da ShroudForge 1.7.6. Chiamarla registra un messaggio di migrazione e genera un errore Lua. Dichiara invece un'impostazione keybind e assegnala in Hotkey Manager, sotto Compatibility → Hotkeys. shroudforge.input.keybind_label("pasteKey") 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 keybind corrispondente in extended.mod.json e la usa tramite l'API Lua di ShroudForge. Questo non assume il controllo delle scorciatoie EML o DLL gestite in modo indipendente.