https://github.com/sh4nks/d2rloader
Cross-platform Diablo 2 Resurrected Loader written in Python/Qt
https://github.com/sh4nks/d2rloader
bnet d2loader d2r d2rloader diablo2 diablo2-loader diablo2resurrected linux multiboxing python qt steam windows wine
Last synced: about 2 months ago
JSON representation
Cross-platform Diablo 2 Resurrected Loader written in Python/Qt
- Host: GitHub
- URL: https://github.com/sh4nks/d2rloader
- Owner: sh4nks
- License: mit
- Created: 2025-02-07T21:29:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-11T10:11:18.000Z (about 2 months ago)
- Last Synced: 2026-04-11T12:12:04.742Z (about 2 months ago)
- Topics: bnet, d2loader, d2r, d2rloader, diablo2, diablo2-loader, diablo2resurrected, linux, multiboxing, python, qt, steam, windows, wine
- Language: Python
- Homepage:
- Size: 1.25 MB
- Stars: 18
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Diablo 2 Resurrected Loader
This is a simple Qt app which manages starting multiple Diablo 2 Resurrected instances.
Its heavily inspired by shupershuff/Diablo2RLoader - a powerful PowerShell CLI solution for multiboxing D2R with even more features than this loader. Check this repo out if you want to learn more about multiboxing D2R :-)
Running on Linux
Running on Windows
# Getting Started
D2RLoader supports Windows and Linux (via Wine/[UMU-Launcher](https://github.com/Open-Wine-Components/umu-launcher)).
I have only tested my Linux environment (Arch Linux) so far. So, if you find any issues with yours, please report them so I can get them fixed!
The TZ Info and DClone Info require a working API key from [d2emu.com](https://d2emu.com).
All configuration files are stored in ``%APPDATA%/d2rloader`` on Windows or ``$XDG_CONFIG_DIRS/d2rloader`` on Linux
## Linux
- Download the provided [**AppImage**](https://github.com/sh4nks/d2rloader/releases) from the release page and make it executable.
- In case you are using Arch Linux you can use your favorite AUR helper to install [d2rloader](https://aur.archlinux.org/packages/d2rloader) from the AUR.
- Install [UMU-Launcher](https://github.com/Open-Wine-Components/umu-launcher)
- Install D2R from your favorite Game Launcher (Lutris/Bottles, etc)
- Select your prefered WINEPREFIX location otherwise a default one will be set to $XDG_CONFIG_DIRS/d2rloader/wineprefixes.
## Windows
- Download the latest "D2RLoader.windows.zip" from the [releases page](https://github.com/sh4nks/d2rloader/releases) and extract it.
- Create a desktop shortcut and configure it to run as **Administrator**. Admin rights are unfortunately needed to kill the handles.
- Start D2RLoader.exe and configure the handle.exe path and D2R game folder (File -> Settings)
- Create and configure a new account by pressing "Add".
- Start the game with the configured account.
## Auth Methods
You can choose between 2 auth methods. However, the token authentication is more robust and allows one to use MFA.
### Password
Deactivate your Battle.net Authenticator for your account because passing passwords via parameters won't work with Multi-Factor Authentication (MFA).
If you try to login using password authentication and get an error like _"We couldn't verify your account with that information"_, try changing your password and try again. This worked for me at least.
### Token
This method works with Multi-Factor Authentication!
1. Open a browser in private mode
2. Navigate to https://us.battle.net/login/en/?externalChallenge=login&app=OSI
3. Log in to your account
4. You will be redirected to an unknown (localhost) page.
For Chrome-based browsers:
- Your URL will look something like this:
http://localhost:0/?ST=US-c099c810-2b2c-42b6-8bd0-ae6735d54510&flowTrackingId=37f670de-7831-4b32-9cb5-2a219e9eea4a
- Copy the part from ``US-c099c810-2b2c-42b6-8bd0-ae6735d54510&`` and paste it in your Account settings
For Firefox you have to open the console (F12) and go to _Storage_ -> _Cookies_ and copy the **value** from the ``gs.id`` cookie
## Game Performance Improvements
- Skip Intro (``-skiptobnet`` doesn't work anymore...)
https://www.nexusmods.com/diablo2resurrected/mods/194
- TinyMod (replaces HD textures to lower memory usage)
https://github.com/D2R-Gimli/TinyMod
# Plugins
If you are interested in developing a plugin for D2RLoader, take a look at the [Plugin Documentation](./PLUGINS.md)
# Companion Tools
- [d2rinfo](https://github.com/sh4nks/d2rinfo) -> D2Emu API
- [d2rreg](https://github.com/sh4nks/d2rreg) -> Token Authentication for Linux and Window renaming when using Wine Wayland
# License
MIT License