Admin: tools/wiki/push.py

2026-11-06T01:16:44Z

tools/wiki/push.py

New page

D2R-XL 2012 is a mod for your own copy of '''Diablo II: Resurrected'''. It goes into a mod folder of your D2R install and runs through [[D2RLoader]]. Your normal D2R game and characters are not changed.

== Requirements ==
{| class="wikitable"
! What !! Version !! Notes
|-
| Diablo II: Resurrected || 3.3 || Battle.net or Steam install, on Windows. On another version the mod's engine plugin switches itself off and says so at the top of the screen.
|-
| [[D2RLoader]] || 1.3.1 || From [https://d2rloader.net/ d2rloader.net]. The D2R-XL 2012 Downloader can install it for you.
|-
| Reign of the Warlock || optional || With the expansion on your Battle.net account you can also play the Warlock, and the stash gets its Gems, Materials and Runes pages.
|}

D2R-XL 2012 is an '''alpha''': playable, but expect bugs. Known issues are listed in each release's notes.

== Install with the Downloader ==
The '''D2R-XL 2012 Downloader''' (<code>D2R-XL-2012-Downloader.exe</code>) is the supported way to install and update the mod. Mod managers are not supported.

# Start the Downloader. It finds your D2R folder (Battle.net or Steam); if it does not, choose the folder that holds <code>D2R.exe</code> under '''D2R folder'''.
# If D2RLoader is missing or another version, press '''Install D2RLoader'''. The Downloader asks first, downloads D2RLoader from its official site, checks it against the version the release names and puts it into your D2R folder. Your D2RLoader settings are kept. If that fails, '''Get D2RLoader''' opens the download page.
# Press '''Install'''. The mod goes into <code><D2R folder>\mods\mxl2012</code> and nowhere else.
# Press '''Play'''. It starts <code>D2RLoader.exe -mod mxl2012</code>, so D2R-XL 2012 starts whatever D2RLoader's Default Mod is. The line under the panel says why Play is off, if it is (for example an update is waiting, or the game is already running).

Install, Update and Repair refuse while the game runs from that D2R folder. The Downloader never asks for administrator rights; if it cannot write to the folder, it says how to grant access.

The very first start of a new D2RLoader (or 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.

== Starting without the Downloader ==
Start <code>D2RLoader.exe</code> in your D2R folder, click the gear on the character screen, set Default Mod to D2R-XL 2012, Apply, and start D2RLoader again. From then on <code>D2RLoader.exe</code> starts the mod. The Downloader's '''Default mod''' action does the same after asking.

== Updating ==
* '''Update''' in the Downloader fetches only the files that changed. '''Repair''' checks every file and replaces damaged or missing ones.
* Before every install, update and repair the Downloader copies your characters and shared stashes into <code>save-copies</code> in its data folder (<code>%LOCALAPPDATA%\mxl2012</code>). The 10 newest copies are kept.
* Your own changes to the mod's settings files (<code>d2rloader.toml</code>, <code>legacy169.toml</code>, <code>buff-panel.toml</code>) are kept. A few keys the mod needs are set again on every update; see [[D2RLoader]].
* Do not go back to 0.1.11 or older after putting Median runes or gems in the Reign of the Warlock Runes and Gems pages: older versions delete those stacks.

== Manual install ==
Each release also comes as a <code>.7z</code> archive for players without the Downloader:

# Unpack <code>D2R-XL-2012-''version''.7z</code> into <code><D2R folder>\mods\</code> (Windows 11 opens .7z files; otherwise use [https://www.7-zip.org 7-Zip]). <code><D2R folder>\mods\mxl2012\mxl2012.mpq\modinfo.json</code> must exist.
# Set D2R-XL 2012 as D2RLoader's Default Mod (above). <code>-txt</code> is not needed.
# To update by hand: delete <code>mods\mxl2012\mxl2012.mpq\data</code> and unpack the new release over the folder. Keep your own <code>mods\mxl2012\d2rloader\config\d2rloader.toml</code> if you edited it.

Install D2R-XL 2012 into its own folder only. Do not copy another mod's <code>d2rloader</code> files over it: the mod's plugin then does not load.

== Where things go ==
{| class="wikitable"
! What !! Where
|-
| The mod || <code><D2R folder>\mods\mxl2012</code>
|-
| Characters and shared stashes || <code>Saved Games\Diablo II Resurrected\mods\mxl2012\</code>
|-
| D2RLoader's own save backups || <code>Saved Games\Diablo II Resurrected\D2RLoader Backups</code>
|-
| The Downloader's settings, log and save copies || <code>%LOCALAPPDATA%\mxl2012</code>
|-
| The game log (send it with a crash report) || <code><D2R folder>\d2rloader\logs\d2rloader.log</code>
|}

Each character has a D2RLoader file (<code>.d2rl</code>) next to its <code>.d2s</code>. Keep the two together, and keep the mod's plugin: a character with items on personal stash page 2 does not load without it.

== Uninstalling ==
'''Uninstall''' in the Downloader removes <code>mods\mxl2012</code> only. Your D2R-XL 2012 characters stay in their save folder; D2R, D2RLoader and other mods are not touched.

== See also ==
* [[Getting started]]
* [[D2RLoader]]
* [[Plugins]]
* [[FAQ]]

[[Category:Guides]]

Installation - Revision history

Admin: tools/wiki/push.py