Skip to content

shupershuff/Diablo2RLoader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Overview

Greetings Stranger! I'm not surprised to see your kind here.

This is a free script I made for loading multiple Diablo 2 Resurrected instances (AKA Multiboxing/MultiLaunching etc), but can also be used for a single account. This will help you load up your account(s) quickly from one place without having multiple install directories of the game eating up excessive drive space.
This will also enable you easily switch realms for trades, DClones, rushes etc for one or more accounts from one simple menu.

Oh yeah and you can check DClone status, the Current TZ AND the next TZ from this launcher. Cool aye?

Using this script means you DON'T have to do any of this awful stuff to multibox:

  • Use the worst (but somehow most popular) method of opening the game from the battlenet client each time with multiple game installs taking up heaps of disk space.
  • Set up shortcuts on your desktop for each account with parameters (including storing your password in plain text).
  • Manually use ProcExp to kill the "Check for other instances" handle, or manually running a script for handle.exe to do the same thing.
  • Use Virtual Machines, multiple computers or multiple user accounts (Windows account switching).
  • Run any dodgy executables where you don't know what's actually running.
    • Note that this script uses handle64.exe which is a Microsoft recommended tool.
    • Note that this script also builds an executable called SetText.exe for window renaming, details of which can be seen on StackOverflow. This .exe has been whitelisted by Microsoft.
    • Never take the authors word for it for anything you download. That's why this script is full open source if you want to have a skim through to see what it's doing.

Note that this script DOES NOT alter the game, automate key presses, game joining or add any efficiencies with RAM/VRAM usage. It's simply used to launch the game. If you want to use additional scripts, programs or mods to achieve any of the above (which I would strongly discourage), then that's at your own risk.

This is a labour of love, for a game I love, for what I feel is a pretty good gaming community :)
This Readme is a bit wordy sorry, I've tried to capture all the information that anyone might ever ask for.

I've put several 100's of hours into making this, so if you like it, consider buying me a beer at https://www.buymeacoffee.com/shupershuff or here https://github.com/sponsors/shupershuff.
Cheers!

Script Screenshot:
ScriptMainMenu
What your windows will look like:
GameWindows

But I don't want to use your script you dodgy internet human

Not everyone wants to use a random script or an app and that's understandable.
See guides for alternative multiboxing methods here: https://github.com/shupershuff/D2r-Multiboxing-Without-A-Script

Exactly what does the script do?

Script will allow opening multiple Diablo 2 resurrected instances and will automatically close the 'DiabloII Check For Other Instances' handle.
It will achieve this by importing account details from a CSV that you populate and essentially launches the game the same way you would with a shortcut: by passing account, password and region parameters to D2r.exe.
Note: Plain text passwords entered into the CSV will be converted into a secure string after running. If you don't want to enter plain text passwords EVER then you can leave the PW field in the CSV blank and manually type in when running the script.
Once the game has initialised, the window will be renamed so it's easier to tell which account and region each game is using.
This also helps the script know which games are open to prevent you accidentally opening a game with the same account twice.
Optionally you can also have the game launch using custom settings.json for each account in case you want different graphics/audio/game settings for each account you have.

* This script in no way enhances or changes gameplay. *

Other Features

Open All accounts at once
Time is precious so work smarter not harder by opening all your accounts at once to maximise your free time to actually play the game instead of clicking through menus.
Note that if you've configured your account(s) or a region(s) to launch the game using an Authentication Token instead of parameters, you will need to wait for each game to reach the character selection screen before the next instance can launch.

Batch Open Accounts
Rather than open all accounts, you can open a group of accounts. This feature is designed for you creatures that have several accounts but only want to launch a subset of these, for example only launch the 3 accounts you primarily play from.
image

Launch Each account with specific game settings
These features were made in mind for multiboxing where you may have different screen sizes and want your secondary accounts to have lower graphics settings:
Auto Settings Switcher: If enabled you can essentially have it so all accounts have their own game settings to load from. Game settings are loaded from settings<ID>.json instead of settings.json.
Manual Settings Switcher: Alternatively, if you want to specify which game settings you want to load from, you can choose the settings file each account should use when launching. Once enabled in config, this can be toggled on and off using 's' in the menu.
image
You can enable both of these features at the same time. See Setup Steps below.

