DLL Manager

Open in Modloader Compatibility → DLL Manager. De handleiding staat bovenaan dat paneel. Je ziet er de mod-DLL's die ShroudForge heeft gevonden en of ze zijn geladen. Voor bekende mods zijn profielen voorbereid. Selecteer en bevestig andere DLL's daar.

Kan ik meer dan één native DLL-mod gebruiken?

Ja. Installeer elke mod in een eigen map direct onder mods/ en behoud de bestanden en submappen die de auteur heeft meegeleverd. Een passend profiel kan de juiste DLL al selecteren. Open voor een mod zonder passend profiel Adjust DLL selection in DLL Manager. Selecteer alleen de DLL's die de auteur als invoerbestanden heeft genoemd. Kies het laad doel en bevestig dat je de DLL vertrouwt. Gebruik Normal DLL voor gewone native bibliotheken. Kies DirectInput proxy alleen voor een DLL die DirectInput moet leveren en DirectInput8Create exporteert. Klik op Apply selection en start de game opnieuw. Alleen detectie laadt geen DLL zonder profiel. Daarvoor is een bevestigde selectie in DLL Manager nodig, een vermelding in native-plugin.ini of dinput8-chain.ini, of registratie door de bijbehorende Lua-mod.

Wat doe ik met een gedownloade mod?

No DLL included: Installeer de mod zoals gewoonlijk. Mods voor ShroudForge of EML hebben geen extra native DLL nodig.
DLL included: Plaats de mod-DLL in de map van de mod, zoals hieronder getoond. De DLL verschijnt dan in DLL Manager. Bij een bekend profiel is de selectie al voorbereid. Selecteer en bevestig de DLL daar anders zelf.
Other mod files included: Behoud de volledige modmap. Verwijder geen bestanden zoals mod.json, native-plugin.ini of configuratiebestanden.

Als een mod meerdere DLL-bestanden bevat

Veel modmappen bevatten DLL's die alleen hulpbestanden zijn. Selecteer alleen de DLL's die volgens het modprofiel of de instructies van de auteur moeten worden geladen. Met de knoppen omhoog en omlaag stel je de volgorde in van geselecteerde DLL's binnen die modmap. Ze bepalen geen algemene handmatige volgorde voor gewone DLL's in afzonderlijke modmappen.

Een mod-DLL installeren

Als het ShroudForge-installatieprogramma het gedownloade modpakket herkent, installeer je het daar. Maak voor een handmatige installatie voor elke mod een eigen map direct onder mods/ en plaats de DLL van de mod daarin. Staat de DLL in het archief naast de modmap, plaats deze dan bij de mod. Behoud de oorspronkelijke bestandsnaam en de submappen van het pakket.

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

Een DLL wordt niet geladen alleen omdat deze in de map staat. Selecteer deze in DLL Manager zoals hierboven beschreven.

Waarom kan het modbestand ook dinput8.dll heten?

Het eigen opstartbestand van ShroudForge is dinput8.dll in de gamemap. Het modbestand staat apart op mods/<mod-folder>/dinput8.dll. ShroudForge laadt het vanaf dat volledige pad. Met een passend profiel of een selectie in DLL Manager stuurt ShroudForge DirectInput-aanroepen door. Beide bestanden mogen dezelfde naam hebben. Hernoem het modbestand niet en plaats het niet in de gamemap. Vervang daar het opstartbestand van ShroudForge niet.

Profielen begrijpen

Een profiel is een voorbereide instelling voor een bekende mod. Het vertelt ShroudForge welke bestanden en hoe deze moeten worden geladen. ShroudForge koppelt het profiel aan de mod-ID in mod.json of, als die ontbreekt, aan de mapnaam. Je kunt ook een profiel kiezen in DLL Manager. Profielen wijzigen geen modbestanden. Een opgeslagen aangepaste DLL-selectie vervangt de bestandsselectie van het profiel.

Bestaande DirectInput-keten

Een bestaand bestand dinput8-chain.ini in de gamemap gebruikt het vastgestelde formaat:

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

Vermeldingen moeten verwijzen naar bestanden in directe modpakketten, zoals mods/<mod-folder>/. DLL's in de gamemap en paden buiten die pakketten worden geweigerd. De volgorde heeft voorrang op automatisch afgeleide declaraties. Dit bestand bepaalt de volgorde van de DirectInput-providerketen, niet van gewone DLL's in verschillende modmappen. Hetzelfde gevonden bestandspad wordt maar één keer geladen. De eerste geldige DLL met een eigen export van DirectInput8Create ontvangt doorgestuurde aanroepen. Latere DirectInput-proxy-DLL's kunnen nog steeds worden geladen, maar hun DirectInput-exports zijn niet actief in de keten. Ga er niet van uit dat meerdere proxy's samenwerken. Eigen opstartbestanden worden overgeslagen en bij recursief doorsturen wordt de oorspronkelijke Windows-bibliotheek gebruikt.

Schakelaars, doelproces en opnieuw starten

De hoofdschakelaar regelt alle native DLL-lading door ShroudForge, inclusief INI-, profiel-, keten- en Lua-registratie. Een uitgeschakelde selectie voorkomt automatisch laden voor die map. Client, server of beide bepaalt het doelproces. Uitsluitingen op bestandsnaam worden vlak voor het laden toegepast. Ze leiden de functie van een mod niet af uit de naam.

Geladen DLL's blijven in het geheugen totdat het proces eindigt. Daarom moet je de game opnieuw starten om ze uit te schakelen, de volgorde te wijzigen of een ander profiel te kiezen. Een dubbele vermelding van hetzelfde bestand maakt geen tweede exemplaar.

Er verschijnt een laadfout

Controleer de modnaam, het bestandspad en de gemelde oorzaak. Windows-fout 126 kan betekenen dat het hoofdbestand of een vereiste bibliotheek ontbreekt. Als de DirectInput-export ontbreekt, controleer dan het geselecteerde bestand en de laadmodus. 'Loaded' bevestigt het laden, niet dat elke functie van de mod werkt.

Een onbekend native-pluginformaat, een Vulkan-laag, een extra volledige loader of een extern programma vereist de bedoelde integratie. Alleen een bibliotheek laden vervangt die interface niet.

Pakketten installeren

Het installatieprogramma vindt ook één modpakket in geneste archiefmappen. Bekende profielen nemen expliciet benoemde bijbehorende bestanden mee. Een nieuw archief met meerdere modpakketten wordt niet automatisch als groep geïnstalleerd. Pak het uit en installeer één modmap tegelijk. Normaal runtimegebruik opent geen archieven en start geen externe programma's.