# Core mGBA WASM con lockstep Versión modificada del core de [thenick775/mgba](https://github.com/thenick775/mgba/tree/feature/wasm) (rama `feature/wasm`, base de `@thenick775/mgba-wasm` 2.6.0), licencia **MPL-2.0**. - `UPSTREAM`: commit exacto de upstream. - `patches/`: cambios de GBA Link Online sobre ese commit (código fuente de las modificaciones, MPL-2.0). - `pkg/`: paquete npm local con el resultado compilado (`mgba.js`, `mgba.wasm`). ## Qué añade el parche (`src/platform/wasm/main.c`) Sobre el link local de dos consolas (`linkLocalStartSession`): | Función (`Module._…`) | Para qué | |---|---| | `linkLocalSetGate(on)` | Lockstep: cada consola espera la entrada de cada frame antes de ejecutarlo | | `linkLocalPushInput(player, frame, keys)` | Entrada de un jugador para un frame (bitmask GBA) | | `linkLocalGetFrame(player)` | Frames completados por esa consola | | `linkLocalSetKeys(player, keys)` | Teclas de un jugador sin gate | | `linkLocalGetVideoBuffer(player)` / `GetVideoSeq` | Pantalla de cada consola (240×160, 32 bits) para mostrar ambas | | `linkLocalSetAudioPlayer(player)` | Qué consola suena (0 = la activa) | | `linkLocalSetHashInterval(n)` / `GetHash(player, frame)` | Hash de EWRAM+IWRAM cada n frames (detección de desync) | | `linkLocalRequestSaveState` / `RequestLoadState` / `GetOpResult` / `GetStateData` / `GetStateSize` | Save/load state en un frame exacto (resincronización) | | `linkLocalRequestSaveAll(frame)` / `linkLocalSetLoadData` / `linkLocalRequestLoadAll(frame)` / `linkLocalGetStateFrames` | Save/load state de LAS DOS consolas en el mismo instante (resincronización online). El estado del cable va dentro del save state de mGBA | | `linkLocalAlloc` / `linkLocalFree` | Memoria para pasar save states desde JS | Además: - **Turnos deterministas** (`src/core/thread.c` + `main.c`): el coordinador de link de mGBA deja emular a las dos consolas a la vez y el resultado depende del planificador de hilos (la RAM diverge entre ejecuciones). El parche añade el hook `mCoreThreadLockstepTurn`: solo emula una consola por turno (un `runLoop`) y el turno se decide solo con estado emulado (ciclos de cada consola y si el coordinador la ha dormido). Así dos clientes con las mismas entradas ejecutan exactamente lo mismo. - **Línea SD del cable** (`src/gba/sio/lockstep.c`, `_setReady`): mGBA solo marcaba "todas listas" cuando todas las consolas estaban ya en modo multijugador. En hardware, SD es una línea con pull-up que solo baja una GBA en modo multijugador que no está lista, así que la hija ve SD alto aunque la otra siga en un menú. Yu-Gi-Oh! WC 2006 se rinde si no ve SD enseguida: sin este cambio el link solo conectaba si los dos jugadores entraban en "Link Duel" con ≤1 frame de diferencia. - Arreglo de upstream `62a51a2` (comparación de timestamps de eventos con vuelta). - El link arranca aunque el navegador no tenga Web Audio (sin sonido), y se exporta `HEAPU8`. ## Compilar Lo hace GitHub Actions (`.github/workflows/build-core.yml`) con la imagen Docker del autor: clona upstream en `UPSTREAM`, aplica `patches/*.patch`, compila y publica el artefacto `mgba-wasm-link`. Luego se copia a `pkg/dist/`: ```powershell gh run download --name mgba-wasm-link --dir core/pkg/dist ```