GFX Troubleshooting

There are numerous gfx related bugs users encountered. Not all are fixable, but might have workarounds. This site is there to collect these to help those encountering the same issues.

1.0 Game not starting Generally there are two different types of users encountering these problems. Users with old computers (2015 and older) and users with new computers.

1.1 For users with older computers Usually it's enough to force OpenGL 1.x and the game should start. Do this by editing settings_ddnet.cfg that is located inside the config directory (https://wiki.ddnet.org/wiki/FAQ#Where_is_the_DDNet_config,_config_directory_or_save_directory?) Make sure no DDNet Client is running (best is you even check in the taskmanager) To the bottom of this file add: ``` gfx_gl_major 1 gfx_backend opengl ``` If you are a steam user, you can also pass it as steam start parameter by writing "gfx_gl_major 1; gfx_backend opengl" (INCLUDING the ") (rightclick ddnet in steam, properties -> start arguments.

If all this still does not help, you can still fallback to software rendering. Software rendering means it runs all graphics calls on your CPU instead of your GPU. This results in far less FPS, but might still be playable with some tweaks. Grab the latest 64-bit version of ddnet from https://ddnet.org/downloads. Now download and install 7-Zip. Download the latest mesa for windows from https://github.com/pal1000/mesa-dist-win/releases which should be named like this: mesa3d-xx.y.z-release-mingw.7z. Unpack the DDNet client somewhere, unpack mesa. From mesa move all .dll files from the x64 directory inside the DDNet client's directory. So all .dll files are next to DDNet.exe. If you did everything right it should start the client again, if not try to add ``` gfx_backend Vulkan ``` to the settings_ddnet.cfg as described above

1.2 For users with new computers Usually this is caused by bad drivers. You should check the manufacturers website for the newest drivers (AMD: https://www.amd.com/en/support, NVIDIA: https://www.nvidia.com/download/index.aspx?lang=en-us, Intel: https://www.intel.com/content/www/us/en/download-center/home.html also for intel note this article https://www.intel.com/content/www/us/en/support/articles/000058958/graphics.html) If it's still crashing you should try to use vulkan Do this by editing settings_ddnet.cfg that is located inside the config directory (https://wiki.ddnet.org/wiki/FAQ#Where_is_the_DDNet_config,_config_directory_or_save_directory?) Make sure no DDNet Client is running (best is you even check in the taskmanager) To the bottom of this file add: ``` gfx_backend Vulkan ``` If you are a steam user, you can also pass it as steam start parameter by writing "gfx_backend Vulkan" (INCLUDING the ") (rightclick ddnet in steam, properties -> start arguments

2.0 Some text is invisible with the Vulkan backend Users with an AMD card reported this and it's caused by AMD driver from 2021. Just visit and download a driver from march 2022 or newer from https://www.amd.com/en/support. If there is no driver from 2022 you should switch back to OpenGL, you sadly cannot use Vulkan then, inside the client just paste `gfx_gl_major 3;gfx_gl_minor 3; gfx_backend opengl` in the F1 console and restart the client.

3.0 The client randomly crashes with an Intel GPU Usually DDNet has a strong fallback system for Intel GPUs on Windows as they often caused bugs with OpenGL 2.1+ If you have a recent Intel GPU you can simply switch to Vulkan in the graphic settings inside the client. Else type `gfx_gl_major 2;gfx_gl_minor 0; gfx_backend opengl` in the F1 console of the client and restart.

4.0 Absolutly nothing helps If you are sure you did everything correct and nothing helped report this bug on ddnet's discord #bugs channel. You are the first encountering this situation. The only known modern GPU that caused problems is an AMD ryzen 3 2200g, if you don't use the AMD beta drivers (confirmed with Adrenalin 22.5.1 Recommended (WHQL)) You can simply switch to OpenGL backend, see #2.0. Else you have to accept to use an OpenGL 1.x backend as described in #1.1. It's also quite possible that the problem is not GFX related. Try to disable your Anti-Virus for DDNet, make sure you use a recent Windows/Linux/macOS version. Always try 64-bit versions first as they are more tested.

5.0 Some ingame tiles are invisible or look broken

You are probably an user with an old GPU, just see 1.1 for the solution.