Standard di caricamento della catena DInput8
More actions
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.