D2 Survivors Troubleshooting
Normal loading vs problems
D2 Survivors takes a few seconds to load, especially the first time. You will see a loading bar or a brief animation while the game reads files and sets up the renderer. That is normal. If the frame stays completely dark after 10 seconds with no loading indicator, or if you see an error message instead of the game, something stopped D2 Survivors from starting. The most common causes are network blocks, missing Diablo II files, and WebGPU or hardware acceleration issues.
If the D2 Survivors frame on this page is black, try refreshing the page first. The game is served from play.d2survivors.org, so a strict ad blocker or a network filter at work or school can stop the frame from loading at all. Allow play.d2survivors.org in your blocker, or open D2 Survivors in a new tab from the link under the game. If the keyboard does nothing after the game loads, click inside the frame once; the page keeps focus until you do.
'Too many people are playing' server busy
That message means the developer's server that streams hosted files is busy, not that your D2 Survivors install is broken. It usually appears on launch days or when a popular streamer plays the game. The server limit is there to keep costs manageable for a free project, and the message is temporary. Wait a minute and try again, or use the browser version on this fan site while the official server is full; this page keeps a copy of the hosted files so D2 Survivors can start without waiting.
If you keep seeing the busy message even when traffic is low, check your network connection and try opening D2 Survivors in a new tab. A slow or unstable connection can time out while the server is actually available. The long-term way to avoid the busy message is to point D2 Survivors at your own Diablo II or D2R files instead of using hosted files; the download page covers file setup.
File-not-found and Diablo II setup
D2 Survivors file-not-found errors mean the game cannot read your Diablo II folder. Check that you selected the main Diablo II or Diablo II: Resurrected install folder in Options, not a subfolder like d2data or mods. Classic Diablo II must be the 1.14 Lord of Destruction patch, and Diablo II: Resurrected must be a current install. If you are not sure which version you have, check the game's properties or reinstall from Battle.net.
If the folder looks correct but D2 Survivors still reports missing files, reselect the folder in Options and let the game rebuild its file index. The browser version of D2 Survivors stores the file list in browser storage, and clearing that storage or switching browsers can lose the index. The desktop app keeps its own file cache, so switching between the browser and the app means reselecting the folder in each one. Thehow-to-play page has more detail on Diablo II file setup.
Black screen and WebGPU errors
A black screen in D2 Survivors usually means either the frame did not load at all or WebGPU failed to start. If the browser version frame on this page is black, check your ad blocker or network filter first; play.d2survivors.org must be allowed for the frame to load. If the desktop app is black or you see a WebGPU error in the console, the renderer could not initialize, which often means hardware acceleration is off or your graphics drivers are out of date.
D2 Survivors uses WebGPU, a modern rendering API that needs hardware acceleration turned on. In Chrome and Edge, go to Settings > System and make sure 'Use hardware acceleration when available' is checked. Restart the browser after changing the setting. On Windows, also check your graphics control panel (NVIDIA Control Panel for NVIDIA cards, AMD Software for AMD cards) and make sure the browser is set to use the dedicated GPU, not the integrated one. Update your graphics drivers if they are more than a year old; older drivers can block WebGPU even with hardware acceleration on.
Linux-specific WebGPU and browser flags
The D2 Survivors browser version works on Linux, and there is no Linux desktop app yet. Use Chrome, Edge or another Chromium-based browser that supports WebGPU. If you see a WebGPU error or the game reports 'WebGPU not supported,' try launching Chrome or Edge with the flag--enable-features=Vulkan or--use-vulkan. WebGPU on Linux often depends on Vulkan support, so make sure your GPU drivers are current and Vulkan works outside the browser.
You can point the browser build at a Diablo II or D2R install through Wine, or at a native Linux install if you have one. The file picker should see the folder either way; if it does not, check folder permissions. D2 Survivors reads the files on your computer and keeps what it needs in browser storage, so no files are uploaded, and you can play offline after the initial file read.
Keyboard not working
If the keyboard does nothing in D2 Survivors, the game frame does not have focus. Click inside the game once, then try WASD or the arrow keys again. The page around D2 Survivors keeps focus until you click the frame, so keyboard input goes to the page instead of the game. This is normal browser behavior, not a bug. Once you click inside the game, the keyboard will work for the rest of the run.
If the keyboard still does not respond after clicking inside the frame, check that nothing else on the page is intercepting keys. Some browser extensions or accessibility tools grab keyboard input globally. Try opening D2 Survivors in a new tab without other extensions running, or use the desktop app instead, which does not share focus with a browser page.
When to use the Windows or Mac desktop app
The D2 Survivors desktop app works the same as the browser version, but it runs in its own window, works offline and stays up to date automatically. Use the app if you play D2 Survivors regularly, if your work or school network blocks the browser version, or if you want to avoid ad blockers and browser extensions that can interfere with the frame. The app is available for Windows and for Mac with Apple silicon; there is no Linux app yet, so Linux users should use the browser version.
Both the browser version and the desktop app read your Diablo II files on your computer and keep what they need in local storage. Saves stay in the browser or the app, and Options has a Transfer Save tool for moving a save between the two. The download page has the installers and file-setup instructions for both versions.
D2 Survivors Troubleshooting FAQ
Why won't D2 Survivors load on this page?
D2 Survivors is served from play.d2survivors.org, so an ad blocker, a school or work network filter, or a slow connection can keep the frame blank. Refresh the page, allow the frame in your blocker settings, or open D2 Survivors in a new tab from the link under the game. If the frame loads but the keyboard does nothing, click inside the game once so input goes to D2 Survivors instead of the page.
What does 'Too many people are playing' mean in D2 Survivors?
That message means the developer's server is busy, not that your install is broken. It usually appears on launch days or when a large streamer plays D2 Survivors. Wait a minute and try again, or use the browser version on this fan site, which keeps a copy of the hosted files.
How do I fix D2 Survivors file-not-found errors?
D2 Survivors file errors mean the game cannot read your Diablo II folder. Check that you selected the Diablo II or Diablo II: Resurrected install folder, not a subfolder. Classic Diablo II must be the 1.14 Lord of Destruction patch, and D2R must be a current install. If the error persists, reselect the folder in Options and let D2 Survivors rebuild the file index.
What causes a black screen in D2 Survivors?
A black screen in D2 Survivors usually means the frame did not load or WebGPU failed. If the browser version frame is black, check your ad blocker or network filter. If the desktop app is black, try enabling hardware acceleration in your graphics control panel, update your graphics drivers, or switch to the browser version instead.
What is the difference between 'loading' and 'not working' in D2 Survivors?
Normal D2 Survivors loading takes a few seconds while the game reads files, and you see a loading bar or animation. If the frame stays completely dark after 10 seconds, the game did not load at all; that is a network or blocker issue. If the frame shows the D2 Survivors menu or a loading message and then stops, the game loaded but hit a different problem, like missing files or a WebGPU error.
Does D2 Survivors work on Linux?
The D2 Survivors browser version works on Linux. There is no Linux desktop app yet, but you can play D2 Survivors in any Linux desktop browser that supports WebGPU, such as Chrome or Edge. Point the browser build at your Diablo II or D2R install through Wine or a native install, and the game will read the files. If you see a WebGPU error on Linux, check the next question for flags.
Why does D2 Survivors say my keyboard does not work?
If the keyboard does nothing in D2 Survivors, the game frame does not have focus. Click inside the game once, then try the keys again. The page around D2 Survivors keeps focus until you click the frame, so WASD and the other keys go to the page instead of the game. This is normal browser behavior, not a D2 Survivors bug.
How do I enable hardware acceleration for D2 Survivors?
D2 Survivors uses WebGPU, which needs hardware acceleration turned on. In Chrome and Edge, go to Settings > System and make sure 'Use hardware acceleration when available' is checked. On Windows, also check your graphics control panel (NVIDIA Control Panel or AMD Software) and make sure the browser is set to use the dedicated GPU. Restart the browser after changing the setting.
