Skip to content

Latest commit

 

History

History
217 lines (154 loc) · 11.9 KB

README.es.md

File metadata and controls

217 lines (154 loc) · 11.9 KB

BC250 Toolkit — Plugin DeckyLoader

Nuevo en v0.6.3: al seleccionar una notificación de configuración automática se abre la página del juego en la biblioteca de Steam; los errores de actualización muestran detalles y un enlace a la versión.

🌐 EN · FR · DE · ES · IT · PT · NL · PL · RU

Un plugin de DeckyLoader para el ASRock BC-250 (AMD Ryzen Embedded V2000 / Cyan Skillfish) con Bazzite, SteamOS Linux o CachyOS.

Base de datos comunitaria de opciones de lanzamiento optimizadas para el BC-250 — aplicables con un clic desde el Quick Access Menu de Steam.


📸 Capturas de pantalla

Games tab CU/UMA tab

UMA frame buffer System tab

Funcionalidades

Pestaña Juegos

  • Detecta automáticamente el juego seleccionado en la biblioteca de Steam
  • Muestra la configuración recomendada para el BC-250 (versión Proton, opciones de lanzamiento, notas, requisitos de hardware)
  • Variantes de configuración — cuando un juego ofrece varios perfiles optimizados (p. ej. Stable vs Performance), se elige uno con un selector; la elección se recuerda
  • Botón Aplicar — en una sola acción escribe las opciones de lanzamiento, selecciona el build de Proton/GE-Proton y aplica los overrides de GPU por juego (opciones RADV de ~/.drirc)
  • Auto-apply (opt-in) — aplica la configuración completa automáticamente al iniciar un juego conocido; al activarlo también preconfigura todos los juegos instalados que estén en la base de datos

Pestaña CU/UMA (Compute Units y VRAM)

  • Lectura en vivo del número de CU activos a través de los registros SPI de la GPU
  • 4 perfiles:
    • 24 CU (BC-250 estándar)
    • 32 CU
    • 36 CU
    • 40 CU (completo — todos los WGP activos)
  • Aplicación en vivo sin reinicio
  • Toggle Guardar al arranque — instala un servicio systemd que restaura el perfil en cada inicio
  • Requiere umr — instalación automática con un botón (rpm-ostree en Bazzite/SteamOS, pacman en CachyOS/Arch)
  • Aviso y recomendaciones de estabilidad integrados
  • Gestión de VRAM (UMA) — ajusta el UMA Frame Buffer Size del BIOS (Auto / 2G / 4G / 8G) directamente desde el panel parcheando la variable NVRAM EFI (AmdSetup) — sin pasar por la pantalla del BIOS. Surte efecto en el próximo reinicio; el panel muestra la VRAM en vivo y el valor pendiente en el BIOS
    • Salvaguardas: lista blanca de versiones de BIOS (P3.00), verificación del layout NVRAM, copia de seguridad automática antes de cada escritura (botones desactivados en BIOS desconocidos)
    • Escribir en el BIOS requiere un bc250-tweaks actualizado (proporciona el helper root bc250-uma-helper — sin contraseña sudo)
    • Auto (≈8 GB) es el valor seguro recomendado — si aparecen artefactos gráficos (p. ej. verdes) tras un cambio, vuelve a Auto

Pestaña Tuning (con BC250 Control Center)

Con BC250 Control Center instalado (su RPM con rpm-ostree install en Bazzite y luego una vez Prepare dependencies en la app), esta pestaña es su interfaz en modo juego:

  • GPU — perfiles del governor y escalones validados
  • Compute Units — cuadrícula 4×5 en vivo, tabla guardada para el arranque y servicio de arranque
  • CPU — overclock con el detector de Control Center, escala manual y servicio de arranque
  • Ventiladores — velocidad manual por canal o vuelta a automático

El Toolkit no guarda aquí ajustes propios: usa el mismo helper protegido que Control Center, así que lo que cambias en el escritorio aparece en modo juego, y al revés. La pestaña CU también pasa por él. Sin Control Center, el resto del plugin funciona como antes; en Bazzite la pestaña ofrece un botón Instalar BC250 Control Center (RPM oficial v1.19.0, SHA-256 verificado, rpm-ostree install y reinicio), y en otros sistemas enlaza a la página del proyecto. El botón desaparece en cuanto se detecta Control Center.

Pestaña Sistema

  • Temperaturas de CPU/GPU en tiempo real, velocidad del ventilador y frecuencias GPU/CPU
  • Recursos — RAM del sistema activada (lo que queda para el SO tras la reserva UMA), RAM usada con porcentaje y número de CUs activos
  • Estado de scx_lavd, perfil tuned, estado del daemon gamemode
  • Integraciones de hardware — solo lectura: adaptador Wi-Fi con su estado de NetworkManager y su controlador, si hid_playstation está cargado y cuántos mandos hay conectados, conectores de pantalla activos, la salida de PipeWire actual y el bus HDMI-CEC cuando existe. No se activa ni se cambia nada: el panel solo informa de lo que la máquina tiene realmente, para no ofrecer nunca una función de TV o de mando que el hardware no pueda cumplir.
  • Botón de actualización manual de bc250-tweaks

Pestaña Ajustes

  • Toggle de auto-apply
  • Actualización de la DB desde GitHub
  • Acerca de — versión del plugin, autor y enlace a GitHub

Idioma de la interfaz

El plugin detecta automáticamente el idioma de Steam:

English · Français · Deutsch · Español · Italiano · Português · Nederlands · Polski · Русский


Instalación

