rps-royale/docs/GAME_DESIGN.md
Ubuntu c2cd2e7b3a docs: add game design doc and update README with current features
- Add GAME_DESIGN.md with complete mechanics, economy, modes,
  visual and audio design documentation
- Update README with procedural audio/graphics features,
  AI mode, guest play, and links to all docs

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 13:38:05 +00:00

3.1 KiB
Raw Permalink Blame History

Game Design — The Arena RPS Royale

Concept

The Arena RPS Royale est un jeu multijoueur Pierre-Feuille-Ciseaux en 2D premium avec paris basés sur la blockchain. Le gameplay repose sur un pattern commit-reveal garantissant l'impossibilité de tricher.

Mécaniques de jeu

1. Commit (Phase de verrouillage)

  • Le joueur choisit son signe (Pierre, Feuille ou Ciseaux)
  • Le frontend calcule un hash : keccak256(choice + nonce)
  • Le joueur envoie le hash au serveur et, si wallet connecté, à la blockchain
  • Le choix reste secret : impossible de le deviner à partir du hash

2. Suspense (Phase de tension)

  • Quand les deux joueurs ont commité, une phase de suspense démarre
  • Zoom caméra, shake, particules intenses
  • Compte à rebours de 4 secondes
  • Audio : riser montant + heartbeat

3. Reveal (Phase de révélation)

  • Les joueurs révèlent leur choix + nonce
  • Le serveur (et le smart contract) vérifient que le hash correspond
  • Le gagnant est déterminé selon les règles classiques

4. Résultat (Cinématique)

  • Les icônes s'animent depuis les côtés et se heurtent au centre
  • Explosion de particules colorées selon le résultat
  • Affichage du gain ou de la perte
  • Audio : fanfare de victoire, son de défaite, ou son de match nul

Économie

  • Mise minimale : 0.001 ETH (configurable)
  • Frais plateforme : 3%
  • Gain : 97% du pot total au gagnant
  • Match nul : remboursement 100%

Modes de jeu

Matchmaking (multijoueur)

  • Queue automatique par montant de mise
  • Appariement des deux joueurs
  • Match enregistré sur la blockchain

Contre l'IA (solo)

  • Si aucun adversaire n'est disponible, l'IA simule un adversaire
  • Délai de réponse aléatoire (13s) pour le commit et le reveal
  • Pas de transaction blockchain nécessaire
  • Adresse IA : 0xA1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1

Sans wallet (invité)

  • Le jeu génère automatiquement une adresse guest si MetaMask n'est pas détecté
  • L'invité peut jouer en mode IA sans connecter de wallet

Expérience visuelle

Scènes Phaser

Scène Description
BootScene Écran titre avec particules flottantes, avatars tournants, glow pulsant
LobbyScene Liste des tables, boutons de matchmaking, mode IA
ArenaScene Arène cyberpunk avec grille perspective, colonnes néons, avatars, VS badge
ResultScene Cinématique de clash des icônes avec explosion de particules

Effets visuels

  • Particules : étincelles flottantes, explosions d'impact
  • Camera : zoom, shake, flash
  • Tweening : pulsations, déplacements, apparitions
  • Glow : halos néons autour des textes et avatars

Audio procédural

  • Lobby : drone basse ambiant
  • Clic : son triangulaire court
  • Commit : montée de fréquence carrée
  • Suspense : riser sawtooth + heartbeat
  • Victoire : fanfare arpégée + bruit blanc
  • Défaite : descente de fréquence sawtooth
  • Impact : bruit blanc filtré exponentiellement

Contrôles

  • Souris : survol, clic sur les boutons et icônes
  • MetaMask : connexion wallet (optionnel)