Vai al contenuto
← Tutti i progetti

Circolo a Vapore

Un circolo del gioco che vive su una porta di localhost: briscola, scala 40, machiavelli, sette e mezzo, scale e serpenti e il solitario, aperti dal browser di chiunque sia sulla stessa Wi-Fi. I posti liberi li occupano gli automi, ogni tavolo ha la sua chat e le carte sono disegnate a mano in SVG dentro il progetto. È stato scritto interamente da Claude: io ci ho messo soltanto le idee.

Node.jsTypeScriptExpressSocket.IOesbuildESLintSVGHTMLCSSClaude Code
Screenshot di Circolo a Vapore

I sei giochi

Dentro al Circolo ci sono sei tavoli, ognuno con le sue regole e la sua interfaccia:

  • Briscola, da 2 a 5 giocatori: in due, tre e cinque ognuno per sé, in quattro a coppie con il dirimpettaio. Con tre giocatori si toglie un 2 dal mazzo, come da tradizione. I punti presi si scoprono solo a fine partita — e sono nascosti anche lato server, così non si può sbirciare.
  • Scala 40, da 2 a 6, con le regole del regolamento FISCA: apertura a 40 punti, attacchi ai giochi di tutti, sostituzione del jolly, eliminazione a 101.
  • Machiavelli, da 2 a 5: si può riordinare liberamente tutto il tavolo — spezzare scale, rubare una carta a un poker per farne un altro — lavorando su una bozza che gli altri vedono soltanto quando la confermi.
  • Sette e mezzo, da 2 a 6: c’è il banco, ci sono i gettoni virtuali, la matta (il re di denari) da valutare a piacere e il quattro da bruciare.
  • Scale e Serpenti, da 2 a 6: tabellone di 100 caselle disegnato in SVG, scale a pioli in ottone che salgono e serpentine di vapore in rame che scendono, e sulla 100 si arriva solo col numero esatto. Con la variante serpenti vivi i serpenti strisciano per il tabellone a ogni tiro: la scorciatoia che avevi adocchiato può non esserci più.
  • Solitario, da soli, per quando al circolo non c’è nessun altro: il Klondike dei vecchi Windows, con suggerimento, annulla senza limiti, la variante a tre carte e il completamento automatico che fa salire le carte sulle basi in cascata.

Tavolo di briscola in quattro con le carte giocate al centro Briscola in quattro, a coppie: il compagno è il dirimpettaio, la briscola sta accanto al tallone e le mani prese si contano sotto ogni giocatore.

Tavolo di scala 40 con i giochi calati Scala 40: i giochi calati sul tavolo, col jolly etichettato dalla carta che sta sostituendo.

Tavolo di machiavelli con quattro giochi e la mano in basso Machiavelli: i contatori in alto dicono quante carte hai calato e quanti giochi restano da sistemare, i bordi tratteggiati sono i gruppi toccati nella bozza.

Tavolo di sette e mezzo con il banco e la fila delle puntate Sette e mezzo: il banco, i gettoni di tutti e la fila delle puntate; la prima carta la vedi solo tu.

Tabellone di scale e serpenti con le pedine e il dado Scale e Serpenti: cento caselle disegnate in SVG, con le posizioni di tutti, il dado e il diario degli ultimi tiri.

Tabellone di scale e serpenti con i serpenti spostati dalle caselle tradizionali Serpenti vivi: dopo qualche giro i serpenti non sono più dove li mette il tabellone tradizionale. Strisciano sempre dopo il tiro, mai prima, e non vanno a mordere una pedina ferma.

Partita a solitario con le sette colonne e il suggerimento sul tallone Il solitario: sette colonne, quattro basi e il tallone, qui evidenziato in rame dal suggerimento. Le carte coperte non escono dal server finché non si girano.

Che cosa sa fare

Si gioca in casa, sulla stessa Wi-Fi. Si avvia il server su un computer e tutti gli altri — telefoni, tablet, altri PC — aprono un indirizzo nel browser. Niente da installare, niente account, nessun servizio esterno di mezzo: il tavolo è la rete di casa.

Si invita con un link. Nella sala d’attesa c’è il collegamento del tavolo da mandare all’amico su WhatsApp o Telegram: chi lo apre si siede direttamente lì, senza cercare il tavolo nella lobby. Quando mandare un link non è comodo, c’è il codice del tavolo da dettare a voce.

Gli automi riempiono i posti vuoti. Si può creare un tavolo per sei e avviare la partita da soli: i posti liberi li prendono i bot. Se qualcuno si disconnette a partita avviata il suo posto non salta, un automa subentra e gioca al posto suo; chi torna rientra dalla lobby con lo stesso nome e si riprende le sue carte.