Statistics - Track your playtime
It was too technically difficult for Blizzard to track time played for D2r within their Battlenet Client so you can use my janky one instead.
Time per account can be seen from the main menu. Total time the script has ran for with D2r running can be seen by going into the info screen ('i'). Now you can look back on your D2r playtime and think back on all of the productive things you should've done, but didn't.

Other misc stats and info can be seen on the info screen. Statistics are recorded locally to stats.csv and accounts.csv in your script folder.
image

Terror Zone Details
You can also check the current and next Terror Zone by pressing 't'.
image
Data courtesy of d2emu.com

Check DClone Status
You can also manually check the current DClone status by pressing 'd'.
image
Data courtesy of d2emu.com, d2runewizard.com and diablo2.io. That's right, you can choose your source!

Alarms for DClone Walk status changes
If configured, you can select which regions and modes to monitor for D Clone (Ăśber Diablo) walk status changes.
If there's a change in status whilst the script is running, it will activate the alarm function.
The alarm will a text warning (as seen in example below) as well as a text to speech alarm notifying you where the walk is happening.
The voice alarm activates only once but the text warnings will remain in place for 5 minutes.
You will also be notified after the script has launched if there's any imminent walks about to happen (ie status is 5/6).
See the DClone Status Alarms and config sections for more information and how to configure this.
image
Voice Examples (make sure to unmute, GitHub mutes by default):

DClone.Status.example.Woman.mp4
DClone.Status.example.Man.mp4

Be an Entertainer in Baals Comedy Club
If you're an A grade leecher like me and typically stand around in Baals Throne room sapping up XP, why not at least pretend you have a sense of humour by using the built in joke generator to copy & paste mediocre jokes.
That way instead of providing any real value in terms of damage, you can provide entertainment value instead.
image
Jokes courtesy of v2.jokeapi.dev and official-joke-api.appspot.com

Launch Parameters
You can run the script using launch parameters instead.
This is ideal if you want to create a desktop shortcut to open a set of accounts, or if you're a super nerd and you want to launch the accounts from a scheduled task or from Home Assistant so that your game is ready to go when you get home from work :)
Available launch parameters and values to use are as per the table below:

          Parameter            value example(s) Purpose Notes
-account username@emailaddress.com Specify Signin Address to pass through to the script -AccountUsername also works as a parameter. Can't be used with -all or -batch
-pw YourBNetAccountPassword Specify Password to pass through to the script Can't be used with -all or -batch
-region na.actual.battle.net
1/2/3
NA/EU/AS/KR
Used to specify the connection region Specify either the full server name, use the realm initials (NA/EU/AS/KR) or use 1, 2 or 3 as values to select NA, EU or KR
-all True Opens all accounts Recommend using -region with this parameter.
-batch 1 Opens a batch of accounts at once Recommend using -region with this parameter
-manualsettingswitcher True Use this if you want to manually choose which settings file to load with each account. Recommend not using this but instead enabling SettingSwitcherEnabled in your config file so that it automatically loads from settings<ID>.json

To make a shortcut to open a set of accounts, copy the D2RLoader Shortcut, rename it to whatever suits, open the properties and add parameters to the target eg -batch 1 -region na

Magic Find in the script
You might also notice the quotes sometimes change colour, each time you refresh the script you have a chance to roll for Normal, Magic, Rare, Set, Unique quality quotes. There's also a 1 in 19,999 chance to land a High Rune but you'll never see this :)
image
There are ways to improve your script MaGic Find...

Setup Steps

Please see the detailed setup steps below, it's not as scary as it looks. I've included details for all of the features you may or may not want to use. A basic setup only takes 2 or 3 minutes. TL;DR steps are:

  1. Download the latest release, extract and unblock it within file properties. See 1. Download.
  2. Download handle viewer and place in the folder. See 2. Setup Handle Viewer.
  3. Add account info to accounts.csv. See 3. Setup Your Accounts.
  4. Edit config.xml to set game path and enable/configure desired features. See 4. Script Config.
  5. Run script for first time. See 5. Run the script manually for the first time.
  6. Optionally perform steps to configure game settings that each account should load from. See 6. Auto Settings Switcher and 7. Manual Settings Switcher.

If you have any issues I can almost guarantee it's covered in the detailed setup steps below or FAQ section.

1. Download

  1. Download the latest release this and extract the zip file to a folder of your choosing.
  2. Right click on D2loader.ps1 and open properties.
  3. Check the "Unblock" box and click apply.
    image

