DLL Manager

W Modloaderze otwórz Compatibility → DLL Manager. Poradnik jest widoczny u góry tego panelu. Zawiera listę bibliotek DLL modów znalezionych przez ShroudForge oraz informację, czy zostały załadowane. Znane mody mają przygotowane profile. Inne biblioteki wybierz i zatwierdź w tym miejscu.

Czy mogę używać więcej niż jednego moda z natywną biblioteką DLL?

Tak. Zainstaluj każdy mod we własnym folderze bezpośrednio w mods/ i zachowaj pliki oraz podfoldery dostarczone przez autora. Pasujący profil może już wybierać właściwą bibliotekę DLL. W przypadku moda bez pasującego profilu otwórz Adjust DLL selection w DLL Managerze. Wybierz tylko wejściowe biblioteki DLL wskazane przez autora. Określ cel ładowania i potwierdź, że ufasz tej bibliotece. Dla zwykłych bibliotek natywnych wybierz Normal DLL. Opcję DirectInput proxy wybieraj wyłącznie dla biblioteki przeznaczonej do obsługi DirectInput, która eksportuje DirectInput8Create. Kliknij Apply selection, a następnie uruchom grę ponownie. Samo wykrycie nie ładuje biblioteki DLL bez profilu. Potrzebny jest zatwierdzony wybór w DLL Managerze, wpis w native-plugin.ini lub dinput8-chain.ini albo rejestracja przez powiązany mod Lua.

Co zrobić z pobranym modem?

No DLL included: Zainstaluj mod w zwykły sposób. Mody przeznaczone dla ShroudForge lub EML nie potrzebują dodatkowej natywnej biblioteki DLL.
DLL included: Umieść DLL moda w jego folderze, jak pokazano poniżej. Biblioteka pojawi się wtedy w DLL Managerze. Znany profil ma już przygotowany wybór. W przeciwnym razie wybierz i zatwierdź ją w tym miejscu.
Other mod files included: Zachowaj cały folder moda. Nie usuwaj plików takich jak mod.json, native-plugin.ini ani plików konfiguracyjnych.

Jeśli jeden mod zawiera kilka plików DLL

Wiele folderów modów zawiera biblioteki DLL, które są tylko plikami pomocniczymi. Wybierz wyłącznie te biblioteki, które profil moda lub instrukcje autora wskazują do załadowania. Przyciski w górę i w dół ustalają kolejność wybranych bibliotek w obrębie tego folderu moda. Nie ustawiają globalnej ręcznej kolejności zwykłych bibliotek DLL w osobnych folderach modów.

Instalowanie biblioteki DLL moda

Jeśli instalator ShroudForge rozpoznaje pobrany pakiet moda, zainstaluj go za jego pomocą. Przy instalacji ręcznej utwórz dla każdego moda osobny folder bezpośrednio w mods/ i umieść w nim bibliotekę DLL moda. Jeśli w archiwum DLL znajduje się obok folderu moda, przenieś ją do tego folderu. Zachowaj oryginalną nazwę pliku i podfoldery pakietu.

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

Biblioteka DLL nie zostanie załadowana tylko dlatego, że znajduje się w folderze. Wybierz ją w DLL Managerze zgodnie z powyższym opisem.

Dlaczego plik moda też może nazywać się dinput8.dll?

Własny plik startowy ShroudForge to dinput8.dll w folderze gry. Plik moda znajduje się osobno pod adresem mods/<mod-folder>/dinput8.dll. ShroudForge ładuje go z tej pełnej ścieżki. Przy pasującym profilu lub wyborze w DLL Managerze ShroudForge przekazuje wywołania DirectInput. Oba pliki mogą mieć tę samą nazwę. Nie zmieniaj nazwy pliku moda i nie umieszczaj go w folderze gry. Nie zastępuj tam pliku startowego ShroudForge.

Profile — informacje

Profil to przygotowane ustawienie dla znanego moda. Określa, które pliki i w jaki sposób ma załadować ShroudForge. Dopasowanie wykorzystuje identyfikator moda z mod.json albo nazwę folderu, jeśli identyfikatora brakuje. Profil możesz też wybrać w DLL Managerze. Profile nie zmieniają plików moda. Zapisany niestandardowy wybór DLL zastępuje wybór plików z profilu.

Istniejący łańcuch DirectInput

Istniejący plik dinput8-chain.ini w folderze gry używa ustalonego formatu:

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

Wpisy muszą wskazywać pliki wewnątrz bezpośrednich pakietów modów, takich jak mods/<mod-folder>/. Biblioteki DLL z głównego folderu gry i ścieżki poza tymi pakietami są odrzucane. Ich kolejność ma pierwszeństwo przed deklaracjami wyznaczanymi automatycznie. Ten plik określa kolejność łańcucha dostawców DirectInput, a nie zwykłych bibliotek DLL w różnych folderach modów. Ta sama rozpoznana ścieżka pliku jest ładowana tylko raz. Pierwsza poprawna DLL eksportująca własne DirectInput8Create otrzymuje przekazane wywołania. Kolejne biblioteki proxy DirectInput mogą się załadować, ale ich eksporty DirectInput nie są aktywne w łańcuchu. Nie zakładaj, że wiele proxy będzie działać razem. Własne pliki startowe są pomijane, a rekurencyjne przekazywanie wraca do oryginalnej biblioteki Windows.

Przełączniki, proces docelowy i ponowne uruchomienie

Główny przełącznik steruje całym natywnym ładowaniem wykonywanym przez ShroudForge, w tym wpisami INI, profili, łańcucha i rejestracji Lua. Wyłączony wybór wstrzymuje automatyczne ładowanie dla danego folderu. Opcja client, server lub both określa proces docelowy. Wykluczenia według nazwy pliku są stosowane bezpośrednio przed ładowaniem. Nie określają funkcji moda na podstawie jego nazwy.

Załadowane biblioteki DLL pozostają w pamięci do zakończenia procesu. Ich wyłączenie, zmiana kolejności lub wybór innego profilu wymagają ponownego uruchomienia gry. Podwójne deklaracje jednego pliku nie tworzą kolejnej instancji.

Pojawia się błąd ładowania

Sprawdź nazwę moda, ścieżkę pliku i podaną przyczynę. Błąd Windows 126 może oznaczać brak głównego pliku lub jednej z wymaganych bibliotek. Jeśli brakuje eksportu DirectInput, sprawdź wybrany plik i tryb ładowania. Komunikat „Loaded” potwierdza załadowanie, a nie działanie wszystkich funkcji moda.

Nieznany format natywnej wtyczki, warstwa Vulkan, dodatkowy kompletny loader lub program zewnętrzny wymagają właściwej integracji. Samo załadowanie biblioteki nie zastępuje tego interfejsu.

Instalowanie pakietów

Instalator znajduje również pojedynczy pakiet moda w zagnieżdżonych folderach archiwum. Znane profile dołączają jawnie nazwane pliki towarzyszące. Nowe archiwum z kilkoma pakietami modów nie jest automatycznie instalowane jako grupa. Rozpakuj je i instaluj po jednym folderze moda. Zwykła praca runtime'u nie otwiera archiwów ani nie uruchamia programów zewnętrznych.