Tre livelli di bravura, diversi in ogni gioco. Novizio, Consueto e Maestro si scelgono quando si crea il tavolo, e ogni gioco ha le sue manopole: a briscola cambia quanto l’automa si distrae e da quanti punti in su gli conviene prendere; a scala 40 se vede la sostituzione del jolly; a sette e mezzo quanto è temerario nel chiedere carta con sei in mano. Il livello non tocca mai le regole: un Novizio gioca male, ma gioca legale.

Ogni tavolo ha la sua chat. I messaggi compaiono anche come nuvolette accanto a chi li scrive, rivolte verso il centro del tavolo, e in corsivo scorrono gli annunci di chi entra, chi esce e chi si scollega. Sul telefono la chat è un cassetto che si apre col 💬, con il contatore dei messaggi non letti.

Le carte sono disegnate nel progetto. Quaranta carte italiane, i mazzi francesi con e senza jolly, e il tabellone di scale e serpenti: tutto in SVG scritto a mano, nessuna immagine scaricata da fuori. C’è anche una galleria che mostra i mazzi carta per carta.

Il server è l’unico arbitro. I client mandano azioni e ricevono lo stato filtrato per il loro posto: le carte degli avversari non escono mai dal server, e una mossa non valida viene rifiutata con un messaggio senza toccare la partita.

Le regole sono testate a macchina. Una suite di simulazioni fa giocare gli automi fra loro — mille e duecento partite di briscola, mani e mani di scala 40 e di machiavelli — e controlla che le carte non si perdano né si duplichino, che le partite finiscano sempre e che nessun automa provi mai una mossa illegale. Un test end-to-end fa lo stesso contro il server vero, con tanto di disconnessione e rientro.

Lobby con la creazione del tavolo e i livelli degli automi La lobby: numero di giocatori, bravura degli automi con le tre descrizioni a confronto e l’indirizzo da passare a chi è sulla stessa Wi-Fi.

Sala d’attesa con il link d’invito e i posti liberi che diventeranno automi La sala d’attesa: il link d’invito da mandare all’amico, il codice da dettare a voce e i posti rimasti liberi, che diventano automi appena si avvia la partita.

Nuvoletta di chat accanto al giocatore durante una partita La chat del tavolo: ogni messaggio compare per qualche secondo anche come nuvoletta accanto a chi lo ha scritto.

Galleria delle quaranta carte italiane La galleria: i mazzi carta per carta, tutti disegnati in SVG dentro il progetto.

Tecnologie usate

Server Node.js con Express per i file statici e Socket.IO per il tempo reale: tavoli, turni, automi e chat vivono tutti nello stesso processo. Tutto il progetto — server, regole, automi, interfaccia e test — è in TypeScript con i controlli più severi che il compilatore consente (strict, noUncheckedIndexedAccess, exactOptionalPropertyTypes e compagnia), più ESLint con le regole type-checked di typescript-eslint: niente any, niente asserzioni !, niente cast. Node esegue il TypeScript direttamente, senza compilarlo; per il browser l’interfaccia viene impacchettata da esbuild insieme alle regole condivise e al client di Socket.IO. Nessun framework: il tema steampunk è scritto a mano in CSS, comprese le regole per il telefono, e le carte e il tabellone sono SVG generati da codice.

Il dettaglio che mi piace di più è che i motori delle regole sono file unici, usati sia dal server sia dal browser: il client può dire subito perché una combinazione non è valida, e non esiste il rischio che client e server la pensino diversamente. Anche gli eventi di Socket.IO sono tipizzati una volta sola e condivisi dalle due parti; il server però tratta come unknown tutto quello che arriva dalla rete e ne controlla la forma prima di usarlo, perché un client manomesso può mandare qualsiasi cosa.

Il passaggio da JavaScript a TypeScript ha anche fatto emergere qualche bug che nessun test aveva visto: un’azione null bastava a far cadere il server, un tavolo di tipo __proto__ nasceva rotto e a briscola un indice non numerico giocava la prima carta della mano.

L’ha scritto Claude, dall’inizio alla fine

Non ho scritto una riga di questo progetto. Il codice — motori delle regole, euristiche degli automi, interfaccia, carte in SVG, test — l’ha scritto tutto Claude, con Claude Code. Io ci ho messo le idee: quali giochi aggiungere, come dovevano comportarsi gli automi, che aspetto doveva avere il tavolo, che cosa non funzionava dopo averci giocato una sera. Il resto è stato una lunga conversazione, un gioco alla volta.