2. Setup Handle viewer

  1. Download handle viewer from https://learn.microsoft.com/en-gb/sysinternals/downloads/handle
  2. Extract the executable files (specifically handle64.exe) to the .\Handle\ folder

3. Setup Your Accounts

NOTE: If you have MFA configured on one account it will not work with Parameter based authentication. This to work due to Blizzard not implementing MFA capability with this authentication method. If you want to keep MFA enabled, you can utilise the AuthToken method outlinned below.

  1. Open Accounts.csv in a text editor (eg notepad), excel or your preferred editor.
  2. Add number for each account starting from 1
    • Note, if you're crazy and have more than 9 accounts, you'll need to start adding letters instead of numbers. Letters cannot be the same as existing menu options. Characters a, b, c, g, r, t, d, j, s, i and x are all reserved.
  3. Add your account sign in address.
  4. Add your account password. This will be converted to an encrypted string after first run. If left empty, you will be prompted to enter it when running script and the encrypted password string will be added to the csv.
    • If you're using a text editor to edit the CSV AND your password has a comma in it, ensure your password is surrounded by quotes eg "fjl3Ng2<,03h%mn"
  5. Add a 'friendly' name for each account, this will appear in your diablo window. You can put anything here, I just added my Bnet usernames.
  6. If you have several accounts and want to use the batch feature, ensure you add the number(s) into the batch column.
    • Note if editing the CSV using a text editor, ensure that if you're adding multiple batch options for an account that these are surrounded by quotes eg "1,2,4".
    • Don't forget to enable the Batch feature in the config file.
  7. If you have any custom launch (AKA Command Line) arguments you want to set, add these under the 'CustomLaunchArguments' column for each account you want these to apply too.
  8. Leave the PWIsSecureString and TimeActive columns blank. These will be auto filled in.
  9. OPTIONAL, if you want to be able to use Token based authentication (eg if you have MFA enabled on your account or a one of Blizzards Auth servers are down and you can't connect), you will need to populate the 'Token' column. To do this, open your preferred internet browser in private mode and browse to this website https://us.battle.net/login/en/?externalChallenge=login&app=OSI a. Log in with your credentials and approve MFA request (if enabled).
    b. You will be brought to an error page (this is expected). Copy the URL from the error page into the 'token' column of accounts.csv.
    DO NOT SHARE THIS TOKEN INFORMATION ONLINE.
    image
    c. If you want the account to launch with token based authentication by default, change 'Parameter' to 'token' in the 'AuthenticationMethod' column. You can alternatively leave as 'Parameter' and toggle in the script (from the info menu) if you want to temporarily force Token based auth. This is good for when you generally want to use parameters for authentication but need to temporarily use AuthTokens to switch to another server such as Asia when the Blizzard haven't fixed authentication issues. Generally speaking you will have the best experience launching with parameters. You can toggle the script to temporarily use auth tokens instead of parameters from the info menu.
    d. Close the browser, reopen in private mode, log into each of your other accounts and repeat the steps A to C above.
    e. The token will be converted to an encrypted string when script is next run.
    f. You will need to redo this step if you add/remove MFA to your account.

Make sure to save it and close the file :)

Account CSV BEFORE running script:
image
What it will look like AFTER running the script (in a later step):
image
image

4. Script Config (Mostly Optional)

Default settings within config.xml should be ok but can be optionally changed. Recommend checking out the features here. Open the .xml file in a text editor such as notepad, Powershell ISE, Notepad++ etc.

  • Most importantly, if you have a game path that's not the default ("C:\Program Files (x86)\Diablo II Resurrected"), then you'll need to edit this to wherever you chose to install the game.

