games_db.json

{
  "_meta": {
    "version": "5",
    "description": "BC-250 community game database. PRs welcome at github.com/Necrosiak/bc250-toolkit-decky",
    "hardware": "ASRock BC-250 (AMD Ryzen Embedded V2000 / Cyan Skillfish GPU — device ID 731F)",
    "updated": "2026-06-28",
    "schema": "Top-level keys of a game = its STABLE/default config (back-compatible). Optional 'configs' array = alternative variants; each has label/stability/compat_tool/launch_options/radv/requires. 'radv' = per-game /etc/drirc-style options (e.g. radv_enable_unified_heap_on_apu). 'requires' = hardware prerequisites (uma_min_mb, gttsize) the tool surfaces to the user.",
    "presets": {
      "ue5_dx12_oom": {
        "description": "Reusable fix profile for Unreal Engine 5 games in DX12 (VKD3D) that crash 'out of video memory' at render init (D3D12Util.cpp:926), even with plenty of RAM/VRAM free. Root cause: radv unified heap on APU merges everything into one host-visible heap, so VKD3D sees DedicatedVideoMemory ~= 0 and the engine bails. Fix: disable unified heap for that exe + give it real dedicated VRAM via UMA + use GE-Proton for the video codecs (cutscenes). To apply to a new game: copy this block into the game entry and replace radv.match with the game's executable name (e.g. MyGame-Win64-Shipping.exe).",
        "symptoms": ["LowLevelFatalError [File:...D3D12Util.cpp] [Line:926] Out of video memory", "crash at render init with only ~1 GB VRAM used and lots free (bIsOOM=0)", "DX12-only titles (DXVK/Vulkan titles unaffected)", "cutscenes black image with sound only (missing video codecs) -> use GE-Proton"],
        "radv": {"match": "REPLACE-Win64-Shipping.exe", "options": {"radv_enable_unified_heap_on_apu": false}},
        "requires": {"uma_min_mb": 8192, "note": "UMA Frame Buffer >= 4G at BIOS (AMD CBS). On a 16 GB BC-250, UMA=Auto already yields 8192 MB which works well. Disabling unified heap means the game ONLY sees the dedicated VRAM, so it must be large enough."},
        "compat_tool": "GE-Proton10-34",
        "validated_on": "Code Vein 2 (app_id 2362060)"
      }
    },
    "sources": ["elektricm.github.io/amd-bc250-docs", "bc250.info", "ProtonDB", "Reddit r/linux_gaming"]
  },
  "2362060": {
    "name": "Code Vein 2",
    "proton": "GE-Proton10-34",
    "compat_tool": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "radv": { "match": "CodeVein2-Win64-Shipping.exe", "options": { "radv_enable_unified_heap_on_apu": false } },
    "requires": { "uma_min_mb": 4096, "note": "UMA Frame Buffer ≥ 4G au BIOS (AMD CBS). Sinon : crash 'out of video memory' à l'init." },
    "stability": "stable",
    "notes": "UE5 DX12 (VKD3D). Le crash 'out of video memory' (D3D12Util.cpp:926, dès l'init à ~1 Go) vient du unified heap radv qui masque la VRAM dédiée à VKD3D (DedicatedVideoMemory≈0). FIX : unified heap OFF pour ce jeu (champ radv) + UMA ≥4G au BIOS pour exposer une vraie VRAM dédiée. GE-Proton requis pour les cinématiques (codecs vidéo Media Foundation, sinon image noire + son). Compilation shaders longue au 1er lancement. En jeu la VRAM est proche du plafond 4G (stutter possible) → variante UMA 8G ci-dessous si dispo.",
    "tested_on": "BC-250",
    "configs": [
      {
        "label": "Stable (UMA 4G)",
        "stability": "stable",
        "compat_tool": "GE-Proton10-34",
        "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
        "radv": { "match": "CodeVein2-Win64-Shipping.exe", "options": { "radv_enable_unified_heap_on_apu": false } },
        "requires": { "uma_min_mb": 4096 }
      },
      {
        "label": "Performance (UMA 8G — moins de stutter)",
        "stability": "experimental",
        "compat_tool": "GE-Proton10-34",
        "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
        "radv": { "match": "CodeVein2-Win64-Shipping.exe", "options": { "radv_enable_unified_heap_on_apu": false } },
        "requires": { "uma_min_mb": 8192, "gttsize": 6000, "note": "UMA 8G : RAM système → ~7 Go, baisser amdgpu.gttsize à ~6000." }
      }
    ]
  },
  "3321460": {
    "name": "Crimson Desert",
    "proton": "Proton Experimental",
    "compat_tool": "proton_experimental",
    "proton_branch": "bleeding-edge",
    "proton_note": "⚠ Activer bleeding-edge : Bibliothèque > Outils > Proton Experimental > Propriétés > Versions du jeu et bêtas > bleeding-edge",
    "launch_options": "DXVK_CONFIG=\"dxgi.customDeviceId=731F dxgi.customVendorId=1002\" MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "Spoof GPU nécessaire (Cyan Skillfish non reconnu). Depuis bleeding-edge 01/04/2026 : tourne sans args — MangoHud/vkBasalt restent utiles.",
    "tested_on": "BC-250"
  },
  "1091500": {
    "name": "Cyberpunk 2077",
    "proton": "GE-Proton10-34",
    "launch_options": "RADV_PERFTEST=gpl,sam MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "RT désactivé recommandé. FSR 3.1 Ultra Quality. Surveiller les températures (peut tirer fort).",
    "tested_on": "BC-250"
  },
  "1174180": {
    "name": "Red Dead Redemption 2",
    "proton": "GE-Proton10-34",
    "launch_options": "WINE_FULLSCREEN_FSR=1 WINE_FULLSCREEN_FSR_STRENGTH=3 MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "Mode graphique Vulkan recommandé. Si 'software rendering' détecté : changer l'adaptateur dans les options graphiques du jeu. Réduire le budget mémoire graphique.",
    "tested_on": "BC-250"
  },
  "1245620": {
    "name": "Elden Ring",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "Jouable ~60 FPS. Ajuster les settings graphiques selon la résolution cible.",
    "tested_on": "BC-250"
  },
  "870780": {
    "name": "Control",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
    "notes": "RT fonctionne (~40 FPS) grâce au support RDNA 1.5 du Cyan Skillfish. DX12 recommandé.",
    "tested_on": "BC-250"
  },
  "730": {
    "name": "Counter-Strike 2",
    "proton": "Proton Experimental",
    "compat_tool": "proton_experimental",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
    "notes": "100+ FPS en 1080p. Natif Linux via Proton. Très stable.",
    "tested_on": "BC-250"
  },
  "252950": {
    "name": "Rocket League",
    "proton": "Proton Experimental",
    "compat_tool": "proton_experimental",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
    "notes": "120+ FPS en 1080p. Très bien optimisé sur BC-250.",
    "tested_on": "BC-250"
  },
  "601150": {
    "name": "Devil May Cry 5",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "~100 FPS en High. Latence très basse — l'un des jeux les mieux optimisés sur BC-250.",
    "tested_on": "BC-250"
  },
  "1738780": {
    "name": "Company of Heroes 3",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
    "notes": "⚠ IMPORTANT : régler le split VRAM à 4 Go minimum dans le BIOS (512 Mo = artifacts et crashes).",
    "tested_on": "BC-250"
  },
  "1222140": {
    "name": "Detroit: Become Human",
    "proton": "Proton Experimental",
    "compat_tool": "proton_experimental",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "60 FPS stable en Medium. Très bien optimisé, peu de config nécessaire.",
    "tested_on": "BC-250"
  },
  "1888930": {
    "name": "The Last of Us Part I",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "60 FPS en Medium-High. Compilation shaders longue au premier lancement (températures élevées — normal).",
    "tested_on": "BC-250"
  },
  "2358720": {
    "name": "Black Myth: Wukong",
    "proton": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "notes": "Utiliser les fichiers de jeu non modifiés (version 'nettoyée' → erreur CreateProcess). FSR recommandé.",
    "tested_on": "BC-250"
  },
  "413150": {
    "name": "Stardew Valley",
    "proton": "Proton Experimental",
    "compat_tool": "proton_experimental",
    "launch_options": "gamemoderun %command%",
    "notes": "Fonctionne parfaitement nativement ou via Proton.",
    "tested_on": "BC-250"
  },
  "1659040": {
    "name": "HITMAN World of Assassination",
    "proton": "GE-Proton10-34",
    "compat_tool": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command% -SKIP_LAUNCHER",
    "notes": "DX12/VKD3D only. Le launcher (Jouer/Options/Quitter) plante sous Proton : cliquer Jouer coupe tout (Proton perd le process enfant relancé par le launcher). FIX : argument jeu -SKIP_LAUNCHER après %command%. Fallback si crash au chargement : ajouter DXVK_ASYNC=1 VKD3D_FEATURE_LEVEL=12 devant gamemoderun.",
    "stability": "stable",
    "tested_on": "BC-250"
  },
  "1361210": {
    "name": "Warhammer 40,000: Darktide",
    "proton": "GE-Proton10-34",
    "compat_tool": "GE-Proton10-34",
    "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display ENABLE_VKBASALT=1 gamemoderun %command%",
    "radv": { "match": "Darktide.exe", "options": { "radv_enable_unified_heap_on_apu": false } },
    "requires": { "uma_min_mb": 8192, "note": "UMA Frame Buffer ≥ 4G au BIOS (AMD CBS) ; UMA=Auto donne ~8192 Mo sur une BC-250 16 Go. Le unified heap OFF fait que le jeu ne voit QUE la VRAM dédiée → elle doit être assez grande." },
    "stability": "stable",
    "notes": "DX12/VKD3D (engine Bitsquid/Stingray). Le launcher Fatshark s'affiche OK, mais clic 'Jouer' → écran noir / le rendu ne charge pas : même piège VRAM que Code Vein 2. Le unified heap radv masque la VRAM dédiée à VKD3D (DedicatedVideoMemory≈0) → 'out of video memory' au passage en rendu. FIX : unified heap OFF pour Darktide.exe (champ radv) + UMA ≥4G (Auto ≈8192 Mo) + GE-Proton (codecs). EAC supporté sous Proton. 1er lancement = longue compilation shaders (normal). Famille de fix : preset ue5_dx12_oom.",
    "tested_on": "BC-250"
  },
  "_incompatible": {
    "note": "Jeux non fonctionnels sur BC-250 Linux (pour info communauté)",
    "list": [
      "Fortnite (1665460) — EAC kernel-level, incompatible Linux",
      "Valorant (2181867) — même problème",
      "Final Fantasy VII Rebirth (2749600) — vérifie l'ID GPU, Cyan Skillfish non reconnu, pas de fix actuellement"
    ]
  }
}