DLL Manager

DLL Manager

Nel Modloader apri Compatibility → DLL Manager. La guida appare nella parte superiore del pannello. Elenca le DLL delle mod trovate da ShroudForge e indica se sono state caricate. Per le mod note esistono profili già preparati. Per le altre DLL, selezionale e confermale lì.

Posso usare più di una mod DLL nativa?

Sì. Installa ogni mod in una cartella separata direttamente sotto mods/ e conserva i file e le sottocartelle forniti dall'autore. Un profilo corrispondente potrebbe già selezionare la DLL corretta. Per una mod senza profilo corrispondente, apri Adjust DLL selection nel DLL Manager. Seleziona solo le DLL di ingresso indicate dall'autore. Scegli il target di caricamento e conferma di fidarti della DLL. Per le normali librerie native mantieni Normal DLL. Scegli DirectInput proxy solo per una DLL destinata a fornire DirectInput ed esportare DirectInput8Create. Fai clic su Apply selection e riavvia il gioco. Il solo rilevamento non carica una DLL senza profilo. Serve una selezione confermata nel DLL Manager, una dichiarazione in native-plugin.ini o dinput8-chain.ini, oppure la registrazione da parte della sua mod Lua.

Cosa fare con una mod scaricata

• No DLL included: Installa la mod nel modo consueto. Le mod create per ShroudForge o EML non necessitano di una DLL nativa aggiuntiva.
• DLL included: Inserisci la DLL della mod nella sua cartella come mostrato sotto. Comparirà quindi nel DLL Manager. Un profilo noto ha già preparato la selezione. Altrimenti seleziona la DLL e confermala lì.
• Other mod files included: Conserva l'intera cartella della mod. Non rimuovere file come mod.json, native-plugin.ini o i file di configurazione.

Se una mod contiene più file DLL

Molte cartelle di mod contengono DLL usate solo come file di supporto. Seleziona solo le DLL che il profilo della mod o le istruzioni dell'autore indicano per il caricamento. I controlli su e giù impostano l'ordine delle DLL selezionate all'interno di quella cartella. Non definiscono un ordine manuale globale per le normali DLL che si trovano in cartelle di mod separate.

Installare una DLL di una mod

Se l'installer ShroudForge riconosce il pacchetto scaricato, installalo da lì. Per un'installazione manuale, assegna a ogni mod una cartella separata direttamente sotto mods/ e inserisci lì la DLL. Se nell'archivio la DLL si trova accanto alla cartella della mod, spostala insieme alla mod. Mantieni il nome file originale e le sottocartelle del pacchetto.

mods/
  my-mod/
    mod.json        (if included)
    dinput8.dll     (or the mod's DLL)
    config.ini      (if included)

Una DLL non viene caricata solo perché si trova nella cartella. Selezionala nel DLL Manager come descritto sopra.

Perché il file della mod può chiamarsi anch'esso dinput8.dll?

Il file di avvio di ShroudForge è dinput8.dll nella cartella del gioco. Il file della mod è separato e si trova in mods/<mod-folder>/dinput8.dll. ShroudForge lo carica da quel percorso completo. Con un profilo corrispondente o una selezione nel DLL Manager, ShroudForge inoltra le chiamate DirectInput. Entrambi i file possono mantenere lo stesso nome. Non rinominare il file della mod e non inserirlo nella cartella del gioco. Non sostituire lì il file di avvio di ShroudForge.

Capire i profili

Un profilo è un'impostazione preparata per una mod nota. Indica a ShroudForge quali file caricare e come. ShroudForge lo abbina all'ID della mod in mod.json o, se manca, al nome della cartella. Puoi anche scegliere un profilo nel DLL Manager. I profili non modificano i file della mod. Una selezione DLL personalizzata salvata sostituisce la selezione dei file del profilo.

Catena DirectInput esistente

Un file dinput8-chain.ini già presente nella cartella del gioco usa il formato stabilito:

[Chain]
mods\my-mod\dinput8.dll
mods\another-mod\native.dll

Le voci devono indicare file all'interno di pacchetti mod diretti, come mods/<mod-folder>/. Le DLL nella cartella principale del gioco e i percorsi esterni a questi pacchetti vengono rifiutati. Il loro ordine ha la precedenza sulle dichiarazioni dedotte automaticamente. Questo file imposta l'ordine della catena dei provider DirectInput, non quello delle DLL normali tra cartelle di mod. Lo stesso percorso file risolto viene caricato una sola volta. La prima DLL valida che esporta il proprio DirectInput8Create riceve le chiamate inoltrate. Le successive DLL proxy DirectInput possono comunque essere caricate, ma le loro esportazioni DirectInput non sono attive nella catena. Non presumere che più proxy funzionino insieme. I file di avvio di ShroudForge vengono esclusi e l'inoltro ricorsivo usa la libreria Windows originale.

Interruttori, processo di destinazione e riavvio

L'interruttore principale controlla tutto il caricamento nativo eseguito da ShroudForge, incluse le registrazioni INI, dei profili, della catena e di Lua. Una selezione disattivata impedisce il caricamento automatico per quella cartella. Client, server o entrambi determinano il processo di destinazione. Le esclusioni per nome file si applicano subito prima del caricamento. Non identificano la funzione di una mod dal nome.

Le DLL caricate restano in memoria finché il processo non termina. Per disabilitarle, cambiarne l'ordine o scegliere un altro profilo è quindi necessario riavviare il gioco. Dichiarare due volte lo stesso file non crea una seconda istanza.

Viene visualizzato un errore di caricamento

Controlla il nome della mod, il percorso del file e la causa indicata. L'errore Windows 126 può indicare che manca il file principale o una delle librerie richieste. Se manca l'esportazione DirectInput, controlla il file selezionato e la modalità di caricamento. “Loaded” conferma il caricamento, non tutte le funzioni della mod.

Un formato di plugin nativo sconosciuto, un livello Vulkan, un altro loader completo o un programma esterno richiedono l'integrazione prevista per essi. Caricare una libreria da solo non sostituisce quell'interfaccia.

Installare pacchetti

L'installer individua anche un singolo pacchetto mod dentro cartelle di archivi annidate. I profili noti importano i file supplementari indicati esplicitamente. Un nuovo archivio con più pacchetti mod non viene installato automaticamente come gruppo. Estrailo e installa una cartella mod per volta. Il normale runtime non apre archivi né avvia programmi esterni.