All other config options below this are strictly optional:

  • Set 'DefaultRegion' to your preferred default region if you just want to mash enter instead of choosing the region. Default is 1 for NA.
  • Set 'EnableBatchFeature' to True if you want the ability to launch accounts in batches. You must also define the batches in your accounts.csv file. Disabled by default.
  • Set 'DisableOpenAllAccountsOption' to True if you want to disable the ability of opening all accounts at once. Recommend leaving this to False. Disabled by default.
  • Set 'CheckForNextTZ' to True if you want to enable the web request to find NextTZ details. Enabled by default.
  • Set 'AskForRegionOnceOnly' to True if you only want to choose the region once. Disabled by default.
  • Set 'CreateDesktopShortcut' to False if you don't want a handy dandy shortcut on your desktop. Enabled by default.
  • Set 'ShortcutCustomIconPath' to the location of a custom icon file if you want the desktop icon to be something else (eg the old D2LOD logo). Uses D2r logo by default.
  • Set 'ConvertPlainTextPasswords' to False if you want your passwords to be stolen in plain text. This will not convert already encrypted passwords back to plain text.
  • Set 'ForceWindowedMode' to True if you want to force windowed mode each time. This causes issues with Diablo remembering resolution settings, so I recommend leaving this as False and manually setting your game to windowed in your game settings. Disabled by default.
  • Set 'SettingSwitcherEnabled' to True if you want your Diablo accounts to load different settings. This essentially changes settings.json each time you launch a game. See the Auto Setting Switcher section below for more info. Disabled by default.
  • Set 'ManualSettingSwitcherEnabled' to True if you want the ability to be able to choose a settings profile to load from. Once enabled, this is toggleable from the script using 's'. See the Manual Setting Switcher section below for more info. Disabled by default.
  • Set 'TrackAccountUseTime' to False if you don't want accounts.csv or stats.csv to be autoupdated with playtime. Other Stats are still tracked in stats.csv. Mainly added this option in the unlikely case there are any issues with accounts.csv getting corrupted. Enabled by default.
  • Set 'DCloneTrackerSource' to one of the options noted in the config file. Default (and recommended) is d2emu.com as it provides realtime data (not crowdsourced).
  • Set 'DCloneAlarmList' to any number of the options noted in the config file to enable DClone Status alarms for your preferred GameModes and regions. See the DClone Status Alarms section below for more info. Blank by default.
  • Set 'DCloneAlarmLevel' depending on the DClone statuses changes you want to be alarmed on (if alarms are enabled). 'Imminent' notifies only on 1,5,6. 'Close' notifies on status changes to 1,4,5,6. 'All' notifies for...all status changes. All by default.
  • Set 'DCloneAlarmVoice' to the preferred Text to Speech Robot voice. Choices are 'Amazon' or 'Paladin'. Amazon by Default.
  • Set 'ForceAuthTokenForRegion' to enforce AuthToken based authentication for one or more regions. Useful if an Auth server goes down preventing parameter based connections (remember when Asia stopped working for several weeks?) Valid options are NA, EU and KR. Multiple values should be comma separated. Recommend leaving blank unless there are auth issues.

Done editing? What are your thoughts on saving the file? I've heard it helps. CTRL + S for the win :)

5. Run the script manually for the first time

  1. Browse to the folder, right click on D2Loader.ps1 and choose run.
  2. If you get prompted to change the execution policy so you can run the script, type y and press enter. image
    a) If you instead get a message about "D2Loader.ps1 cannot be loaded because running scripts is disabled on this system" then you will need to perform the following steps:
    b) Open the start menu and type in powershell. Open PowerShell.
    c) Enter the following command: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
    d) Type in y and press enter to confirm.
    e) Run the D2Loader.ps1 script again.
  3. If the script prompts to trust it and add it to the unblock list, type in y and press enter to confirm.
  4. This will perform the first time setup for compiling settext.exe, encrypting your passwords and will create a shortcut on your desktop.

If you've skipped ahead, the script will error out and tell you which of the previous setup steps you've skipped.

6. Auto Settings Switcher (Optional but recommended)

Do you want your primary account to launch with decent graphics settings with your other accounts to be set to poo tier settings? This is for you! This feature is disabled by default, as it will cause confusing behaviour for users who haven't read and understood this first.

What this feature does is create copies Settings.json (found in the "C:\Users\<yourusername>\Saved Games\Diablo II Resurrected" folder) for each account you have.
E.G if you have 3 accounts, you will have Settings1.json, Settings2.json & Settings3.json. When the script runs and you choose account 1, it copies Settings1.json to Settings.json causing the game to essentially load off those settings. This essentially turns Settings.json into a temporary file that's just used at load time.
NOTE: Any changes you make to non-character options in game (eg graphics, audio, game options) will be saved to Settings.json, which will be overwritten the next time you launch a game via this loader. Therefore if you want to edit your game settings for say your 2nd account, you would need to open diablo (on any account), make the options changes you'd like to see that account have each time, close the game and then copy Settings.json to Settings2.json.

