1 <?xml version="1.0" standalone="yes"?>
4 ============================================
5 Application bugs worked around in this file:
6 ============================================
8 * Unigine Heaven 3.0 and older contain too many bugs and can't be supported
9 by drivers that want to be compliant.
11 * Various Unigine products don't use the #version and #extension GLSL
12 directives, meaning they only get GLSL 1.10 and no extensions for their
14 Enabling all extensions for Unigine fixes most issues, but the GLSL version
17 * If ARB_sample_shading is supported, Unigine Heaven 4.0 and Valley 1.0 uses
18 an #extension directive in the middle of its shaders, which is illegal
21 * Dying Light and Dead Island Definitive Edition redeclare vertex shader
22 built-ins (specifically gl_VertexID), which causes the vertex shaders to fail
25 * Applications that are not suitable for adapative sync are blacklisted here.
27 TODO: document the other workarounds.
32 <!ELEMENT driconf (device+)>
33 <!ELEMENT device (application | engine)+>
34 <!ATTLIST device driver CDATA #IMPLIED>
35 <!ELEMENT application (option+)>
36 <!ATTLIST application name CDATA #REQUIRED
37 executable CDATA #REQUIRED>
38 <!ELEMENT engine (option+)>
40 <!-- engine_name_match: A regexp matching the engine name -->
41 <!-- engine_version: A list of version in range format
42 (version 1 to 4 and version 7 to 8 : "1:4,7:8") -->
44 <!ATTLIST engine engine_name_match CDATA #REQUIRED
45 engine_versions CDATA #REQUIRED>
47 <!ELEMENT option EMPTY>
48 <!ATTLIST option name CDATA #REQUIRED
49 value CDATA #REQUIRED>
53 <!-- Please always enable app-specific workarounds for all drivers and
56 <application name="Unigine Sanctuary" executable="Sanctuary">
57 <option name="force_glsl_extensions_warn" value="true" />
58 <option name="disable_blend_func_extended" value="true" />
59 <option name="disable_arb_gpu_shader5" value="true" />
62 <application name="Unigine Tropics" executable="Tropics">
63 <option name="force_glsl_extensions_warn" value="true" />
64 <option name="disable_blend_func_extended" value="true" />
65 <option name="disable_arb_gpu_shader5" value="true" />
68 <application name="Unigine Heaven (32-bit)" executable="heaven_x86">
69 <option name="allow_glsl_extension_directive_midshader" value="true" />
70 <!-- remove dual_color_blend_by_location if 4.1 ever comes out -->
71 <option name="dual_color_blend_by_location" value="true" />
74 <application name="Unigine Heaven (64-bit)" executable="heaven_x64">
75 <option name="allow_glsl_extension_directive_midshader" value="true" />
76 <!-- remove dual_color_blend_by_location if 4.1 ever comes out -->
77 <option name="dual_color_blend_by_location" value="true" />
80 <application name="Unigine Valley (32-bit)" executable="valley_x86">
81 <option name="allow_glsl_extension_directive_midshader" value="true" />
82 <!-- remove dual_color_blend_by_location if 1.1 ever comes out -->
83 <option name="dual_color_blend_by_location" value="true" />
86 <application name="Unigine Valley (64-bit)" executable="valley_x64">
87 <option name="allow_glsl_extension_directive_midshader" value="true" />
88 <!-- remove dual_color_blend_by_location if 1.1 ever comes out -->
89 <option name="dual_color_blend_by_location" value="true" />
92 <application name="Unigine OilRush (32-bit)" executable="OilRush_x86">
93 <option name="disable_blend_func_extended" value="true" />
94 <option name="allow_glsl_extension_directive_midshader" value="true" />
97 <application name="Unigine OilRush (64-bit)" executable="OilRush_x64">
98 <option name="disable_blend_func_extended" value="true" />
99 <option name="allow_glsl_extension_directive_midshader" value="true" />
102 <application name="Savage 2" executable="savage2.bin">
103 <option name="disable_glsl_line_continuations" value="true" />
106 <application name="Topogun (32-bit)" executable="topogun32">
107 <option name="always_have_depth_buffer" value="true" />
110 <application name="Topogun (64-bit)" executable="topogun64">
111 <option name="always_have_depth_buffer" value="true" />
114 <application name="Dead Island (incl. Definitive Edition)" executable="DeadIslandGame">
115 <option name="allow_glsl_extension_directive_midshader" value="true" />
117 <!-- For the Definitive Edition which shares the same executable name -->
118 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
121 <application name="Dead Island Riptide Definitive Edition" executable="DeadIslandRiptideGame">
122 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
125 <application name="Doom 3: BFG" executable="Doom3BFG.exe">
126 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
127 <option name="force_glsl_extensions_warn" value="true" />
130 <application name="Dying Light" executable="DyingLightGame">
131 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
134 <application name="RAGE (64-bit)" executable="Rage64.exe">
135 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
138 <application name="RAGE (32-bit)" executable="Rage.exe">
139 <option name="allow_glsl_builtin_variable_redeclaration" value="true" />
142 <application name="Second Life" executable="do-not-directly-run-secondlife-bin">
143 <option name="allow_glsl_extension_directive_midshader" value="true" />
146 <application name="Warsow (32-bit)" executable="warsow.i386">
147 <option name="allow_glsl_extension_directive_midshader" value="true" />
150 <application name="Warsow (64-bit)" executable="warsow.x86_64">
151 <option name="allow_glsl_extension_directive_midshader" value="true" />
154 <application name="Rust" executable="rust">
155 <option name="glsl_zero_init" value="true"/>
158 <application name="Divinity: Original Sin Enhanced Edition" executable="EoCApp">
159 <option name="allow_glsl_extension_directive_midshader" value="true" />
160 <option name="glsl_correct_derivatives_after_discard" value="true" />
161 <option name="force_gl_vendor" value="ATI Technologies, Inc."/>
164 <application name="Metro 2033 Redux / Metro Last Night Redux" executable="metro">
165 <option name="allow_glsl_extension_directive_midshader" value="true" />
168 <application name="Worms W.M.D" executable="Worms W.M.Dx64">
169 <option name="allow_higher_compat_version" value="true" />
172 <application name="Crookz - The Big Heist" executable="Crookz">
173 <option name="allow_higher_compat_version" value="true" />
176 <application name="Tropico 5" executable="Tropico5">
177 <option name="allow_higher_compat_version" value="true" />
180 <application name="The Culling" executable="Victory">
181 <option name="force_glsl_version" value="440" />
184 <application name="Spec Ops: The Line (32-bit)" executable="specops.i386">
185 <option name="force_glsl_abs_sqrt" value="true" />
188 <application name="Spec Ops: The Line (64-bit)" executable="specops">
189 <option name="force_glsl_abs_sqrt" value="true" />
192 <application name="Kerbal Space Program (32-bit)" executable="KSP.x86">
193 <option name="glsl_zero_init" value="true"/>
196 <application name="Kerbal Space Program (64-bit)" executable="KSP.x86_64">
197 <option name="glsl_zero_init" value="true"/>
200 <application name="Rocket League" executable="RocketLeague">
201 <option name="glsl_correct_derivatives_after_discard" value="true"/>
204 <application name="The Witcher 2" executable="witcher2">
205 <option name="glsl_correct_derivatives_after_discard" value="true"/>
208 <application name="Unreal 4 Editor" executable="UE4Editor">
209 <option name="allow_glsl_cross_stage_interpolation_mismatch" value="true"/>
212 <application name="Observer" executable="TheObserver-Linux-Shipping">
213 <option name="allow_glsl_cross_stage_interpolation_mismatch" value="true"/>
216 <application name="Steamroll" executable="Steamroll-Linux-Shipping">
217 <option name="allow_glsl_cross_stage_interpolation_mismatch" value="true"/>
220 <application name="Refunct" executable="Refunct-Linux-Shipping">
221 <option name="allow_glsl_cross_stage_interpolation_mismatch" value="true"/>
224 <application name="Google Earth VR" executable="Earth.exe">
225 <option name="allow_glsl_builtin_const_expression" value="true"/>
226 <option name="allow_glsl_relaxed_es" value="true"/>
229 <application name="No Mans Sky" executable="NMS.exe">
230 <option name="force_glsl_extensions_warn" value="true" />
231 <option name="allow_glsl_layout_qualifier_on_function_parameters" value="true" />
234 <application name="Wolfenstein The Old Blood" executable="WolfOldBlood_x64.exe">
235 <option name="force_compat_profile" value="true" />
238 <application name="ARMA 3" executable="arma3.x86_64">
239 <option name="glsl_correct_derivatives_after_discard" value="true"/>
242 <application name="Epic Games Launcher" executable="EpicGamesLauncher.exe">
243 <option name="force_compat_profile" value="true" />
246 <!-- The GL thread whitelist is below, workarounds are above.
247 Keep it that way. -->
249 <application name="Alien Isolation" executable="AlienIsolation">
250 <option name="mesa_glthread" value="true"/>
253 <application name="BioShock Infinite" executable="bioshock.i386">
254 <option name="mesa_glthread" value="true"/>
257 <application name="Borderlands 2" executable="Borderlands2">
258 <option name="mesa_glthread" value="true"/>
261 <application name="Civilization 5" executable="Civ5XP">
262 <option name="mesa_glthread" value="true"/>
264 <application name="Civilization 6" executable="Civ6">
265 <option name="mesa_glthread" value="true"/>
267 <application name="Civilization 6" executable="Civ6Sub">
268 <option name="mesa_glthread" value="true"/>
271 <application name="Dreamfall Chapters" executable="Dreamfall Chapters">
272 <option name="mesa_glthread" value="true"/>
275 <application name="Hitman" executable="HitmanPro">
276 <option name="mesa_glthread" value="true"/>
279 <application name="Renowned Explorers: International Society" executable="abbeycore_steam">
280 <option name="mesa_glthread" value="true"/>
283 <application name="Saints Row 2" executable="saintsrow2.i386">
284 <option name="mesa_glthread" value="true"/>
286 <application name="Saints Row: The Third" executable="SaintsRow3.i386">
287 <option name="mesa_glthread" value="true"/>
289 <application name="Saints Row IV" executable="SaintsRow4.i386">
290 <option name="mesa_glthread" value="true"/>
292 <application name="Saints Row: Gat out of Hell" executable="SaintsRow4GooH.i386">
293 <option name="mesa_glthread" value="true"/>
296 <application name="Sid Meier's: Civilization Beyond Earth" executable="CivBE">
297 <option name="mesa_glthread" value="true"/>
300 <application name="The Witcher 2" executable="witcher2">
301 <option name="mesa_glthread" value="true"/>
304 <application name="American Truck Simulator" executable="amtrucks">
305 <option name="mesa_glthread" value="true"/>
307 <application name="Euro Truck Simulator 2" executable="eurotrucks2">
308 <option name="mesa_glthread" value="true"/>
311 <application name="Overlord" executable="overlord.i386">
312 <option name="mesa_glthread" value="true"/>
314 <application name="Overlord 2" executable="overlord2.i386">
315 <option name="mesa_glthread" value="true"/>
318 <application name="Oil Rush" executable="OilRush_x86">
319 <option name="mesa_glthread" value="true"/>
322 <application name="War Thunder" executable="aces">
323 <option name="mesa_glthread" value="true"/>
325 <application name="War Thunder (Wine)" executable="aces.exe">
326 <option name="mesa_glthread" value="true"/>
329 <application name="Outlast" executable="OLGame.x86_64">
330 <option name="mesa_glthread" value="true"/>
333 <application name="Spec Ops: The Line (32-bit)" executable="specops.i386">
334 <option name="mesa_glthread" value="true"/>
336 <application name="Spec Ops: The Line (64-bit)" executable="specops">
337 <option name="mesa_glthread" value="true"/>
339 <application name="Mount and Blade Warband" executable="mb_warband_linux">
340 <option name="mesa_glthread" value="true"/>
343 <!-- around 18% performance increase in min and avg fps, max fps capped at 60fps. -->
344 <application name="Medieval II: Total War" executable="Medieval2">
345 <option name="mesa_glthread" value="true"/>
348 <!-- min fps ~21 ===> ~27 while standing still in game, also higher gpu load. -->
349 <application name="Carnivores: Dinosaur Hunter Reborn (wine)" executable="Carnivores-master.exe">
350 <option name="mesa_glthread" value="true"/>
353 <!-- around 30% increase in avg fps -->
354 <application name="Far Cry 2 (wine)" executable="farcry2.exe">
355 <option name="mesa_glthread" value="true"/>
358 <application name="Talos Principle" executable="Talos">
359 <option name="mesa_glthread" value="true"/>
361 <application name="Talos Principle (Unrestricted)" executable="Talos_Unrestricted">
362 <option name="mesa_glthread" value="true"/>
365 <!-- roughly 30% increase in fps -->
366 <application name="7 Days To Die (64-bit)" executable="7DaysToDie.x86_64">
367 <option name="mesa_glthread" value="true"/>
369 <application name="7 Days To Die (32-bit)" executable="7DaysToDie.x86">
370 <option name="mesa_glthread" value="true"/>
373 <!-- Emulator tends to have a high CPU load for GPU emulation, so separating the driver overhead yield an improvement. -->
374 <application name="Dolphin Emulator" executable="dolphin-emu">
375 <option name="mesa_glthread" value="true"/>
377 <application name="Citra - Nintendo 3DS Emulator" executable="citra-qt">
378 <option name="mesa_glthread" value="true"/>
380 <application name="Yuzu - Nintendo Switch Emulator" executable="yuzu">
381 <option name="mesa_glthread" value="true"/>
384 <!-- Adaptive sync blacklist follows below: -->
385 <application name="gnome-shell" executable="gnome-shell">
386 <option name="adaptive_sync" value="false" />
388 <application name="Desktop — Plasma" executable="plasmashell">
389 <option name="adaptive_sync" value="false" />
391 <application name="budgie-wm" executable="budgie-wm">
392 <option name="adaptive_sync" value="false" />
394 <application name="kwin_x11" executable="kwin_x11">
395 <option name="adaptive_sync" value="false" />
397 <application name="ksmserver-logout-greeter" executable="ksmserver-logout-greeter">
398 <option name="adaptive_sync" value="false" />
400 <application name="ksmserver-switchuser-greeter" executable="ksmserver-switchuser-greeter">
401 <option name="adaptive_sync" value="false" />
403 <application name="kscreenlocker_greet" executable="kscreenlocker_greet">
404 <option name="adaptive_sync" value="false" />
406 <application name="startplasma" executable="startplasma">
407 <option name="adaptive_sync" value="false" />
409 <application name="sddm-greeter" executable="sddm-greeter">
410 <option name="adaptive_sync" value="false" />
412 <application name="krunner" executable="krunner">
413 <option name="adaptive_sync" value="false" />
415 <application name="spectacle" executable="spectacle">
416 <option name="adaptive_sync" value="false" />
418 <application name="marco" executable="marco">
419 <option name="adaptive_sync" value="false" />
421 <application name="compton" executable="compton">
422 <option name="adaptive_sync" value="false" />
424 <application name="xfwm4" executable="xfwm4">
425 <option name="adaptive_sync" value="false" />
427 <application name="Enlightenment" executable="enlightenment">
428 <option name="adaptive_sync" value="false" />
430 <application name="mutter" executable="mutter">
431 <option name="adaptive_sync" value="false" />
433 <application name="muffin" executable="muffin">
434 <option name="adaptive_sync" value="false" />
436 <application name="compiz" executable="compiz">
437 <option name="adaptive_sync" value="false" />
439 <application name="Firefox" executable="firefox">
440 <option name="adaptive_sync" value="false" />
442 <application name="Firefox ESR" executable="firefox-esr">
443 <option name="adaptive_sync" value="false" />
445 <application name="Chromium" executable="chromium">
446 <option name="adaptive_sync" value="false" />
448 <application name="Google Chrome" executable="chrome">
449 <option name="adaptive_sync" value="false" />
451 <application name="Iceweasel" executable="iceweasel">
452 <option name="adaptive_sync" value="false" />
454 <application name="Epiphany" executable="epiphany">
455 <option name="adaptive_sync" value="false" />
457 <application name="Konqueror" executable="konqueror">
458 <option name="adaptive_sync" value="false" />
460 <application name="Falkon" executable="falkon">
461 <option name="adaptive_sync" value="false" />
463 <application name="Seamonkey" executable="seamonkey">
464 <option name="adaptive_sync" value="false" />
466 <application name="Waterfox" executable="waterfox">
467 <option name="adaptive_sync" value="false" />
469 <application name="VLC Media Player" executable="vlc">
470 <option name="adaptive_sync" value="false" />
472 <application name="Totem" executable="totem">
473 <option name="adaptive_sync" value="false" />
475 <application name="Dragon Player" executable="dragon">
476 <option name="adaptive_sync" value="false" />
478 <application name="mpv" executable="mpv">
479 <option name="adaptive_sync" value="false" />
481 <application name="Xorg" executable="Xorg">
482 <option name="v3d_nonmsaa_texture_size_limit" value="true" />
485 <application name="gfxbench" executable="testfw_app">
486 <option name="vk_x11_override_min_image_count" value="2" />
489 <!-- Gallium Nine workarounds: -->
490 <application name="Rayman Legends" executable="Rayman Legends.exe">
491 <option name="dynamic_texture_workaround" value="true" />
494 <!-- Vulkan workarounds: -->
496 <!-- Works around the game not starting (does not deal with
497 the implementation returning more images than the minimum
498 specified by the application. -->
499 <engine engine_name_match="UnrealEngine4.*" engine_versions="0:23">
500 <option name="vk_x11_strict_image_count" value="true" />
503 <!-- DOOM crashes at startup without this workaround if the adaptative sync mode is enabled. -->
504 <application name="DOOM" executable="DOOMx64vk.exe">
505 <option name="vk_x11_strict_image_count" value="true" />
508 <!-- vmwgfx doesn't like full buffer swaps and can't sync to vertical retraces.-->
509 <device driver="vmwgfx">
510 <application name="gnome-shell" executable="gnome-shell">
511 <option name="glx_disable_ext_buffer_age" value="true" />
512 <option name="glx_disable_oml_sync_control" value="true" />
513 <option name="glx_disable_sgi_video_sync" value="true" />
515 <application name="Compiz" executable="Compiz">
516 <option name="glx_disable_ext_buffer_age" value="true" />
517 <option name="glx_disable_oml_sync_control" value="true" />
520 <device driver="radeonsi">
521 <application name="ARK: Survival Evolved (and unintentionally the UE4 demo template)" executable="ShooterGame">
522 <option name="radeonsi_clear_db_cache_before_clear" value="true" />
524 <application name="American Truck Simulator" executable="amtrucks">
525 <option name="radeonsi_zerovram" value="true" />
527 <application name="Counter-Strike Global Offensive" executable="csgo_linux64">
528 <option name="radeonsi_zerovram" value="true" />
530 <application name="No Mans Sky" executable="NMS.exe">
531 <option name="radeonsi_zerovram" value="true" />
533 <application name="Rocket League" executable="RocketLeague">
534 <option name="radeonsi_zerovram" value="true" />
536 <application name="Civilization 6" executable="Civ6">
537 <option name="radeonsi_enable_nir" value="true"/>
539 <application name="Civilization 6" executable="Civ6Sub">
540 <option name="radeonsi_enable_nir" value="true"/>
542 <application name="DiRT Rally" executable="DirtRally">
543 <option name="radeonsi_prim_restart_tri_strips_only" value="true"/>
545 <application name="Gfx Bench" executable="gfxbench_gl">
546 <!-- Helps offscreen tests -->
547 <option name="mesa_glthread" value="true"/>
550 <device driver="virtio_gpu">
551 <!-- Some Valve games do a final blit to a BRGA_sRGB surface. On a GLES
552 host this format is not supported and the blit will go to BGRA_UNORM
553 resulting in an unintended linearization and the final output being
555 <application name="Half Life 2" executable="hl2_linux">
556 <option name="gles_emulate_bgra" value="true" />
558 <application name="Portal" executable="hl2_linux">
559 <option name="gles_emulate_bgra" value="true" />
561 <application name="Left 4 Dead 2" executable="hl2_linux">
562 <option name="gles_emulate_bgra" value="true" />
564 <application name="Dota 2" executable="dota2">
565 <option name="gles_emulate_bgra" value="true" />
567 <!-- The Raven Remastered expects a BGRA_sRGB surface and a BGRA_sRGB
568 surface that is capable to do texture views, since on GLES the BGRA
569 format provided by EXT_texture_BGRA8888 has no sRGB counterpart and
570 is not in the list of suppoerted TextureView formats we need to
572 <application name="The Raven Remastered" executable="Raven">
573 <option name="gles_emulate_bgra" value="true" />