Racerz

Jeu web de course 2D (canvas), voir AGENTS.md pour l'architecture. Prod : https://racerz-jet.vercel.app

Comptes joueurs (optionnel, Supabase)

Sans configuration, le jeu fonctionne comme avant : progression sauvegardée dans le navigateur (localStorage). Pour activer les comptes (inscription / connexion, progression sauvegardée par compte) :

1. Créez un projet sur supabase.com (Authentication → Providers → Email activé).

2. Dans SQL Editor, exécutez le contenu de supabase/schema.sql (rejouable sans risque).

3. Renseignez les deux variables suivantes (Project Settings → API), en local dans .env.local et sur Vercel (Project → Settings → Environment Variables), puis redéployez :

   NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
   NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...   # clé « anon » publique, jamais la clé service_role
   

Sécurité : les mots de passe ne sont jamais gérés par le jeu (Supabase Auth). La table profiles est protégée par Row Level Security : chaque joueur ne lit que sa ligne et aucun client ne peut l'écrire. Achats, gains, paliers et niveaux passent par des fonctions SQL (buy_car, buy_skin, settle_race…) qui recalculent l'argent côté serveur (prix, solde, gains par place). Limite connue : le résultat d'une course est rapporté par le navigateur (pas de simulation serveur) ; il est borné par un ticket start_race à usage unique et une durée minimale de 20 s. Si vous changez des prix, des gains ou la règle de la victoire propre (contacts barrière : 4 en Campagne, 2 ailleurs) dans src/game/garage.ts, reportez-les dans supabase/schema.sql ; après une mise à jour de ce fichier, rejouez-le dans le SQL Editor (le jeu continue de marcher avant : il retombe sur l'ancienne fonction settle_race, avec la règle à 2 contacts).

À la première connexion, une progression locale existante peut être reprise sur le compte (une seule fois, vérifiée et plafonnée à 500 000 € côté serveur).

Multivers (le mode en ligne)

Bouton « 🌌 Multivers » du lobby (le nom est dans src/game/net/label.ts) : partie rapide contre de vrais joueurs (même environnement, 2 à 4 pilotes) ou salle entre potes (code à 4 caractères ou lien ?room=CODE, l'hôte choisit l'environnement et lance). C'est le même jeu, les mêmes 4 environnements, les mêmes gains.

• Il utilise Supabase Realtime (diffusion + présence : aucune table, aucun SQL à rejouer) avec les mêmes deux variables NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY que les comptes. Sans elles, le bouton explique que le mode en ligne n'est pas activé. Le plan gratuit limite le débit (≈ 100 messages par seconde pour tout le projet, soit une seule course à quatre à la fois) : chaque joueur envoie 15 instantanés par seconde à deux, 10 à trois, 6 à quatre ; le plan Pro porte la limite à 500.
• Départ commun : personne ne part avant que tous les pilotes soient prêts (course construite, 3D chargée : l'écran affiche « En attente des autres pilotes… 2/4 prêts »), puis l'hôte donne un seul feu vert à tout le monde. Il est envoyé comme une durée (« dans 4 s »), corrigée du temps de trajet mesuré, donc il ne dépend ni de l'heure des machines ni de leur vitesse de chargement : écart de quelques centièmes de seconde entre les départs. Un pilote trop lent n'est attendu que 25 s ; s'il arrive après, il rejoint la course là où elle en est. Hôte parti ou bloqué : le pilote suivant donne le feu vert.
• Pour l'essayer sans serveur : ouvrir deux onglets d'un même navigateur sur /?net=local (les onglets se parlent par BroadcastChannel).
• Limites : pas d'anti-triche (chaque jeu simule sa propre voiture et croit les autres), les dangers (ours, yéti, bombes du volcan) visent chaque joueur pour son propre compte. Voir AGENTS.md pour le détail.
• pnpm check:net vérifie le protocole, les salles, la partie rapide et une course complète sur un réseau simulé (délai, gigue, pertes), sans serveur ni navigateur.

Développement

pnpm install
pnpm dev          # http://localhost:3000
pnpm lint
pnpm check:tracks # contrôle des tracés (Node 22.18+ / 25)
pnpm check:net    # mode en ligne : protocole, salles, partie rapide, course sur réseau simulé
pnpm sim          # courses simulées pour régler les bots

---

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.