Quick Guide to updating Game settings for a particular account with this auto switcher.
For these instructions, let's assume we're trying to edit the config for account 1

  1. Set 'SettingSwitcherEnabled' to True in your config file.
  2. Launch the Game (via the Loader or via Bnet client, doesn't matter, the account you log into doesn't matter either).
  3. Make the required graphics/audio/game changes via the menu.
  4. Close the game.
  5. Browse to "C:\Users\<yourusername>\Saved Games\Diablo II Resurrected"
  6. If there's already a file called Settings1.json, delete it (1 being the account ID in accounts.csv).
  7. Copy the Settings.json file and paste into the same folder.
  8. Rename to Settings1.json
  9. Launch the game and proceed find all of the high runes. All of them.

7. Manual Settings Switcher (Optional)

Do you want to manually choose which settings to use when launching the game? This is for you! This feature is disabled by default, as this needs to be setup first and understood this first.

Setup is exactly the same as the Auto Settings Switcher, except for step 8 as you need to name the settings file settings.name.json where name is whatever you want it called (eg settings.1440pHigh.json or settings.PotatoGraphics.json)

  • Note: If you name the file settings_name_.json it will not work. The name should be inside two fullstops "."

Don't forget to enable this feature in the config file by setting 'ManualSettingSwitcherEnabled' to True.

8. DClone Status Alarms (Optional)

You can optionally configure the script to advise when DClone walk status changes.
This is very handy for when you're playing on another region/game mode or playing another game entirely so you can be audibly warned on status changes without having to manually check a website.
This will display text warnings on screen for 5 minutes since last status change and will also perform a one off voice alarm advising you what region and game mode the status changed on. Checks are performed each time the script refreshes on the main menu (IE, every 30 seconds).
Note that these check run in a background job that can take 1-2 seconds to complete, so manually refreshing the menu constantly (r) will prevent checks from occuring.

This feature is disabled by default.
If you want to enable it, simply add in the option(s) you want into DcloneAlarmList in config.xml.
You will only be alarmed for the game options you add into config. EG if you only want Hardcore Ladder notifications you would enter: HCL-NA, HCL-EU, HCL-KR
You can also optionally change the other configs for DClone Tracking and DClone Alarms, however I recommend leaving the default values here.
See the Script Config section for more info on each config.

Notes

Graphics Performance Recommendations

If you don't want your Diablo games to run like a slideshow, here are some tips. You'll of course need to adjust based on your hardware and setup.

  1. IMPORTANT. Set an Frame Rate (FPS) cap in the graphics options. Recommend 60 but adjust depending on your GPU power and instances you're running. This will prevent each instance from trying to fully utilise your GPU compute.
  2. Reduce graphics settings in game to performance over quality.
  3. Run games in Windowed mode. Especially if you have more than one monitor. Not only will it save you performance, it's waaaay easier than alt tabbing.
  4. In addition to changing your settings to launch the game in windowed mode, you should also make your secondary account windows smaller (ie lower resolution) to save on GPU utilisation. You can adjust resolution from the in game menu or simply by shrinking the window. If need you can of course do the opposite and maximise one of the smaller windows if you are playing another character for a bit.
  5. If you are wanting different graphics settings for different accounts (eg different FPS cap, different audio settings, different resolution, nicer graphics settings etc etc), then I would highly recommend making use of the QOL features of this script. The automatic settings switcher can be used so that each account loads with it's own settings at launch. There is also the manual setting switcher feature if you want to define what settings file to load for a given account. See the relevant sections above for more info.
  6. Obviously if you run other graphic demanding things like wallpaper engine in the background, this will hurt your overall FPS. Some wallpapers will have neglible impact but some are noticably impactful on performance.
  7. Make use of hardware monitoring software to see how much you are utilising RAM, CPU, GPU - Processor and GPU - VRAM. If you are under or overutilised you can adjust your settings accordingly for the best experience.

My setup
Note that on my specs (5950x, RTX2080s (which has 8GB VRAM), 32GB RAM), I run my instances on the lowest graphics options possible.
DLSS is set to ultra performance. Framerate (FPS) caps for secondary accounts are around 50fps. For my primary account I set the FPS cap to 60fps.

