Juega tus ROMs de Game Boy, Game Boy Color y Game Boy Advance desde el sidebar de VS Code, emulado en JavaScript puro dentro del propio panel: GBA vía react-gbajs (envuelve GBA.js de Endrift, el mismo autor de mGBA); GB/GBC vía GameBoy-Online de Grant Galitz.
Monorepo
/src — Extensión VS Code (backend)
/webview — App React (frontend), incluye los núcleos del emulador
/games — Juegos incluidos con la extensión, siempre disponibles (ver "Uso")
Instalación y build
Instala dependencias raíz y frontend:
npm install
cd webview && npm install
Compila todo (frontend + extensión):
npm run build
Ejecuta en VS Code (F5 o "Run Extension")
Uso
Al abrir el panel "Happy Hour Code" por primera vez, un asistente de 3 pasos explica la extensión y obliga a elegir una carpeta propia de ROMs (.gba/.gb/.gbc) — es obligatoria porque ahí se guardan siempre las partidas rápidas, también las de los juegos incluidos, para que no se pierdan al actualizar la extensión.
La librería muestra dos secciones: Incluidos con la extensión (los de /games, siempre disponibles, no requieren descargar nada) y Tu carpeta (los tuyos).
Haz clic en un juego para jugarlo, embebido en el propio panel.
Esc pausa/reanuda el juego (pulsar una vez congela, pulsar otra vez continúa). Cerrar u ocultar el panel no pierde el estado (el webview sigue vivo en segundo plano).
💾/📂 arriba del reproductor: guardado y carga rápida (un estado completo, no solo la partida SRAM).
Controles (por defecto, sin configuración)
Tecla
Botón GBA
Flechas
D-pad
X
A
Z
B
Enter
Start
\
Select
A
L
S
R
Esc
Pausar / reanudar (no es un botón del juego)
Desarrollo
El frontend se construye con Vite y se carga como archivos estáticos dentro del webview.
El backend usa esbuild para el bundle.
react-gbajs es JavaScript puro (sin WebAssembly ni Web Workers), así que se integra como cualquier dependencia npm normal — sin pasos de build especiales ni requisitos de aislamiento de origen cruzado. (Se evaluó primero @thenick775/mgba-wasm, el núcleo real de mGBA compilado a WASM con hilos, pero requiere SharedArrayBuffer/crossOriginIsolated, algo que los webviews de extensiones de VS Code no exponen — no hay forma de activarlo desde la extensión.)
Trae su propia BIOS de reemplazo integrada (sin BIOS oficial de Nintendo).
Estructura
/src/extension.ts — Lógica del sidebar, asistente de bienvenida, carpeta de ROMs y persistencia
/src/webviewHtml.ts — HTML del webview y CSP
/webview/src — React app (OnboardingWizard, LibraryView, PlayerView con react-gbajs, GbPlayerView con GameBoy-Online)
Notas
No uses Webpack ni mezcles frontend/backend.
El icono del sidebar está en icon.svg.
Following extension guidelines
Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.
