miniengine docs API-referentie (pdf)
Menu

Een game bouwen

Op deze pagina

Testen op meerdere apparaten

Een spel voor een hele tafel test je met een hele tafel. Je hebt minimaal een spelleider, twee spelers en een gedeeld scherm nodig. Dat kan in één browser met losse vensters, maar test ook een paar keer op echte telefoons.

Opzet #

  1. Start de engine op je netwerk: MINI_ENGINE_BIND=0.0.0.0:3000 cargo run.
  2. Open http://<LAN-IP>:3000/demo op je computer en maak een kamer.
  3. Doe mee met twee telefoons, of met twee privévensters. Kamersleutels staan in sessionStorage per tabblad, dus elk tabblad is een eigen deelnemer.
  4. Open het gedeelde scherm vanuit de spelleiderspagina.

Checklist #

Klaarzetten en rondes

  • Starten lukt pas als iedereen klaarstaat.
  • Afronden en terug naar de lobby reset klaarstatus en spelstand.
  • Een tweede ronde werkt net zo goed als de eerste.

Later aansluiten

  • Als je spel supports_late_join: false heeft: een speler kan tijdens het spel niet meer instromen.
  • Als het wel mag: een late speler krijgt een bruikbare weergave midden in een ronde.

Wegvallen en terugkomen

  • Ververs een spelerspagina midden in een ronde: de stand is er meteen weer.
  • Zet een telefoon even op slot en open hem weer.
  • Sluit het spelleiderstabblad en open het opnieuw. Bij een eigen spel wachten spelers zolang; acties geven host_offline.
  • Herstart de engine. Opgeslagen state en sleutels blijven, aanwezigheid begint offline en apparaten verbinden opnieuw.

Conflicten

  • Druk snel achter elkaar op knoppen van de spelleider en laat spelers tegelijk een actie sturen. Je wachtrij moet version_conflict voorkomen.

Privacy

  • Speler A ziet nooit de private_state van speler B.
  • Het gedeelde scherm toont geen geheime gegevens.
  • Antwoorden staan pas in public_state na een expliciete onthulling.

Ongeldige invoer

  • Stuur een actie met verkeerde data vanuit de browserconsole. De host moet haar negeren of weigeren.
  • Probeer instellingen buiten het schema. De engine weigert ze met 400.

Telefoonschermen

  • Bekijk de spelerspagina op een smal scherm (360 pixels breed) zonder horizontaal scrollen.
  • Is het gedeelde scherm leesbaar vanaf de bank?

Geautomatiseerde controles #

In de SDK-checkout:

Shell
npm run check         # typecontrole, build, strikte TypeScript-consumer, tests
npm run test:package  # tarball maken, installeren, CLI draaien

Een optionele test speelt het gegenereerde stemspel tegen een echte engine. Bouw eerst de engine met cargo build, dan:

Shell
MINI_ENGINE_CHECKOUT=/absoluut/pad/naar/mini-engine npm run test:engine

Die test start een geïsoleerde engine met een tijdelijke database, laadt het gegenereerde package via de echte catalogus en draait alle drie de rolscripts in een DOM-harnas met echte websockets. Hij controleert klaarzetten, starten, gelijktijdige stemmen, gedeelde totalen en een nieuwe ronde. Opmaak en WebGL test je daarmee niet; daarvoor blijft een echte browser nodig.

De engine zelf heeft een Playwright-suite die met echte HTTP en websockets meerdere rollen, telefoons en het tv-scherm test:

Shell
npm ci
npm run build:server
npx playwright install chromium
npm run test:browser