Novità della v0.6.3: selezionando una notifica di configurazione automatica si apre la pagina del gioco nella libreria Steam; gli errori di aggiornamento mostrano dettagli e link alla versione.
Un plugin DeckyLoader per l'ASRock BC-250 (AMD Ryzen Embedded V2000 / Cyan Skillfish) con Bazzite, SteamOS Linux o CachyOS.
Database comunitario di opzioni di avvio ottimizzate per il BC-250 — applicabili con un clic dal Quick Access Menu di Steam.
- Rileva automaticamente il gioco selezionato nella libreria Steam
- Mostra le impostazioni consigliate per il BC-250 (versione Proton, opzioni di avvio, note, requisiti hardware)
- Varianti di configurazione — quando un gioco offre più profili ottimizzati (es. Stable vs Performance), se ne sceglie uno da un selettore; la scelta viene memorizzata
- Pulsante Applica — in un'unica azione scrive le opzioni di avvio, seleziona il build Proton/GE-Proton e applica eventuali override GPU per gioco (opzioni RADV in
~/.drirc) - Auto-apply (opt-in) — applica automaticamente la configurazione completa all'avvio di un gioco noto; attivandolo preconfigura anche tutti i giochi installati presenti nel database
- Lettura live del numero di CU attivi tramite i registri SPI della GPU
- 4 profili:
- 24 CU (BC-250 stock)
- 32 CU
- 36 CU
- 40 CU (completo — tutti i WGP attivi)
- Applicazione live senza riavvio
- Toggle Salva all'avvio — installa un servizio systemd che ripristina il profilo ad ogni avvio
- Richiede
umr— installazione automatica tramite pulsante (rpm-ostreesu Bazzite/SteamOS,pacmansu CachyOS/Arch) - Avviso e raccomandazioni di stabilità integrati
- Gestione VRAM (UMA) — imposta la UMA Frame Buffer Size del BIOS (Auto / 2G / 4G / 8G) direttamente dal pannello patchando la variabile NVRAM EFI (
AmdSetup) — senza più passare dalla schermata BIOS. Ha effetto al prossimo riavvio; il pannello mostra la VRAM live e il valore in attesa nel BIOS- Protezioni: whitelist delle versioni BIOS (P3.00), verifica del layout NVRAM, backup automatico prima di ogni scrittura (pulsanti disattivati su BIOS sconosciuti)
- La scrittura nel BIOS richiede un bc250-tweaks aggiornato (fornisce l'helper root
bc250-uma-helper— niente password sudo) - Auto (≈8 GB) è il valore sicuro consigliato — se compaiono artefatti grafici (es. verdi) dopo una modifica, torna su Auto
Con BC250 Control Center installato (il suo RPM con rpm-ostree install su Bazzite, poi una volta Prepare dependencies nell'app), questa scheda diventa la sua interfaccia in modalità gioco:
- GPU — profili del governor e livelli validati
- Compute Units — griglia 4×5 dal vivo, tabella salvata per l'avvio e servizio all'avvio
- CPU — overclock tramite il rilevatore di Control Center, scala manuale e servizio all'avvio
- Ventole — velocità manuale per canale o ritorno ad automatico
Il Toolkit non conserva qui impostazioni proprie: usa lo stesso helper protetto di Control Center, quindi ciò che cambi sul desktop compare in modalità gioco, e viceversa. Anche la scheda CU passa da lì. Senza Control Center il resto del plugin funziona come prima; su Bazzite la scheda offre un pulsante Installa BC250 Control Center (RPM ufficiale v1.19.0, SHA-256 verificato, rpm-ostree install, poi riavvio), altrove rimanda alla pagina del progetto. Il pulsante scompare non appena Control Center viene rilevato.
- Temperature CPU/GPU in tempo reale, velocità della ventola e clock GPU/CPU
- Risorse — RAM di sistema attiva (ciò che resta all'OS dopo il ritaglio UMA), RAM usata con percentuale e numero di CU attivi
- Stato scx_lavd, profilo tuned, stato daemon gamemode
- Integrazioni hardware — in sola lettura: adattatore Wi-Fi con il suo stato NetworkManager e il driver, se
hid_playstationè caricato e quanti controller sono collegati, connettori dello schermo attivi, l'uscita PipeWire corrente e il bus HDMI-CEC quando esiste. Niente viene attivato o modificato: il pannello si limita a constatare ciò che la macchina ha davvero, per non proporre mai una funzione TV o controller che l'hardware non può garantire. - Pulsante di aggiornamento manuale di bc250-tweaks
- Toggle auto-apply
- Aggiornamento DB da GitHub
- Informazioni — versione del plugin, autore e link a GitHub
Il plugin rileva automaticamente la lingua di Steam:
English · Français · Deutsch · Español · Italiano · Português · Nederlands · Polski · Русский
- Attivate la modalità sviluppatore nelle impostazioni generali di Decky
- Impostazioni Decky → Sviluppatore → Installa plugin da URL:
https://github.com/Necrosiak/bc250-toolkit-decky/releases/latest/download/BC250-Toolkit.zip
Distribuzione diretta via GitHub: l'URL qui sopra punta sempre all'ultima release, poi il plugin si tiene aggiornato da solo con l'auto-update integrato.
Installazione manuale nel frattempo:
git clone https://github.com/Necrosiak/bc250-toolkit-decky.git \
~/homebrew/plugins/BC250-Toolkit
sudo systemctl restart plugin_loader- DeckyLoader installato
- Bazzite, SteamOS o CachyOS su BC-250
Il DB si trova in games_db.json e si aggiorna automaticamente da GitHub.
| Gioco | Proton | Note |
|---|---|---|
| Crimson Desert | Proton Experimental (bleeding-edge) | Spoof GPU 731F necessario |
| Cyberpunk 2077 | GE-Proton | RT disabilitato consigliato |
| Elden Ring | GE-Proton | ~60 FPS giocabile |
| Red Dead Redemption 2 | GE-Proton | Modalità Vulkan obbligatoria |
| Control | GE-Proton | RT funziona (RDNA 1.5) |
| Counter-Strike 2 | Proton Experimental | 100+ FPS |
| Rocket League | Proton Experimental | 120+ FPS |
| Devil May Cry 5 | GE-Proton | ~100 FPS Alto |
| Company of Heroes 3 | GE-Proton | VRAM split min. 4 GB richiesto |
| Detroit: Become Human | Proton Experimental | 60 FPS stabili |
| The Last of Us Part I | GE-Proton | 60 FPS Medio-Alto |
| Black Myth: Wukong | GE-Proton | File di gioco non modificati richiesti |
| Code Vein 2 | GE-Proton | UE5 DX12 — richiede UMA Frame Buffer = Auto (~8G) + fix unified-heap per gioco (auto-applicato, vedi preset sotto) |
| Stardew Valley | Proton Experimental | Perfetto |
- Fortnite / Valorant — EAC a livello kernel, incompatibile con Linux
- FF VII Rebirth — Controlla l'ID GPU, Cyan Skillfish non riconosciuto, nessuna soluzione disponibile
🐛 Bug e idee: aprite issue! Ogni segnalazione orienta direttamente la
prossima release. Bastano poche righe — idealmente con il vostro OS (Bazzite,
CachyOS…), la versione del plugin, la scheda del QAM coinvolta e, se
possibile, i log (~/homebrew/logs/BC250-Toolkit/, journalctl -u plugin_loader). Le richieste di funzionalità e i «funziona su X» sono
altrettanto benvenuti.
Usa il modulo di invio — compila i campi, clicca su Invia e verrà creata automaticamente una issue su GitHub. Dopo l'approvazione, il gioco viene aggiunto tramite PR.
- Fai un fork di questo repository
- Modifica
games_db.jsonseguendo il formato esistente - Apri una Pull Request
"STEAM_APP_ID": {
"name": "Nome del gioco",
"proton": "GE-Proton10-34",
"launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
"notes": "Note specifiche per BC-250",
"tested_on": "BC-250"
}Campi avanzati opzionali (il plugin li applica automaticamente al clic su Applica):
compat_tool— build Proton/GE-Proton da selezionare tramite il compat mapping di Steamradv— override Mesa RADV per gioco scritti in~/.drirc, match sul nome dell'eseguibile, es.{"match": "Game-Win64-Shipping.exe", "options": {"radv_enable_unified_heap_on_apu": false}}requires— requisiti hardware mostrati all'utente (uma_min_mb,gttsize)configs— array di varianti alternative, ognuna con il propriolabel,stability,compat_tool,launch_options,radv,requires; l'utente ne sceglie una nella scheda Giochi
L'AppID di Steam si trova nell'URL della pagina del gioco sullo Steam Store.
Alcuni giochi Unreal Engine 5 in DX12 vanno in crash all'inizializzazione del render (D3D12Util.cpp:926 — Out of video memory) pur con molta VRAM libera, perché l'unified heap di RADV su APU nasconde la VRAM dedicata a VKD3D (DedicatedVideoMemory ≈ 0). games_db.json include un profilo riutilizzabile ue5_dx12_oom in _meta.presets: disattivare l'unified heap per l'eseguibile del gioco + impostare l'UMA Frame Buffer del BIOS su Auto (dà già ~8 GB su un BC-250 da 16 GB — non serve forzare 4G) + usare GE-Proton per i codec video. Per correggere un nuovo gioco interessato, copia il preset nella sua voce e imposta radv.match sul suo eseguibile. Validato inizialmente su Code Vein 2.
pnpm install
pnpm run build
# Deploy locale
sudo cp dist/index.js ~/homebrew/plugins/BC250-Toolkit/dist/
sudo cp main.py updater.py bios_uma.py games_db.json package.json ~/homebrew/plugins/BC250-Toolkit/
sudo systemctl restart plugin_loader- bc250-tweaks — tweaks di sistema completi + auto-update
- AMD BC-250 Docs — wiki della comunità
- bc250.info
- @AyeZeeBB — supporto CachyOS/Arch per l'installazione di umr + fallback dell'istanza GPU (integrato dal suo fork)
Lavoriamo attivamente perché questo plugin funzioni su tutti i sistemi operativi documentati per la BC-250 (documentazione della comunità) — Bazzite, SteamOS, CachyOS/Arch, Fedora… — con rilevamento automatico dell'OS (gestore pacchetti, istanza GPU) per usare il metodo giusto sulla tua distribuzione.
L'IA (Claude di Anthropic e Codex di OpenAI) è stata usata nella realizzazione di questo progetto: per reverse engineering, sviluppo e documentazione. Non per grafica o scrittura creativa. Tutto ciò che viene pubblicato è riletto da un umano, e il risultato resta sotto la mia responsabilità. Se la cosa ti dà fastidio, ora lo sai.
Se questo progetto ti è utile, puoi sostenere il suo sviluppo continuo su Ko-fi.
