Crea un gioco
Un gioco di Spindro è una cartella, una voce nel registro e le sue stringhe di testo. Nel repository trovi un gioco modello, una guida che porta da un clone nuovo a un gioco sullo schermo in circa 15 minuti, un riferimento API, le regole di design e un bot che controlla il tuo gioco.
Tre passi
- Copia la cartella modello: il gioco modello è js/games/template/tempo.js, copiato in js/games/<il tuo id>/index.js, con nome e id sostituiti.
- Aggiungi una voce al registro in js/games/registry.js. Finché il gioco non è pronto, contrassegnalo come dev così compare solo in modalità sviluppatore.
- Aggiungi le tue stringhe (name, desc, help) nei cinque file locales/en, it, fr, es e de.json ed esegui il controllo delle traduzioni.
Il percorso da 15 minuti
Servono Node 22 e git. Non c'è nessuna compilazione. Questo è l'inizio della guida:
git clone https://github.com/C1aud1o/Spindro.git && cd Spindro
git checkout -b game/mygame beta
npm ci
npm run dev
# then open http://127.0.0.1:5173/index.html?game=tempo&demo=1
mkdir js/games/mygame
cp js/games/template/tempo.js js/games/mygame/index.js
# add one line to js/games/registry.js, add games.mygame.* to the 5 locale files
npm run game:check -- mygame
Il parametro demo sostituisce il rullo con un ciclista simulato, con cursori per potenza e cadenza, così puoi giocare senza rullo. Ricarica la pagina dopo ogni modifica.

Cosa ti dà il kit
- Dati del ciclista
- hooks.stats() restituisce potenza, cadenza, marcia e battito; hooks.ftp() restituisce la FTP. Gli obiettivi sono frazioni della FTP, mai watt fissi.
- Menu e risultati
- Un solo menu di avvio (durata, livello) e una sola schermata dei risultati per ogni gioco: tieni premuto + o pedala per partire, poi stelle e record personali.
- Modalità allenamento
- Se hooks.workout() restituisce un piano, è l'allenamento a decidere obiettivi e durata.
- Strumenti HUD
- Funzioni per testi e pannelli nel hud.js del kit, per numeri leggibili sullo schermo.
- Comandi
- input(dir) riceve esattamente +1 o −1, da uno Zwift Click o dalla tastiera. Ogni gioco deve essere giocabile con + / − e i soli pedali.
- Base 3D
- Una base three.js, js/games/template/skeleton3d.js, con palco, cielo, luci e ciclista comuni.
Controllalo con il bot
Il controllo fa giocare il tuo gioco a 0,6, 0,8, 1,0 e 1,2 volte la FTP con il ciclista dimostrativo. Stampa le stelle ottenute, il tempo al primo evento, l'intervallo più lungo senza eventi, gli eventi al minuto e i millisecondi per fotogramma, e quando una regola non è rispettata dice quale e come correggere.
Le regole che un gioco segue
- Una partita è un allenamento da 5, 10 o 20 minuti, con l'intensità in percentuale della FTP del ciclista, così è equa a 120 W e a 320 W.
- Tre livelli (facile, normale, difficile) e una difficoltà che si adatta un po' dopo sforzi falliti o riusciti.
- Qualcosa da fare entro otto secondi, e mai più di cinque secondi senza un evento che chiede o premia qualcosa.
- Si gioca senza toccare lo schermo: watt e cadenza fanno il grosso, + e − fanno una cosa sola.
- Chi smette di pedalare mette in pausa il gioco; nessuno è punito perché spinge di più.
Prima di inviarlo
- Aggiungi i file che il tuo gioco importa all'elenco ASSETS di sw.js e aggiorna il nome della cache.
- Gli asset devono avere una licenza chiara (CC0, MIT, OFL o fatti per il progetto) e un credito nel README e nella pagina delle licenze.
- Un genere o una meccanica vanno bene; un clone di un gioco commerciale esistente no.
- Apri una pull request sul ramo beta, con la lista di controllo delle regole di design e la tabella del bot.