From f173e74f4b96e96e7386b8bb2f4dcec2666f9024 Mon Sep 17 00:00:00 2001
From: Alexey Martemyanov <mallexxx@gmail.com>
Date: Sat, 23 May 2026 15:50:05 +0600
Subject: [PATCH] [2026-05-23] htpc-bazzite-proton: add new game guide,
 SteamGridDB key note, Doom 3 BFG fix

---
 wiki/htpc-bazzite-proton.md | 55 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/wiki/htpc-bazzite-proton.md b/wiki/htpc-bazzite-proton.md
index 52d22632..b81efe14 100644
--- a/wiki/htpc-bazzite-proton.md
+++ b/wiki/htpc-bazzite-proton.md
@@ -47,12 +47,35 @@ Try in order:
 2. `WINEDLLOVERRIDES="gdiplus=n,b"`
 3. Install `ttf-mscorefonts` manually + set Cyrillic codepage in Wine registry
 
-### White screen / broken D3D9 (Doom 3 BFG, Rayman Origins, Split Second)
+### White screen / broken D3D9 (Rayman Origins, Split Second)
 ```
 PROTON_USE_WINED3D=1 %command%
 ```
 Or try `WINEDLLOVERRIDES="d3d9=b"` or an older Proton version.
 
+### Doom 3 BFG Edition (App 208200) — чёрные текстуры, краш после интро
+
+Proton Experimental и 7+/8+/9+ ломают текстуры — известный регресс.
+
+**Быстрый фикс** — откатить Proton версию:
+ПКМ → Свойства → Совместимость → **Proton 5.13** (самый стабильный)
+
+**AMD GPU** — launch option:
+```
+MESA_GL_VERSION_OVERRIDE=4.5COMPAT %command%
+```
+
+**Лучший долгосрочный фикс** — заменить движок через Luxtorpeda:
+1. Установить Luxtorpeda (Steam compatibility tool)
+2. Свойства → Совместимость → **Luxtorpeda**
+3. При запуске выбрать **rbdoom-3-bfg**
+
+Или flatpak без Proton:
+```
+flatpak install flathub io.github.maddecoder.Classic-RBDOOM-3-BFG
+```
+Указать путь к данным: `~/.local/share/Steam/steamapps/common/DOOM 3 BFG Edition/`
+
 ## Key Infra Notes
 
 - **shortcuts.vdf**: binary VDF at
@@ -84,6 +107,36 @@ Or try `WINEDLLOVERRIDES="d3d9=b"` or an older Proton version.
   → or `SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD=1`
 - **Metal Slug X**: wrong speed in Neo-Geo wrapper → check emulator settings
 
+## How to Add a New Game
+
+**Шаг 0: Остановить Steam**
+```
+systemctl --user stop gamescope-session-plus@steam.service
+```
+
+**Portable (нет установщика)** — скопируй папку на HTPC, переходи к шагу 1.
+
+**С установщиком** — сначала добавь `setup.exe` как шорткат, запусти →
+после установки замени путь на основной `.exe`.
+
+**Шаг 1: Добавить шорткат**
+Steam → *Игры → Добавить не-Steam игру* → выбери `.exe`
+
+**Шаг 2: Назначить Proton**
+ПКМ на игре → Свойства → Совместимость → Proton Experimental
+
+**Шаг 3: Запустить один раз**
+Wine prefix создастся в:
+`~/.local/share/Steam/steamapps/compatdata/<AppID>/pfx/`
+
+## SteamGridDB
+
+API key хранится в `~/Documents/steamgriddb_api_key.txt` на HTPC.
+Текущий ключ обновлён: 2026-05-23.
+
+Скрипты постеров: `~/scripts/update-artwork.sh` (или аналог).
+Запускать после добавления новых шорткатов.
+
 ## See Also
 
 [[personal-os-architecture]] [[obsidian-mcp-wrapper]]