diff --git a/Guides/Bottles/Guide.md b/Guides/Bottles/Guide.md
index 4d76c86..36ddc55 100644
--- a/Guides/Bottles/Guide.md
+++ b/Guides/Bottles/Guide.md
@@ -48,11 +48,21 @@ This is also known as your Wine runner.
- [ElementalWarrior](/Guides/Bottles/InstallScripts/Affinity-ew.yaml)
- [Wine-tkg-affinity](/Guides/Bottles/InstallScripts/Affinity-tkg.yaml)
7. In Bottles, import the install script file for your Wine fork. `Import Configuration -> Affinity-ew.yaml`
-8. Click **Create**.
+8. Click **Create**. If Wine asks to install Mono, click **No** or **Cancel**.
-## 5. Extract WinMetadata
+## 5. Remove Wine Mono and install .NET Framework
+
+Bottles pre-installs **Wine Mono Windows Support**, which conflicts with .NET Framework 4.8 and can cause CLR crashes (for example `Unhandled exception: 0xe0434352`) when running the Affinity installer. [Wine Mono must be removed before installing .NET Framework 4.8](https://github.com/wine-mono/wine-mono#composition).
+
+1. Open your bottle → **Tools** → **Legacy Wine Tools** → **Control Panel** → **Add/Remove Programs**.
+2. If **Wine Mono Windows Support** is listed, select it and click **Remove**.
+3. Open **Dependencies** and install **dotnet48**. The install should take several minutes; if it finishes very quickly, Wine Mono may still be present—repeat steps 1–2 and reinstall **dotnet48**.
+
+This workaround is [documented in Bottles issue #2887](https://github.com/bottlesdevs/Bottles/issues/2887#issuecomment-2646118028).
+
+## 6. Extract WinMetadata
1. Download the [`WinMetadata.zip` archive file](https://archive.org/download/win-metadata/WinMetadata.zip).
2. Extract the `WinMetadata` folder from the archive into `drive_c/windows/system32`.
diff --git a/Guides/Bottles/GuideV2.md b/Guides/Bottles/GuideV2.md
index 794b8cf..2de1b79 100644
--- a/Guides/Bottles/GuideV2.md
+++ b/Guides/Bottles/GuideV2.md
@@ -34,10 +34,19 @@ Alternately, you may want to install Bottles using the [unofficial AppImage](htt
5. Set the runner to **kron4ek-wine--amd64**
6. Download the [install script file](https://github.com/DaRandomCube/AffinityOnLinux/blob/main/Guides/Bottles/InstallScripts/affinity-nu.yaml)
7. In Bottles, import the install script file for your Wine fork. `Import Configuration -> Affinity-nu.yaml`
-8. Click **Create**.
+8. Click **Create**. If Wine asks to install Mono, click **No** or **Cancel**.
+## 4. Remove Wine Mono and install .NET Framework
+
+Bottles pre-installs **Wine Mono Windows Support**, which conflicts with .NET Framework 4.8 and can cause CLR crashes (for example `Unhandled exception: 0xe0434352`) when running the Affinity installer. [Wine Mono must be removed before installing .NET Framework 4.8](https://github.com/wine-mono/wine-mono#composition).
+
+1. Open your bottle → **Tools** → **Legacy Wine Tools** → **Control Panel** → **Add/Remove Programs**.
+2. If **Wine Mono Windows Support** is listed, select it and click **Remove**.
+3. Open **Dependencies** and install **dotnet48**. The install should take several minutes; if it finishes very quickly, Wine Mono may still be present—repeat steps 1–2 and reinstall **dotnet48**.
+
+This workaround is [documented in Bottles issue #2887](https://github.com/bottlesdevs/Bottles/issues/2887#issuecomment-2646118028).
## 5. Add Windows.winmd
diff --git a/Guides/Bottles/InstallScripts/Affinity-ew.yaml b/Guides/Bottles/InstallScripts/Affinity-ew.yaml
index 246bfe2..484b8e0 100644
--- a/Guides/Bottles/InstallScripts/Affinity-ew.yaml
+++ b/Guides/Bottles/InstallScripts/Affinity-ew.yaml
@@ -2,7 +2,8 @@ Arch: win64
CompatData: ''
Creation_Date: '2024-10-18 16:42:58.782336'
Custom_Path: false
-DLL_Overrides: {}
+DLL_Overrides:
+ mscoree: n,b
DXVK: dxvk-2.4.1
Environment: Custom
Environment_Variables: {}
@@ -21,8 +22,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
-- dotnet40
-- dotnet48
- vcredist2022
#Install vcredist2015 if the program crashes on you while saving.
Language: sys
diff --git a/Guides/Bottles/InstallScripts/Affinity-tkg.yaml b/Guides/Bottles/InstallScripts/Affinity-tkg.yaml
index a44482e..6e980d9 100644
--- a/Guides/Bottles/InstallScripts/Affinity-tkg.yaml
+++ b/Guides/Bottles/InstallScripts/Affinity-tkg.yaml
@@ -2,7 +2,8 @@ Arch: win64
CompatData: ''
Creation_Date: '2024-10-18 16:42:58.782336'
Custom_Path: false
-DLL_Overrides: {}
+DLL_Overrides:
+ mscoree: n,b
DXVK: dxvk-2.4.1
Environment: Custom
Environment_Variables: {}
@@ -21,8 +22,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
-- dotnet40
-- dotnet48
- vcredist2022
#Install vcredist2015 if the program crashes on you while saving.
Language: sys
diff --git a/Guides/Bottles/InstallScripts/affinity-nu.yaml b/Guides/Bottles/InstallScripts/affinity-nu.yaml
index 3162216..ccb5743 100644
--- a/Guides/Bottles/InstallScripts/affinity-nu.yaml
+++ b/Guides/Bottles/InstallScripts/affinity-nu.yaml
@@ -3,6 +3,7 @@ CompatData: ''
Creation_Date: '2025-11-20 14:10:50.517344'
Custom_Path: false
DLL_Overrides:
+ mscoree: n,b
wintypes: n
DXVK: dxvk-2.6.1
Environment: Custom
@@ -22,8 +23,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
-- dotnet40
-- dotnet48
Language: sys
LatencyFleX: latencyflex-v0.1.1
NVAPI: dxvk-nvapi-v0.9.0