Vía DeckyLoader (recomendado)

  1. Activa el modo desarrollador en los ajustes generales de Decky
  2. Ajustes de Decky → Desarrollador → Instalar plugin desde URL: https://github.com/Necrosiak/bc250-toolkit-decky/releases/latest/download/BC250-Toolkit.zip

Distribución directa vía GitHub: la URL de arriba siempre apunta a la última release y, después, el plugin se mantiene al día con su auto-update integrado.

Instalación manual mientras tanto:

git clone https://github.com/Necrosiak/bc250-toolkit-decky.git \
  ~/homebrew/plugins/BC250-Toolkit
sudo systemctl restart plugin_loader

Requisitos

  • DeckyLoader instalado
  • Bazzite, SteamOS o CachyOS en BC-250

Base de datos de juegos

La DB está en games_db.json y se actualiza automáticamente desde GitHub.

Juegos compatibles

Juego Proton Notas
Crimson Desert Proton Experimental (bleeding-edge) Spoof GPU 731F necesario
Cyberpunk 2077 GE-Proton RT desactivado recomendado
Elden Ring GE-Proton ~60 FPS jugable
Red Dead Redemption 2 GE-Proton Modo Vulkan obligatorio
Control GE-Proton RT funciona (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 mínimo 4 GB requerido
Detroit: Become Human Proton Experimental 60 FPS estable
The Last of Us Part I GE-Proton 60 FPS Medio-Alto
Black Myth: Wukong GE-Proton Archivos del juego sin modificar
Code Vein 2 GE-Proton UE5 DX12 — requiere UMA Frame Buffer = Auto (~8G) + fix unified-heap por juego (auto-aplicado, ver preset abajo)
Stardew Valley Proton Experimental Perfecto

Juegos incompatibles conocidos

  • Fortnite / Valorant — EAC a nivel de kernel, incompatible con Linux
  • FF VII Rebirth — Verifica el ID de GPU, Cyan Skillfish no reconocido, sin solución disponible

Contribuir

🐛 Bugs e ideas: ¡abre issues! Cada informe orienta directamente la próxima release. Bastan unas líneas — idealmente con tu OS (Bazzite, CachyOS…), la versión del plugin, la pestaña del QAM afectada y, si puedes, los logs (~/homebrew/logs/BC250-Toolkit/, journalctl -u plugin_loader). Las peticiones de funciones y los «funciona en X» son igual de bienvenidos.

Método fácil — Formulario web

Usa el formulario de envío — rellena los datos, haz clic en Enviar y se creará un issue en GitHub automáticamente. Tras su aprobación, el juego se añade mediante PR.

Método desarrollador — PR directa

  1. Haz un fork de este repositorio
  2. Edita games_db.json siguiendo el formato existente
  3. Abre un Pull Request

Formato de entrada

"STEAM_APP_ID": {
  "name": "Nombre del juego",
  "proton": "GE-Proton10-34",
  "launch_options": "MANGOHUD=1 MANGOHUD_CONFIG=no_display gamemoderun %command%",
  "notes": "Notas específicas del BC-250",
  "tested_on": "BC-250"
}

Campos avanzados opcionales (el plugin los aplica automáticamente al pulsar Aplicar):

  • compat_tool — build de Proton/GE-Proton a seleccionar mediante el mapeo de compatibilidad de Steam
  • radv — overrides de Mesa RADV por juego escritos en ~/.drirc, con match por el nombre del ejecutable, p. ej. {"match": "Game-Win64-Shipping.exe", "options": {"radv_enable_unified_heap_on_apu": false}}
  • requires — requisitos de hardware mostrados al usuario (uma_min_mb, gttsize)
  • configs — array de variantes alternativas, cada una con su label, stability, compat_tool, launch_options, radv, requires; el usuario elige una en la pestaña Juegos

El AppID de Steam se encuentra en la URL de la página del juego en Steam Store.

Preset reutilizable — UE5 DX12 «out of video memory»

Algunos juegos Unreal Engine 5 en DX12 fallan al inicializar el render (D3D12Util.cpp:926 — Out of video memory) aun con mucha VRAM libre, porque el unified heap de RADV en APU oculta la VRAM dedicada a VKD3D (DedicatedVideoMemory ≈ 0). games_db.json incluye un perfil reutilizable ue5_dx12_oom en _meta.presets: desactivar el unified heap para el ejecutable del juego + poner el UMA Frame Buffer del BIOS en Auto (ya da ~8 GB en un BC-250 de 16 GB — no hace falta forzar 4G) + usar GE-Proton para los códecs de vídeo. Para arreglar un juego nuevo afectado, copia el preset en su entrada y ajusta radv.match a su ejecutable. Validado primero en Code Vein 2.


Build (desarrolladores)

pnpm install
pnpm run build

# Desplegar localmente
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

Ver también


Contribuidores de la comunidad

  • @AyeZeeBB — soporte CachyOS/Arch para la instalación de umr + fallback de instancia GPU (integrado desde su fork)

🐧 Compatibilidad

Trabajamos activamente para que este plugin funcione en todos los sistemas operativos documentados para la BC-250 (documentación comunitaria) — Bazzite, SteamOS, CachyOS/Arch, Fedora… — con detección automática del SO (gestor de paquetes, instancia GPU) para aplicar el método correcto en tu distribución.

Aviso sobre IA

Se usó IA (Claude de Anthropic y Codex de OpenAI) en la creación de este proyecto: para ingeniería inversa, desarrollo y documentación. No se usó para arte ni escritura creativa. Todo lo publicado lo revisa una persona, y el resultado es responsabilidad mía. Si eso te incomoda, ya lo sabes.

Apoya el desarrollo

Si este proyecto te resulta útil, puedes apoyar su desarrollo continuo en Ko-fi.

Apóyame en Ko-fi