With 3 instances (2 windows at approx 1280x780 resolution, 1 window (primary account) at 2556x1373 resolution, The CPU is barely used, Memory is about 85% utilised, VRAM is 80% utilised and GPU is about 85-90% (6800MB).
With 4 instances (an additional window at approx 1280x780), CPU is still fine (15%), Memory is maxed out, VRAM is 92%+ (7600MB+) and GPU is 95-100%. Different parts of the game can run pretty poorly and as such sometimes I reduce the secondary accounts FPS Cap to around 44 instead.

I've noted that with my hardware running 4 instances is generally not fun graphically due to performance stutters, FPS drops and increased chance of crashing. I'd argue that running 4 or more accounts is confusing and isn't fun logistically either but I digress.

FAQ / Common Issues

Q: I would like to say "Thankyou". How do I do that?
A: Please pay my entire mortgage. Thanks in advance. Buy me a beer here https://www.buymeacoffee.com/shupershuff.
Or here https://github.com/sponsors/shupershuff.
Or D2JSP funny money.
Or your local animal charity.
Or even just a message to say thanks :)

Q: The script won't let me run it as it gives me security prompts about scripts being disabled or the current script being untrusted :(
A: See Instructions above. The default script policy for Windows 10/11 devices is restricted. We can change this to remote signed. A full write up of the policies can be seen here.

Q: How do I update the script?
A: As of 1.5.0, the script has the ability to update itself. I will also include steps in the script to update config.xml, accounts.csv and stats.csv if new fields are added. For users on older versions, to update manually, all you need to do is download the latest release, extract the .zip and copy the new D2Loader.ps1 over to where the old D2Loader.ps1 file is and overwrite it. If this script shows a warning "Couldn't check for updates. GitHub API limit may have been reached...", it's most likely due to me testing things and exceeding GitHubs API limit, ignore and try again later.

Q: When Diablo opens it won't allow me to select an online character
A1: This will be due to your password or username being entered in incorrectly. Please note that multiple failed authentication requests can cause a temporary lockout from that realm (seems to be around 15-30mins).
A2: In some circumstances, Battlenet can also require a capcha code to be entered to verificaton. If in doubt, try logging in via the battlenet client and see if it prompts for captcha. It might take several hours for this to resolve itself (6 hours observed in issue #17).

Q: I have reset one of my Bnet account passwords, how do I update accounts.csv
A: Open accounts.csv and clearout the password field and the PWIsSecureString field. Leave the PWIsSecureString field blank. Either enter your password into the csv file or leave it blank and the script will ask you next time you run it.

Q: When I run this I'm unable to use Push to Talk (PTT) in Discord.
A: As the script needs to run as administrator, this also means it starts the game with elevated rights. As such this can mess with Discord PTT. This is a known issue with Discord. To resolve this you can run Discord in Administrator mode.
I recommend that you find the Discord Shortcut or app, go into properties > Compatibility and check the box for "Run this program as administrator" so that it always runs as admin. :)

Q: A UAC prompt opens each time asking me to run as Admin. This is annoying. Can I disable this?
A: Yes, there are a couple ways to do this, see here: https://silicophilic.com/add-program-to-uac-exception/#Method_2_Run_Programs_With_Admin_Privileges_Without_UAC_Prompt

Q: Will this work if I've extracted game files with Casc viewer in an attempt to make the game load faster
A: Yes, if you're one of the people that have done this, you can still run the game using this script. Make sure to specify "-direct -txt" as commandline options in accounts.csv

Q: Why does the script need to run as admin?
A: The script needs to run as admin in order to kill the "Check for Other instances" process handle and to be able to rename your D2r windows once launched. The script uses the names of these Windows to detect which accounts are currently active.

Q: I get 2FA/MFA Battlenet prompts on my screen but even though I approve, when the game loads it won't show online characters.
A1: Bad news here sorry, Diablo does not work with MFA enabled when launching the game from a shortcut with parameters. Blame Blizzard, their MFA solution overall isn't great either.
A2: That said, it is possible to connect if you utilise the Auth Token method instead of Parameters. You need to set this up (See Auth Token steps in Setup Your Accounts).

Q: I have suggestions and/or issues with this, where do I post these?
A: Please use GitHub issues for any feedback. Thanks!

Q: If I've read this far through this long ass readme does that mean I can read good?
A: Yes, you read at least up to a Dr Seuss reading level. Well done you!

Q: I get prompts to enter captcha's on my accounts randomly. Why is this?
A: I'm not sure exactly why this happens but it does appear to happen more with newer accounts. Ensure you have logged into the battlenet client AND into your webbrowser with the account and approve any verifications/captchas needed. Do not share the account with other people. Do NOT use a VPN when signing into the account (whether it be via this script, bnet client or website).

