Bienvenue dans la doc développeur
Pixel Plaza est un jeu social isométrique dans le navigateur, inspiré d'Habbo Hotel : les joueurs se retrouvent dans des chambres qu'ils décorent, chattent et échangent des objets.
Cette documentation est destinée aux contributeurs techniques du projet (développeurs, intégrateurs, opérateurs d'infra). Si tu es un joueur cherchant comment jouer, c'est par là.
Architecture en un coup d'œil
shared/ Logique pure, zéro dépendance : grille isométrique, A*, layout, protocole
client/ PixiJS 8 + Vite. Rendu, interpolation, UI, PWA
server/ Colyseus. Autoritatif : valide toute intention, simule, réplique l'état
Le principe non négociable : le client envoie des intentions, le serveur valide et simule. Un client trafiqué ne peut ni se téléporter ni spammer.
Stack technique
| Couche | Choix |
|---|---|
| Rendu client | PixiJS 8 + TypeScript strict + Vite |
| Temps réel | Colyseus (Node/TS) |
| Persistance | PostgreSQL |
| Cache/présence | Redis |
| Déploiement | Docker Swarm sur VPS beben0.com, Traefik v3 |
| Monorepo | pnpm workspaces |
Par où commencer ?
- Setup local — cloner, installer, lancer en 5 minutes
- Architecture — frontières, décisions, invariants
- Déploiement — comment ship en prod sur
pixel.beben0.com - Admin — contrat API/REST pour le panel admin
État du projet
Voir ROADMAP.md — phase 1 livrée (multijoueur), phase 1.5 (jouabilité) en cours.