D2RLoader
More actions
D2RLoader is a mod loader for Diablo II: Resurrected, made by its own project (d2rloader.net), not by the D2R-XL 2012 team. D2R-XL 2012 needs it: the mod's data loads as a D2RLoader mod, and the engine parts Median XL 2012 needs and D2R lacks are a D2RLoader plugin.
Which version
D2R-XL 2012 needs D2RLoader 1.3.1 in your D2R folder. The D2R-XL 2012 Downloader shows a warning when it is missing or another version and offers Install D2RLoader: it asks first, downloads D2RLoader only from d2rloader.net, checks the file against the version the release names and keeps your existing D2RLoader settings. You can also install it by hand from the download page. D2R-XL 2012 does not ship D2RLoader itself.
Starting the mod
- The Downloader's Play button starts
D2RLoader.exe -mod mxl2012. A-modon the command line wins over D2RLoader's Default Mod, so Play always starts D2R-XL 2012. - Starting
D2RLoader.exeyourself starts its Default Mod. Set it with the gear on the character screen: Default Mod D2R-XL 2012, Apply, then start D2RLoader again. - The first start of a new D2RLoader, and the first start after a D2R or D2RLoader update, builds D2RLoader's cache; the mod then asks you to close the game and start it again.
Settings the mod needs
The mod has its own D2RLoader settings file, mods\mxl2012\d2rloader\config\d2rloader.toml. Your copy is kept on updates, but the Downloader sets these keys again on every install, update and repair (only these lines change):
| Key | Value | Why |
|---|---|---|
[d2rcore.save_format] mode |
"extended" |
Median XL items have stats that D2R's normal save format cannot hold; without it saving fails. The mod also checks this at start, adds it if missing and asks for one restart. |
[d2rcore.stash] add_shared_tabs |
at least 2 |
Two more shared stash pages (5 in classic and expansion games, 7 in Reign of the Warlock games). A higher number you set is kept. |
[d2rcore.items] item_stat_ranges |
false |
D2RLoader's Ctrl "Possible base rolls" block repeated lines on many D2R-XL 2012 items, so it is off for this mod for now. |
[d2rcore.player] always_enable_rotw_legacy_graphics_keybind |
true |
Lets G switch to the classic graphics in Reign of the Warlock games. |
D2RLoader's game-wide settings (<D2R folder>\d2rloader\config\d2rloader.toml) are never written by the Downloader.
What D2RLoader adds to the mod
- Personal stash page 2: D2RLoader's custom player page. Its items are saved in the character's
.d2rlfile next to the.d2s. A character with items on page 2 does not load without the mod's plugin (D2RLoader stops the load, so nothing is lost). - Extra shared stash pages (the
add_shared_tabssetting above). - Transmute key: bind "Transmute Horadric Cube" under Options > Controls, group D2RLoader (no key by default). It works while the Horadric Cube is open, or a stash page with the cube window.
- Save backups in
Saved Games\Diablo II Resurrected\D2RLoader Backups.
Other plugins
Plugins in the mod's own folder (mods\mxl2012\d2rloader\plugins) load only with D2R-XL 2012; see Plugins. Your own plugins in the game-wide <D2R folder>\d2rloader\plugins load with every mod, D2R-XL 2012 included. If one of them changes the same game code as D2R-XL 2012, D2RLoader turns that one hook of it down, and the mxl2012 console command names the plugin under plugin clashes.
Logs
After a crash or a problem, send <D2R folder>\d2rloader\logs\d2rloader.log with your bug report.