From 7a3be60843bff1c20901371317c3e1f841b494a5 Mon Sep 17 00:00:00 2001
From: hypevhs <4498312-hypevhs@users.noreply.gitlab.com>
Date: Sun, 3 Aug 2025 17:02:37 -0500
Subject: [PATCH] envision: the SteamLinuxRuntime_sniper-arm64 issue

---
 content/docs/fossvr/envision/_index.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/content/docs/fossvr/envision/_index.md b/content/docs/fossvr/envision/_index.md
index 5cecdce..02ac465 100644
--- a/content/docs/fossvr/envision/_index.md
+++ b/content/docs/fossvr/envision/_index.md
@@ -90,6 +90,25 @@ Alternatively, you can use the following command:
 flatpak override --filesystem="xdg-data/envision:ro" --filesystem="xdg-run/monado_comp_ipc" --filesystem="xdg-config/openxr:ro" --filesystem="xdg-config/openvr:ro" com.valvesoftware.Steam
 ```
 
+## Known issues
+
+### The `SteamLinuxRuntime_sniper-arm64` issue
+
+If Envision crashes with this in terminal/logs:
+
+```
+thread 'main' panicked at src/util/file_utils.rs:165:9:
+Failed to copy /home/USERNAME/.local/share/Steam/steamapps/common/SteamLinuxRuntime_sniper/_v2-entry-point to /home/USERNAME/.local/share/envision/backups/_v2-entry-point.bak: No such file or directory (os error 2)
+```
+
+This is because [Valve suddenly renamed a folder](https://steamdb.info/app/1628350/history/?changeid=30126564), and it hasn't been reflected in Envision yet. Anyone who has installed or moved the runtime since 18 July 2025 will run into this, even if they are not using ARM64. For now, please symlink it:
+
+```bash
+ln -s ~/.steam/steam/steamapps/common/SteamLinuxRuntime_sniper-arm64 ~/.steam/steam/steamapps/common/SteamLinuxRuntime_sniper
+# or if it's located on a different drive e.g. /mnt/steam
+ln -s /mnt/steam/steamapps/common/SteamLinuxRuntime_sniper-arm64 /mnt/steam/steamapps/common/SteamLinuxRuntime_sniper
+```
+
 ## Experimental feature settings
 
 The following resources can be entered into your Envision profile repo and branch settings to enable early access to code before it's fully upstream in Monado itself. To enable these feature sets, simply clone your profile, edit it with these settings, then build.