Installation

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

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 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 (D2R-XL-2012-Downloader.exe) 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 D2R.exe 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 <D2R folder>\mods\mxl2012 and nowhere else.
Press Play. It starts D2RLoader.exe -mod mxl2012, 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 D2RLoader.exe 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 D2RLoader.exe 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 save-copies in its data folder (%LOCALAPPDATA%\mxl2012). The 10 newest copies are kept.
Your own changes to the mod's settings files (d2rloader.toml, legacy169.toml, buff-panel.toml) 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 .7z archive for players without the Downloader:

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

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

Where things go

What	Where
The mod	`<D2R folder>\mods\mxl2012`
Characters and shared stashes	`Saved Games\Diablo II Resurrected\mods\mxl2012\`
D2RLoader's own save backups	`Saved Games\Diablo II Resurrected\D2RLoader Backups`
The Downloader's settings, log and save copies	`%LOCALAPPDATA%\mxl2012`
The game log (send it with a crash report)	`<D2R folder>\d2rloader\logs\d2rloader.log`

Each character has a D2RLoader file (.d2rl) next to its .d2s. 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 mods\mxl2012 only. Your D2R-XL 2012 characters stay in their save folder; D2R, D2RLoader and other mods are not touched.