Een gids voor het downloaden en installeren van mods in Risk of Rain 2 op pc, met daarin r2modman, de handmatige methode, en de dependency-stack waar de meeste mensen over struikelen.
Risk of Rain 2 heeft een van de oudste en best georganiseerde moddingscenes op Thunderstore. Het heeft ook een van de diepste dependency-stacks, en het begrijpen van die stack is echt het verschil tussen een werkende installatie en een uur aan verwarring.
Ons uitgewerkte voorbeeld is Starstorm 2, een grote contentmod die survivors, items en vijanden toevoegt. Het is precies een goed voorbeeld omdat het niet eenvoudig is.
Vereisten
- Een pc met Windows 10 of later, of Linux.
- Risk of Rain 2 op Steam of de Epic Games Store.
- Een paar honderd MB vrije ruimte. Contentmods op de schaal van Starstorm 2 zijn groter.
- Een archiveringstool zoals 7-Zip als je handmatig installeert.
Er is geen anti-cheat in Risk of Rain 2 en geen banrisico bij het modden ervan. Mods schakelen in bepaalde configuraties wel Steam-achievements uit, dus houd daar rekening mee als je die nog aan het jagen bent.
De Mod-stack
Risk of Rain 2-mods bouwen voort op twee lagen, en een mod weigert te laden als een van beide ontbreekt of verouderd is. Dit is de moeite waard om te begrijpen, ook als je een modmanager gebruikt die dit voor je afhandelt, omdat het elke foutmelding verklaart die je waarschijnlijk zult zien.
BepInEx
BepInExPack is de mod loader. Het haakt zich bij het opstarten in het spel en laadt plugins uit BepInEx/plugins.
De Risk of Rain 2-pack is geen kale BepInEx. Er zitten verschillende community-patches ingebouwd, waaronder RoR2BepInExPack, FixPluginTypesSerialization en BepInEx_GUI. Die bestaan vanwege eigenaardigheden die specifiek zijn voor dit spel, en daarom wil je deze pack in plaats van de upstream BepInEx.
R2API
R2API is een modding-API die tussen BepInEx en de mods zit. Het geeft modauteurs een stabiele, gedeelde manier om survivors, items, elites, buffs enzovoort toe te voegen zonder dat elke mod dit opnieuw moet uitvinden en botst met elke andere mod.
R2API is enige tijd geleden opgesplitst in submodules, en dit is het deel dat mensen in verwarring brengt. In plaats van één grote R2API.dll zijn er nu afzonderlijke pakketten zoals R2API_Prefab, R2API_Networking en R2API_Difficulty. Een mod hangt alleen af van de submodules die hij daadwerkelijk gebruikt. Starstorm 2 haalt er ongeveer een dozijn binnen.
Deze installeer je bijna nooit handmatig. Laat de modmanager dit doen.
De mod zelf
Met die twee lagen aanwezig, is de mod een .dll in BepInEx/plugins, net als elke andere BepInEx-plugin.
NOTITIE - Versies zijn hier belangrijker dan in de meeste spellen. Een mod gebouwd tegen R2API 5.0.5 laadt mogelijk niet met een oudere R2API. Modmanagers installeren de versies die een mod aangeeft, wat de belangrijkste reden is waarom handmatige installaties in dit spel vaker misgaan dan elders.
Installeren met r2modman
r2modman is de standaardtool voor dit spel en is er oorspronkelijk voor geschreven. Thunderstore Mod Manager is gebouwd op dezelfde codebase en werkt identiek als je die liever gebruikt; Gale is een lichter alternatief dat dit spel ook ondersteunt.
Een profiel instellen
- Download r2modman van de Thunderstore-pagina of van GitHub.
- Start het op en kies Risk of Rain 2.
- Kies de winkel waar je het spel op hebt, Steam of Epic. r2modman vindt de installatiemap van daaruit.
- Je komt op het profielscherm terecht. Maak een nieuw profiel aan in plaats van Default te gebruiken, en noem het naar wat je ermee doet, bijvoorbeeld
starstorm.
Profielen zijn de functie die het waard is om te leren. Elk profiel houdt zijn eigen modlijst, eigen configs en eigen save-gerelateerde status bij, en wisselen tussen profielen gaat direct en downloadt niets opnieuw. Eén profiel per playthrough of per vriendengroep bijhouden is veel minder vervelend dan mods handmatig in- en uitschakelen.
Starstorm 2 installeren
- Klik met je profiel geselecteerd op Online in de linkerzijbalk.
- Zoek naar Starstorm2 en open het resultaat van TeamMoonstorm.
- Klik op Download, en dan op Download with dependencies wanneer daarom gevraagd wordt.
- Laat het lopen. Het haalt BepInExPack, MoonstormSharedUtils en de R2API-submodules binnen die Starstorm 2 nodig heeft, wat een lange lijst is.
- Ga naar Installed en controleer of alles zonder waarschuwingsicoon verschijnt.
Modded opstarten
Klik op Start modded aan de bovenkant van het r2modman-venster.
Start het spel niet vanuit Steam of Epic. Dat start het vanilla op. r2modman werkt door BepInEx bij het opstarten via het profiel te injecteren, dus het opstarten moet via r2modman verlopen om iets ervan toe te passen.
TIP - Als je een Steam-snelkoppeling wilt die modded opstart, kan r2modman de opstartargumenten voor je genereren onder Settings, dan Browse profile folder. De meeste mensen vinden het eenvoudiger om r2modman gewoon open te houden.
Handmatig installeren
Haalbaar, en de moeite waard om te weten, maar echt vermoeiender in dit spel dan in de meeste andere door de situatie met R2API-submodules.
Zoek eerst je spelmap op. In Steam, klik met de rechtermuisknop op Risk of Rain 2, dan Manage en Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\Risk of Rain 2
Dan:
- Download BepInExPack met Manual Download, pak het uit, en kopieer de inhoud van de
BepInExPack-map naar de spelmap. Je moet uiteindelijkBepInEx,doorstop_config.inienwinhttp.dllnaastRisk of Rain 2.exehebben staan. - Start het spel één keer op zodat BepInEx zijn mappen aanmaakt, en sluit het daarna af.
- Download R2API en elke submodule die de mod vermeldt, pak ze uit, en kopieer hun
.dll-bestanden naarBepInEx/plugins. - Download Starstorm 2 en kopieer de inhoud eveneens naar
BepInEx/plugins.
Stap 3 is het lastige gedeelte. Om dit goed te doen moet je de Dependencies-lijst van de mod op Thunderstore doorlezen, elk item ophalen in exact de vermelde versie, en dat herhalen voor alles wat die op hun beurt weer als dependency hebben. Voor Starstorm 2 zijn dat meer dan een dozijn downloads.
WAARSCHUWING - Als je handmatig installeert, meng dan geen versies door elkaar. De nieuwste R2API-submodules pakken terwijl de mod om oudere vraagt, is de meest voorkomende oorzaak dat een mod stilletjes niet laadt.
Installeren Met De TMC App
Er is nog één manager die het vermelden waard is, en dat is de onze. The TMC App biedt one-click mod-installaties, sandboxes (per spel benoemde profielen, elk met een eigen load order en deploymentmethode, wisselbaar zonder iets opnieuw te downloaden), een serverbrowser met live latency-grafieken, en RCON.
Risk of Rain 2 staat nog niet op de lijst van ondersteunde games. We zouden dat graag willen, en het toevoegen van een spel komt neer op vier JSON-bestanden in plaats van code.
Voordat je op zoek gaat, moet je wel weten: de app bevindt zich in een zeer vroeg ontwikkelstadium en zegt dat zelf ook. Het grootste deel is slechts gedeeltelijk getest. Voor een spel met een dependency-graaf zo diep als deze blijft r2modman het gereedschap om op te vertrouwen, en de TMC App is iets om ernaast mee te experimenteren, niet om het te vervangen. Iedereen die bereid is het te proberen en terug te koppelen, doet ons een echte gunst.
Het is open source onder GPL-3.0 op github.com/modcommunity/tmc-app. Issues en feature requests horen thuis in de tracker, pull requests zijn welkom, en de repository legt het per-spel-formaat uit als je zelf ondersteuning voor Risk of Rain 2 wilt toevoegen.
Installeren:
- Linux: één regel, geen root en geen packagemanager nodig.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: de
setup.exeofsetup.msivan de releases-pagina. Er is ook een portable build, al registreert die de launcher-entry of detmc://-linkhandler niet. - macOS: de
.dmgvan dezelfde releases-pagina.
Multiplayer En Mod-synchronisatie
Risk of Rain 2-multiplayer vereist dat elke speler compatibele mods draait. Contentmods die items of survivors toevoegen moeten overeenkomen binnen de lobby, en een mismatch uit zich meestal als een kick bij het joinen of als desynced items tijdens een run.
De praktische oplossing is profielen delen. Open in r2modman je profiel, klik op Export, en kies Export as file of Export as code. Je vrienden gebruiken Import met het bestand of de code en eindigen met een byte-identieke modlijst.
OPMERKING - Puur visuele mods en sommige quality-of-life-mods zijn client-side en hoeven niet overeen te komen. De Thunderstore-pagina van de mod vermeldt dit meestal. Als het niet vermeld wordt, ga er dan van uit dat het wel moet overeenkomen.
Consoles
Risk of Rain 2 staat ook op PlayStation, Xbox en Nintendo Switch, en geen van die versies ondersteunt mods. Alles in deze gids is alleen voor pc. Er is geen workaround, en alles wat beweert de consoleversies te modden, is niets wat je zou moeten downloaden.
Je Mods Beheren
r2modman toont een update-icoon naast elke geïnstalleerde mod die een nieuwere versie op Thunderstore heeft, en Update all regelt ze allemaal tegelijk. Omdat R2API-submodules onafhankelijk van elkaar versienummers hebben, trekt het updaten van één mod soms nieuwere submodules mee, wat een tweede mod kan breken die de oude versies nodig had. Precies hiervoor bestaan profielen: kloon het profiel, update de kloon, en houd het werkende profiel achter de hand tot je zeker bent.
Een mod uitschakelen is een toggle in de Installed-lijst en laat de bestanden op hun plek. Verwijderen haalt ze weg.
Om volledig terug te gaan naar vanilla, verwijder je BepInEx, doorstop_config.ini en winhttp.dll uit de spelmap. Bestanden verifiëren via Steam zal deze niet verwijderen, aangezien Steam geen bestanden bijhoudt die het zelf niet heeft geïnstalleerd.
Probleemoplossing
Modded run, maar geen mods. Je hebt gestart vanuit Steam of Epic in plaats van vanuit r2modman.
Een mod is geïnstalleerd maar laadt nooit. Controleer de BepInEx-console op een regel die de mod noemt. Als de console een ontbrekend type of een ontbrekende methode vermeldt, is dat een versiemismatch met R2API. Herinstalleer de mod met dependencies vanuit de manager.
Het spel hangt op het splashscreen. Meestal een mod gebouwd voor een oudere spelversie. Risk of Rain 2-patches breken regelmatig mods, en de oplossing is doorgaans wachten op de auteur.
Gekickt bij het joinen van een vriend. Modlijsten komen niet overeen. Importeer hun geëxporteerde profiel.
Achievements ontgrendelen niet meer. Verwacht gedrag met bepaalde mods geïnstalleerd. Gebruik een apart vanilla-profiel als je ze wilt blijven verdienen.
Linux en Proton. Stel je Steam-startopties in op WINEDLLOVERRIDES="winhttp=n,b" %command% zodat BepInEx geladen wordt. r2modman regelt dit zelf wanneer je erdoorheen start.
Conclusie
Modden van Risk of Rain 2 lijkt van buitenaf intimiderend vanwege de R2API-submodules, maar in de praktijk maakt een mod manager het geheel tot een handeling van twee klikken. Installeer r2modman, maak een profiel, download met dependencies, en start modded op.
De twee dingen die het echt onthouden waard zijn: start op via de manager in plaats van via Steam, en exporteer je profiel voor iedereen met wie je speelt.
Als je de tijd hebt, is de TMC App open source, vroeg in ontwikkeling, en feedback erover zou oprecht op prijs worden gesteld.
Zie Ook
- Risk of Rain 2 op Thunderstore
- Risk of Rain 2 Modding Discord
- R2Wiki - De community modding wiki, en de beste referentie voor mod-auteurs.
- R2API op GitHub
- TMC App
We proberen deze gids up-to-date te houden, maar het spel, BepInEx en R2API worden allemaal volgens hun eigen schema geüpdatet. Als iets hier niet meer overeenkomt met wat je ziet, laat het ons weten of open een pull request op de GitHub-repository van deze gids.
Join onze Discord-server als je vragen hebt of hulp wilt bij iets modding-gerelateerd!