Q: Is this Script against ToS?
A: Multiboxing itself is not against Blizzard TOS as per this Blizzard Rep and this Blizzard Article. However the only way of achieving this without additional physical computers or Virtual Machines is by killing the "Check for Other instances" handle.

Outside of killing this handle and changing the window title, there are absolutely no modifications to the game made by this script, it's simply an improved alternative way to start the application. To be clear, this script in no way enhances or assists with actual game play and I would strongly advise against seeking/using any tools. The script is essentially launching the game the same way you would if you had setup shortcuts to the game with account,region,pw parameters, launching that way and then killing the "Check for other instances" handle (as suggested in several guides). This script is a QoL tool to help consolidate your accounts to one simple launcher to simply open the game with account(s) and region(s) you want.

So the real question is, regardless of this script, is using procexp or another method to kill the "check for other instances" handle against ToS? Stricly speaking yes and this topic has been broached in Blizzard forums many times without an official response either for or against. If you're reading this your real question is actually "Will I get banned for multiboxing by killing the 'check for other instances' handle?" which to that I'm confident the answer is no. If I wasn't confident, this script wouldn't exist and people wouldn't be using procexp/handle.exe to multibox through traditional methods. Given the widespread use of procexp/handle being used to multibox, this method (and therefore also this script), is considered safe.

Notes about the Window title rename (SetTextv2.exe)

The script will generate a file called SetTextv2.exe if it doesn't exist. This is used to rename the Game Windows so that you and the script can tell each instance apart. To compile the .exe this requires DotNet4.0. If you don't have it the script will prompt you to download this from Microsoft. A Windows Defender exception will also be automatically added for the directory this sits in, as at the time of writing (24.4.2023), Windows Defender considers it to be dodgy.
A submission has since been sent to Microsoft and submission has been cleared :)
I have since made a new version of SetText so that it can rename Windows based on process ID (instead of looking for any window matching Diablo II) to prevent any issues with folk who launch an instance via Battlenet as well as the script.

If you have a 3rd Party Anti-Virus product installed and it kicks up a fuss, you may need to manually add an exception to the .\SetText\ folder location.

Optional: If you don't trust me and want to build the .exe yourself you can do the following.

  1. Browse to the SetText Folder.
  2. In the Address bar (the part that shows the path of the folder you're in), click in this, clear out anything that's in it, type in cmd and press enter.
  3. This will open the command prompt with it set in the path of where you've saved the script.
  4. Next copy and paste the following into CMD: SET var=%cd% "C:\Windows\Microsoft.NET\Framework\v4.0.30319\vbc.exe" /target:winexe /out:"%var%\SetText.exe" "%var%\SetTextv2.bas" /verbose
  5. This should compile SetText.exe. This is used to give the Diablo windows a unique name once it's initialized.

See this site for more information on what this does, this contains the original version and the updated version that I've made: https://stackoverflow.com/questions/39021975/changing-title-of-an-application-when-launching-from-command-prompt/39033389#39033389

What's Next

If there's something you want to see added or improved then let me know. Future updates may include:

  • Possibly add the ability to mute minimised windows (as long as it can be done within windows without additional software)
  • Investigate Ability to skip intro
  • Fixing anything I broke in the last release.
  • Adding whatever features you fools ask for.
  • Perhaps make a GUI if there's enough interest. Probably not though as there would be a lot of brain activity involved. Pay my mortgage and we'll perhaps maybe talk... probably.

Usage and Limitations

Happy for you to make any modifications this script for your own needs providing:

  • Any variants of this script are never sold.
  • Any variants of this script published online should always be open source.
  • Any variants of this script are never modifed to enable or assist in any game altering or malicious behaviour including (but not limited to): Bannable Mods, Cheats, Exploits, Phishing, Botting.

Credit for things I stole

Github All Releases

Tags for Google SEO (maybe): Multiboxing, Multiboxes, multibox, multi-box, multi-boxing, multi-launcher, boxer, launcher, Shuper, d2loader, d2rloader, script, diabloloader, loader, D2r, Diablo 2: Resurrected, Diablo II: Resurrected, uber, dclone, youtube, DiabloII, powershell, process explorer, procexp, windows, battle.net, warriv, d2r Multi, d2r launcher, d2r loader, d2r multibox, chat Gem workinG as intended