From 42597307e939b93f6137c36c521f176285cc31c4 Mon Sep 17 00:00:00 2001
From: kaulfield <kaulfield@protonmail.com>
Date: Thu, 29 Jan 2026 22:55:26 +0100
Subject: [PATCH] [android] Added toggle in hacks for disabling/enabling the
 asynchronous_gpu_emulation option (enabled by default)

---
 .../yuzu_emu/features/settings/model/BooleanSetting.kt     | 1 +
 .../yuzu_emu/features/settings/model/view/SettingsItem.kt  | 7 +++++++
 .../features/settings/ui/SettingsFragmentPresenter.kt      | 1 +
 src/android/app/src/main/res/values/strings.xml            | 4 ++++
 4 files changed, 13 insertions(+)

diff --git a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/BooleanSetting.kt b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/BooleanSetting.kt
index b7ae56f9b4..cfc974acbf 100644
--- a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/BooleanSetting.kt
+++ b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/BooleanSetting.kt
@@ -24,6 +24,7 @@ enum class BooleanSetting(override val key: String) : AbstractBooleanSetting {
     RENDERER_FORCE_MAX_CLOCK("force_max_clock"),
     RENDERER_ASYNCHRONOUS_SHADERS("use_asynchronous_shaders"),
     RENDERER_REACTIVE_FLUSHING("use_reactive_flushing"),
+    USE_ASYNCHRONOUS_GPU_EMULATION("use_asynchronous_gpu_emulation"),
     SYNC_MEMORY_OPERATIONS("sync_memory_operations"),
     BUFFER_REORDER_DISABLE("disable_buffer_reorder"),
     RENDERER_DEBUG("debug"),
diff --git a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/view/SettingsItem.kt b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/view/SettingsItem.kt
index 8396672ba3..9e7a5be0e5 100644
--- a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/view/SettingsItem.kt
+++ b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/model/view/SettingsItem.kt
@@ -740,6 +740,13 @@ abstract class SettingsItem(
                     descriptionId = R.string.renderer_reactive_flushing_description
                 )
             )
+            put(
+                SwitchSetting(
+                    BooleanSetting.USE_ASYNCHRONOUS_GPU_EMULATION,
+                    titleId = R.string.use_asynchronous_gpu_emulation,
+                    descriptionId = R.string.use_asynchronous_gpu_emulation_description
+                )
+            )
             put(
                 SwitchSetting(
                     BooleanSetting.SYNC_MEMORY_OPERATIONS,
diff --git a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/ui/SettingsFragmentPresenter.kt b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/ui/SettingsFragmentPresenter.kt
index 27222c85af..d1a5085758 100644
--- a/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/ui/SettingsFragmentPresenter.kt
+++ b/src/android/app/src/main/java/org/yuzu/yuzu_emu/features/settings/ui/SettingsFragmentPresenter.kt
@@ -278,6 +278,7 @@ class SettingsFragmentPresenter(
 
             add(HeaderSetting(R.string.hacks))
 
+            add(BooleanSetting.USE_ASYNCHRONOUS_GPU_EMULATION.key)
             add(IntSetting.FAST_GPU_TIME.key)
             add(BooleanSetting.SKIP_CPU_INNER_INVALIDATION.key)
             add(BooleanSetting.FIX_BLOOM_EFFECTS.key)
diff --git a/src/android/app/src/main/res/values/strings.xml b/src/android/app/src/main/res/values/strings.xml
index ec4f9a2cf4..25471f4f5b 100644
--- a/src/android/app/src/main/res/values/strings.xml
+++ b/src/android/app/src/main/res/values/strings.xml
@@ -120,6 +120,10 @@
     <string name="on_load">On Load</string>
     <string name="always">Always</string>
 
+    <!-- Asynchronous GPU Emulation -->
+    <string name="use_asynchronous_gpu_emulation" translatable="false">Async GPU</string>
+    <string name="use_asynchronous_gpu_emulation_description">Controls process mode for dispatched GPU commands.</string>
+
     <!-- Multiplayer -->
     <string name="multiplayer">Multiplayer</string>
     <string name="multiplayer_description">Host your own game room or join an existing one to play with people</string>