Jump to content
Toggle menu
  • 64 articles
  • 37 files
  • 9 users
  • 4.6K edits
Shroudforge
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Standard di caricamento della catena DInput8

From Shroudforge
Revision as of 17:01, 14 November 2026 by Bonsaibauer (talk | contribs) (Importing a new version from external source)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


DInput8 chain loading standard



Molti mod loader di Enshrouded e mod DLL vogliono essere la `dinput8.dll` del gioco, ma può esistere un solo file con quel nome. Il loader che lo occupa avvia le altre DLL elencate in `dinput8-chain.ini`, accanto all'eseguibile del gioco. EMF, Kiln, ShroudForge, XHL-Core e Auto Loot Plus leggono questo file. Questa pagina registra le regole affinché ogni loader lo interpreti allo stesso modo e l'elenco del giocatore funzioni con qualunque loader occupi `dinput8.dll`.

Questa pagina è di pubblico dominio con licenza CC0. Puoi copiarla e modificarla nella documentazione del tuo progetto senza obbligo di attribuzione. Le modifiche approvate da più loader sono benvenute come pull request nel repository EMF.

Le parole must e should indicano il comportamento di un loader conforme alla specifica.

Il file

; my mods
[Chain]
mods\mymod\mymod.dll
autolootplus.dll

[EMF]
creative.dll
  • Posizione: `dinput8-chain.ini` nella cartella dell'eseguibile del gioco (`enshrouded.exe` o `enshrouded_server.exe`).
  • Codifica: il loader deve leggere UTF-8 con o senza BOM e UTF-16 LE con BOM. Dovrebbe anche leggere la pagina codici ANSI del sistema quando i byte non sono UTF-8 valido, come nei file salvati da un vecchio Blocco note. Uno strumento che scrive il file deve mantenere la codifica e le interruzioni di riga trovate.
  • Righe: quelle vuote sono ignorate. Una riga che inizia con `;`, `#` o `//` è un commento. `; ` prima di una riga DLL la disattiva senza eliminarla. Un commento può seguire il nome dopo uno spazio o un tab (`mymod.dll ; my mod`) e il nome può essere tra virgolette doppie.
  • Sezioni, senza distinzione tra maiuscole e minuscole: `[Chain]` è condivisa e ogni loader conforme avvia le sue DLL. Ogni altra sezione appartiene a uno strumento e ne porta il nome, ad esempio `[EMF]` o `[Kiln]`. Gli altri loader devono ignorarla. Le righe prima di una sezione appartengono a `[Chain]`. I file meno recenti potrebbero non avere sezioni.
  • Righe `key=value`: `name=value` è un'entrata DLL se il valore indica un `.dll`. Le altre chiavi sono impostazioni dello strumento che le ha scritte e gli altri loader le ignorano.

Le DLL

  • I percorsi sono relativi alla cartella dell'eseguibile. `/` viene letto come `\`. Il loader deve rifiutare percorsi assoluti, lettere di unità, percorsi UNC (`\\server\...`) e qualsiasi parte `..`. Il file di catena non deve uscire dalla cartella del gioco.
  • Solo file `.dll`. Una riga che nomina altro viene ignorata e segnalata.
  • Non caricare mai la stessa `dinput8.dll` e non avviare una seconda copia del loader. EMF, ad esempio, riconosce il proprio loader anche con un altro nome e non avvia quella copia.
  • Ogni DLL una volta sola. Se compare due volte, in `[Chain]` e nella sezione di uno strumento o due volte nella stessa sezione, parte solo alla prima posizione.
  • Ordine: le DLL partono dall'alto verso il basso. `[Chain]` e la sezione del loader vengono considerate nell'ordine in cui appaiono nel file.
  • Momento: usare `LoadLibrary` dalla propria `DllMain` o subito dopo, prima dell'esecuzione del codice del gioco. È il momento in cui sarebbe partita una DLL collegata se fosse stata essa stessa `dinput8.dll`.
  • Si conteggiano al massimo 256 entrate. Le altre vengono segnalate e ignorate.
  • Errori: una DLL mancante o impossibile da caricare viene ignorata e segnalata. Sono inclusi l'errore Windows 126 e il 1114 se fallisce `DllMain`. Il gioco continua.

Segnalazioni

Il loader dovrebbe registrare una riga per ogni DLL collegata: avviata, ignorata perché disattivata, rifiutata o già caricata, oppure fallita con il numero di errore Windows. EMF scrive le stesse informazioni anche in una tabella `emf\chain_status.txt`, così i giocatori possono condividerle.

Spostare la dinput8.dll di un altro strumento

Un programma di installazione che trova la `dinput8.dll` di un altro strumento dovrebbe rinominarla senza eliminarla, inserire il nuovo nome nella propria sezione di `dinput8-chain.ini` e ripristinarla alla disinstallazione. Se EMF riconosce lo strumento usa `<tool>.dll`, altrimenti le informazioni di versione della DLL o `dinput8-previous.dll`. Registra lo spostamento in `emf\moved.txt`.

Esportazioni

Il gioco chiama `DirectInput8Create` sul loader che detiene `dinput8.dll`. Il loader deve inoltrare la chiamata alla `dinput8.dll` di Windows (`%SystemRoot%\System32\dinput8.dll`). Le DLL collegate non ricevono chiamate DirectInput. Un mod che lavora in `DirectInput8Create` deve spostare quel lavoro in `DllMain` o in un thread avviato da esso.

Chi la segue

Strumento Legge `[Chain]` Sezione propria
EMF sì, anche le righe prima di ogni sezione `[EMF]`, per le DLL rinominate dal suo installer
ShroudForge sì, ogni voce deve trovarsi in `mods\<folder>\` e le altre vengono segnalate
Kiln sì, anche `[EMF]` per le DLL rinominate dai vecchi installer EMF nessuna, il suo elenco è in `kiln\chain.ini`. Nomi tra virgolette e commenti dopo un nome sono pianificati.
XHL-Core, Auto Loot Plus sì

Facci sapere se il tuo strumento legge il file o lo interpreta diversamente, così aggiorneremo la tabella.

Fonte

Specifica condivisa EMF per dinput8-chain.ini. La specifica originale è di pubblico dominio con licenza CC0.