Tetardtek
da3237bf3f
Auth SuperOAuth (JWT validation + httpOnly cookie), entités users/characters/level_thresholds, lazy calculation endurance, seed 100 niveaux, config prod-ready (trust proxy, helmet, CORS, rate limit). Validé : health 200, auth flow, character CRUD, endurance lazy, 401 sans cookie.
525 lines
17 KiB
Markdown
525 lines
17 KiB
Markdown
# TetaRdPG — Game Design Document
|
||
|
||
> Version : 1.0 — Mars 2026
|
||
> Statut : Conception — pré-production
|
||
> Type : Idle-RPG textuel communautaire | Extension Twitch + Site Web
|
||
|
||
---
|
||
|
||
## Pitch
|
||
|
||
TetaRdPG est un RPG communautaire asynchrone intégré à Twitch.
|
||
Les viewers créent un personnage, le font progresser via des actions consommant de l'endurance,
|
||
et interagissent avec le stream et la communauté en temps réel.
|
||
|
||
**Ce qui rend ce jeu unique :**
|
||
- L'engagement Twitch (Bits, abonnements, points de chaîne) est une ressource de jeu
|
||
- La progression est persistante et stratégique, pas un simple clicker
|
||
- La communauté joue ensemble — succès collectifs, boss mondiaux, guildes
|
||
|
||
---
|
||
|
||
## Piliers de design
|
||
|
||
| Pilier | Description |
|
||
|--------|-------------|
|
||
| **Stratégie** | Chaque action coûte de l'endurance — gérer sa ressource est central |
|
||
| **Persistance** | La progression survit aux streams, les choix ont des conséquences durables |
|
||
| **Communauté** | Les objectifs collectifs sont aussi importants que la progression individuelle |
|
||
| **Intégration Twitch** | L'activité sur le stream a une valeur en jeu directe |
|
||
|
||
---
|
||
|
||
## Systèmes Core
|
||
|
||
### Endurance
|
||
|
||
L'endurance est la ressource principale. Elle régule toutes les actions du joueur.
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Base | 100 pts |
|
||
| Maximum (avec équipement) | 150 pts |
|
||
| Recharge passive | 10 pts / heure (1 pt toutes les 6 min) |
|
||
|
||
**Recharge active :**
|
||
- 1 TetardCoin → +20 endurance
|
||
- Potions : +25 / +50 / +100 endurance
|
||
|
||
**Coût des actions :**
|
||
|
||
| Action | Coût endurance |
|
||
|--------|---------------|
|
||
| Combat | 10 |
|
||
| Entraînement (léger) | 20 |
|
||
| Entraînement (moyen) | 40 |
|
||
| Entraînement (intensif) | 60 |
|
||
| Quête (facile) | 15 |
|
||
| Quête (moyenne) | 30 |
|
||
| Quête (difficile) | 50 |
|
||
| Fuite en combat | 5 |
|
||
|
||
---
|
||
|
||
### Combat PvE
|
||
|
||
**Format :** tour par tour — Attaque / Défense / Objet / Fuite
|
||
|
||
**Formules de dégâts :**
|
||
|
||
| Type | Formule |
|
||
|------|---------|
|
||
| Mêlée | Arme + (Force × 1.5) |
|
||
| Distance | Arme + (Agilité × 1.5) |
|
||
| Magique | Arme + (Intelligence × 1.5) |
|
||
|
||
**Mécanique défensive :**
|
||
- Réduction selon type d'armure + coefficient de défense
|
||
|
||
**Coups critiques et esquive :**
|
||
|
||
| Mécanique | Formule | Effet |
|
||
|-----------|---------|-------|
|
||
| Critique | 5% + (Chance × 0.2%) | Dégâts × 1.5 |
|
||
| Esquive | 5% + (Chance × 0.1%) | Annule les dégâts |
|
||
|
||
**Fin de combat :**
|
||
- Victoire → XP + Or + loot + récupération 10% PV
|
||
- Défaite → retour auberge, -50 endurance, perte d'or
|
||
- Récupération PV hors combat → 10% PV toutes les 15 min
|
||
|
||
---
|
||
|
||
### Progression & Niveaux
|
||
|
||
**Courbe XP :** `XP requise = 100 × N^1.5`
|
||
|
||
| Niveau | XP requise (cumulé) |
|
||
|--------|-------------------|
|
||
| 2 | 283 |
|
||
| 10 | 3 162 |
|
||
| 50 | 35 355 |
|
||
| 100 | 100 000 |
|
||
|
||
**Niveau maximum :** 100, puis **Niveau Beta** *(définition à préciser — prestige, cosmétique ?)*
|
||
|
||
**Statistiques :**
|
||
- 5 stats : Force, Agilité, Intelligence, Chance, Vitalité
|
||
- Base : 5 points à répartir à la création
|
||
- Gain : +5 points par niveau
|
||
- Plafond : 101 par stat (via entraînement et équipement)
|
||
- PV de base : 100 (Vitalité influence le max)
|
||
|
||
**Déblocages par niveau :**
|
||
|
||
| Niveau | Déblocage |
|
||
|--------|-----------|
|
||
| 5 | Quêtes moyennes |
|
||
| 10 | Forge |
|
||
| 15 | Boutique avancée |
|
||
| 20 | Quêtes difficiles + Guildes |
|
||
| 30 | Équipements épiques |
|
||
| 50 | Succès communautaires + Quêtes d'élite |
|
||
|
||
---
|
||
|
||
### Artisanat & Forge
|
||
|
||
**Forge** (accès niveau 10+)
|
||
|
||
Améliore les équipements existants : +stat, effet spécial, bonus set anticipé.
|
||
|
||
| Niveau d'amélioration | Résultat | Risque |
|
||
|----------------------|----------|--------|
|
||
| Niv. 1 – 2 | Succès garanti | Aucun |
|
||
| Niv. 3 | Succès / Échec | 20% perte matériaux |
|
||
| Niv. 4 | Succès / Échec | 30% perte matériaux |
|
||
| Niv. 5 | Succès / Échec | 40% perte matériaux |
|
||
|
||
Coût max : 12 TetardCoin (succès garanti, tous niveaux)
|
||
|
||
**Artisanat**
|
||
|
||
Création d'équipements, consommables, améliorations à partir de recettes + matériaux.
|
||
|
||
| Paramètre | Valeur |
|
||
|-----------|--------|
|
||
| Durée | 15 min à 2 h (temps réel) |
|
||
| Endurance | 5 + (Rareté × 3) |
|
||
| Accélération | TetardCoin |
|
||
|
||
Sources de matériaux : loot, échanges joueurs, événements.
|
||
|
||
**Bonus de sets d'équipement :**
|
||
|
||
| Pièces du même set | Bonus |
|
||
|--------------------|-------|
|
||
| 2 pièces | +3% stat associée |
|
||
| 3 pièces | +10% + effet spécial |
|
||
|
||
---
|
||
|
||
## Économie
|
||
|
||
### Monnaies
|
||
|
||
| Monnaie | Obtention | Usage |
|
||
|---------|-----------|-------|
|
||
| **Or** | Combats, quêtes, succès | Forge, consommables, boutique de base |
|
||
| **TetardCoin** | Twitch (Bits, abonnements), achat direct | Recharge endurance, boutique Twitch, forge garantie |
|
||
| **Matériaux** | Loot, artisanat, événements | Forge, artisanat |
|
||
|
||
### Boutiques
|
||
|
||
| Boutique | Accès | Contenu |
|
||
|----------|-------|---------|
|
||
| Base | Niveau 1 | Équipements communs/rares, potions simples |
|
||
| Avancée | Niveau 15 | Épiques, recettes, matériaux |
|
||
| Événementielle | Événements | Objets thématiques limités |
|
||
| Twitch | TetardCoin uniquement | Cosmétiques, boosts XP/loot |
|
||
|
||
### Marché communautaire *(futur — post-lancement)*
|
||
|
||
- Vente / achat d'objets et matériaux entre joueurs
|
||
- Taxe : 5% Or sur chaque transaction
|
||
- Limite d'accès : selon niveau joueur
|
||
- Phase alpha : interface simple, sans enchères
|
||
- Phase évoluée : filtres avancés, système d'enchères
|
||
|
||
---
|
||
|
||
## Communauté
|
||
|
||
### Succès
|
||
|
||
**Individuels** — catégories : Progression / Combat / Zones / Équipements / Économie
|
||
Récompenses : Or, objets rares, titres honorifiques
|
||
|
||
**Communautaires** — objectifs collectifs :
|
||
- Exemples : tuer 10 000 monstres, collecter 1M TetardCoin, vaincre un GIGABOSS
|
||
- Récompenses : boosts globaux XP/loot, boutique spéciale, titres exclusifs
|
||
|
||
### Événements mondiaux
|
||
|
||
**GIGABOSS mondial**
|
||
- Boss unique accessible à tous pendant 72h
|
||
- Chaque joueur inflige des dégâts cumulés
|
||
- Récompenses proportionnelles à la contribution (Or, loot, titres)
|
||
|
||
**Semaines thématiques**
|
||
- Focus sur une zone ou activité (XP doublée, loot spécial, quêtes exclusives)
|
||
|
||
**Chasses communautaires**
|
||
- Tuer X monstres spécifiques ensemble
|
||
- Suivi en temps réel (barres de progression)
|
||
|
||
### Guildes & Alliances
|
||
|
||
**Guildes** (accès niveau 20)
|
||
- Création : coût Or + TetardCoin, nom + blason + description personnalisés
|
||
- Chat de guilde (site + extension)
|
||
- Coffre de guilde (matériaux, or, objets partagés)
|
||
- Quêtes hebdomadaires collectives
|
||
|
||
| Niveau guilde | Bonus |
|
||
|---------------|-------|
|
||
| 1 | +5% XP |
|
||
| 2 | +10% loot |
|
||
| 3 | +5% endurance max |
|
||
|
||
**Alliances** (jusqu'à 3 guildes)
|
||
- Bonus événementiels partagés
|
||
- Classements inter-guildes (PvE, quêtes, contribution économique)
|
||
- Récompenses : titres collectifs, cosmétiques, accès boutique exclusive
|
||
|
||
---
|
||
|
||
## Compétitif
|
||
|
||
### PvP — Tag & Resolve
|
||
|
||
Inspiré du modèle LaBrute (site classique) : **les combats sont asynchrones, résolus automatiquement par le serveur.**
|
||
|
||
**Ressource PvP : tickets journaliers**
|
||
|
||
- 10 tickets par jour, remise à zéro quotidienne (heure fixe à définir)
|
||
- 1 combat = 1 ticket, qu'il s'agisse d'un humain ou d'un bot
|
||
- Pas de coût en endurance — le PvP est indépendant du PvE
|
||
- *(Bonus de tickets via abonnements Twitch ou TetardCoin : à définir lors de la session monétisation)*
|
||
|
||
---
|
||
|
||
**Flux d'un combat PvP :**
|
||
|
||
```
|
||
1. Le joueur s'inscrit en file PvP (tag)
|
||
2. Le système trouve un adversaire dans sa fenêtre Elo
|
||
3. Le combat se résout côté serveur (même moteur que le PvE)
|
||
4. Les deux joueurs consultent le log de combat + résultat
|
||
5. Les Elo se mettent à jour
|
||
```
|
||
|
||
Aucune interaction en temps réel requise — le joueur peut voir le résultat à sa prochaine connexion.
|
||
|
||
---
|
||
|
||
### Système Elo
|
||
|
||
**Elo de départ :** 1000
|
||
|
||
**Formule :**
|
||
```
|
||
Score attendu = 1 / (1 + 10^((EloAdversaire - EloJoueur) / 400))
|
||
Nouvel Elo = Elo + K × (résultat - score attendu)
|
||
résultat = 1 (victoire) | 0 (défaite)
|
||
```
|
||
|
||
**K-factor :**
|
||
|
||
| Statut | Combats | K |
|
||
|--------|---------|---|
|
||
| Elo provisoire | < 20 combats PvP | 32 |
|
||
| Elo stable | ≥ 20 combats PvP | 16 |
|
||
| Combat contre bot | Tout statut | 8 |
|
||
|
||
**Fenêtre de matchmaking :**
|
||
- Départ : ±150 Elo
|
||
- Si aucun adversaire trouvé après 5 min → fenêtre élargie à ±300
|
||
- Si toujours rien → bot inséré
|
||
|
||
---
|
||
|
||
### Bots de simulation
|
||
|
||
Permettent de jouer dès le lancement même avec peu de joueurs, et de tester l'équilibrage en continu.
|
||
|
||
Le bot est construit à partir d'un profil de stats correspondant à son tier Elo — il utilise le même moteur de combat que les joueurs.
|
||
|
||
| Tier | Elo | Profil |
|
||
|------|-----|--------|
|
||
| Têtard | < 800 | Stats faibles, build généraliste |
|
||
| Apprenti | 800 – 1 000 | Stats moyennes, pas d'équipement rare |
|
||
| Guerrier | 1 000 – 1 200 | Stats optimisées, set de base complet |
|
||
| Élite | 1 200 – 1 500 | Build spécialisé, équipements épiques |
|
||
| Légendaire | 1 500+ | Build maxé, équipement rare, set complet |
|
||
|
||
> Un combat contre un bot met l'Elo à jour (K=8). Le joueur sait qu'il a joué contre un bot.
|
||
|
||
---
|
||
|
||
### Ligues saisonnières
|
||
|
||
- Saisons de durée fixe *(durée à définir)*
|
||
- Classement basé sur l'Elo PvP en fin de saison
|
||
- **Soft reset** en début de saison : Elo ramené vers 1000 (ex : `nouvel Elo = (Elo + 1000) / 2`)
|
||
- Récompenses de fin de saison selon rang (cosmétiques, titres, TetardCoin)
|
||
|
||
**Rangs de ligue *(noms illustratifs)* :**
|
||
|
||
| Rang | Elo |
|
||
|------|-----|
|
||
| Têtard | < 800 |
|
||
| Apprenti | 800 – 1 000 |
|
||
| Guerrier | 1 000 – 1 200 |
|
||
| Élite | 1 200 – 1 500 |
|
||
| Légendaire | 1 500+ |
|
||
|
||
---
|
||
|
||
### Classements complémentaires
|
||
|
||
En plus du classement PvP Elo, plusieurs axes de classement coexistent :
|
||
|
||
| Classement | Basé sur |
|
||
|------------|----------|
|
||
| XP globale | Niveau + XP totale |
|
||
| Richesse | Or accumulé |
|
||
| Contribution communautaire | Dégâts GIGABOSS, chasses, événements |
|
||
| Hall of Fame mensuel | Activité + performance du mois |
|
||
|
||
---
|
||
|
||
## Économie Twitch — Intégration enrichie *(Direction A)*
|
||
|
||
> Enrichissement de l'expérience pour UN streamer et sa communauté.
|
||
> Développable en continuité directe de la v1.0.
|
||
|
||
### Sources de TetardCoin via Twitch
|
||
|
||
| Source | Mécanisme | Montant |
|
||
|--------|-----------|---------|
|
||
| Bits | EventSub `channel.cheer` → conversion directe | *À définir* |
|
||
| Abonnement Prime | EventSub subscribe | Bonus mensuel *à définir* |
|
||
| Abonnement Lv.1 | EventSub subscribe | Bonus mensuel *à définir* |
|
||
| Abonnement Lv.2 | EventSub subscribe | Bonus mensuel *à définir* |
|
||
| Abonnement Lv.3 | EventSub subscribe | Bonus mensuel *à définir* |
|
||
| Activité chat | EventSub `channel.chat.message` | *À définir — ratio et anti-spam* |
|
||
| Présence stream | Token de présence côté serveur (pendant live) | *À définir — fréquence* |
|
||
|
||
### Présence stream (Watch Time)
|
||
|
||
Le viewer s'authentifie une fois sur le site.
|
||
Pendant que le stream est live (`stream.online`), le serveur lui crédite des TetardCoin passifs toutes les X minutes.
|
||
|
||
> Twitch n'expose pas le watch time via API — la détection de présence se fait côté serveur (token actif + stream live). Le viewer n'a pas besoin de rester sur le site.
|
||
> **Question ouverte :** doit-il être connecté sur le *site* ou juste sur *Twitch* ? *(impacte l'implémentation)*
|
||
|
||
### Activité chat
|
||
|
||
Récompenser la participation des viewers en direct.
|
||
|
||
- Commandes dédiées (`!combat`, `!quête`, `!statut`) → déclencher des actions en jeu depuis le chat
|
||
- Messages passifs → TetardCoin au message ou par tranche de X messages
|
||
- **Question ouverte :** récompenser tout message ou uniquement les commandes ? *(anti-spam à définir)*
|
||
|
||
### Événements Twitch → Événements en jeu
|
||
|
||
| Événement Twitch | Événement en jeu |
|
||
|-----------------|-----------------|
|
||
| Hype Train | Boost communautaire temporaire (XP/loot doublés, boss surprise) |
|
||
| Sub Gift massif | Événement spécial (drop de matériaux rares) |
|
||
| Raid entrant | Accueil des raiders avec bonus temporaire |
|
||
| *Autres à définir* | *Session brainstorm événements* |
|
||
|
||
---
|
||
|
||
## Portail multi-streamers *(Direction B)*
|
||
|
||
> TetaRdPG comme service — héberger le jeu pour plusieurs streamers.
|
||
> Architecture distincte de la v1.0 — à traiter comme un projet parallèle.
|
||
|
||
### Vision
|
||
|
||
Chaque streamer s'enregistre sur la plateforme et lie son compte Twitch.
|
||
La plateforme gère son token, ses viewers jouent dans son royaume TetaRdPG.
|
||
Le jeu grandit en réseau : plus de streamers = plus de joueurs = communauté étendue.
|
||
|
||
### Modèle d'univers — question ouverte
|
||
|
||
Deux options architecturales non tranchées :
|
||
|
||
| Modèle | Description | Avantage | Inconvénient |
|
||
|--------|-------------|----------|-------------|
|
||
| **Royaumes isolés** | Chaque streamer a son propre jeu indépendant | Simple, streamer = maître de son univers | Pas de communauté inter-streamers |
|
||
| **Univers partagé** | Un compte joueur global, plusieurs streams rejoignables | Réseau fort, croissance organique | Équilibrage complexe, gouvernance |
|
||
|
||
> **Question ouverte :** univers partagé ou royaumes isolés ?
|
||
|
||
### Modèle économique — question ouverte
|
||
|
||
| Option | Description |
|
||
|--------|-------------|
|
||
| Freemium streamer | Gratuit de base, fonctionnalités premium payantes |
|
||
| Abonnement streamer | Mensuel fixe par streamer enregistré |
|
||
| % transactions | Commission sur les achats TetardCoin des joueurs |
|
||
| Hybride | Freemium + commission |
|
||
|
||
> **Question ouverte :** quel modèle économique pour les streamers ?
|
||
|
||
### Ce que la plateforme gère par streamer
|
||
|
||
- Token Twitch broadcaster (EventSub sur son channel)
|
||
- Base de joueurs liée à son channel
|
||
- Personnalisation : nom du royaume, lore local *(optionnel)*
|
||
- Classements et événements propres à sa communauté
|
||
|
||
### Roadmap Direction B
|
||
|
||
> À ne pas démarrer avant que la v1.0 (Direction A) soit stable en production.
|
||
|
||
```
|
||
v1.0 stable → extraire l'architecture multi-tenant → onboarding premiers streamers partenaires
|
||
```
|
||
|
||
---
|
||
|
||
## Intégration Twitch
|
||
|
||
**Authentification**
|
||
- Connexion via OAuth Twitch → lien compte Twitch ↔ compte site
|
||
|
||
**Données récupérées**
|
||
- Statut live du stream
|
||
- Points de chaîne
|
||
- Bits (conversion en TetardCoin)
|
||
- Abonnements (bonus TetardCoin mensuel)
|
||
|
||
**Extension Twitch (panel viewer)**
|
||
- Statut du personnage
|
||
- Actions rapides depuis le stream
|
||
- Affichage des succès et classements
|
||
|
||
**Actions spéciales via récompenses personnalisées Twitch**
|
||
- Exemples : boost XP, lancement de quête, défi communautaire
|
||
|
||
---
|
||
|
||
## Monétisation *(valeurs à définir — session dédiée)*
|
||
|
||
| Source | Mécanisme | Valeur |
|
||
|--------|-----------|--------|
|
||
| Bits | 1 Bit → X TetardCoin | *À définir* |
|
||
| Abonnement Prime | Bonus mensuel TetardCoin | *À définir* |
|
||
| Abonnement Lv.1 | Bonus mensuel TetardCoin | *À définir* |
|
||
| Abonnement Lv.2 | Bonus mensuel TetardCoin | *À définir* |
|
||
| Abonnement Lv.3 | Bonus mensuel TetardCoin | *À définir* |
|
||
| Achat direct TetardCoin | Recharge endurance / objets | *À définir* |
|
||
|
||
---
|
||
|
||
## Lore & Univers *(illustratif — à redéfinir)*
|
||
|
||
> Ce qui suit est une base d'inspiration, pas un canon définitif.
|
||
> Tout peut être réinventé lors d'une session lore dédiée.
|
||
|
||
Monde aquatique régi par la mythologie du **Têtarastafarisme** et du *Têtard Prophétique*.
|
||
|
||
Exemples de zones : marais, forêt brumeuse, grottes, ruines, temple.
|
||
Exemples de PNJ : sage, alchimiste, forgeron, guide mystérieux.
|
||
|
||
---
|
||
|
||
## Roadmap v1.0
|
||
|
||
| Phase | Durée | Livrables clés |
|
||
|-------|-------|----------------|
|
||
| Pré-production | Sem. 1–4 | Stack validé, wireframes, systèmes formalisés |
|
||
| Sprint 1 — Auth + Backend | Sem. 5–6 | Auth Twitch, création personnage, API core |
|
||
| Sprint 2 — Combat + UI | Sem. 7–8 | Combat PvE, interface joueur |
|
||
| Sprint 3 — Artisanat | Sem. 9–10 | Forge, craft, recettes |
|
||
| Sprint 4 — Succès + HoF | Sem. 11–12 | Succès, classements, Hall of Fame |
|
||
| Bêta fermée | Mois 4 | Tests communauté, feedback, équilibrage |
|
||
| Lancement v1.0 | Mois 5 | Extension Twitch + Site Web en prod |
|
||
|
||
---
|
||
|
||
## Post-lancement (v1.1+)
|
||
|
||
| Trimestre | Contenu |
|
||
|-----------|---------|
|
||
| T1 | Guildes v1.1, premier GIGABOSS rotatif, boutique de succès |
|
||
| T2 | PvP v1.2, personnalisation joueur, marché communautaire étendu |
|
||
| T3 | Nouvelles zones & lore avancé v1.3, événements saisonniers |
|
||
| T4 | Alliances de guildes v1.4, GIGABOSS légendaires, personnalisation Twitch avancée |
|
||
|
||
**Fréquence de mises à jour :**
|
||
- Patchs : toutes les 2 semaines (bugfix, équilibrage)
|
||
- Contenu : mensuel (zones, quêtes, objets, événements)
|
||
|
||
---
|
||
|
||
## Points ouverts
|
||
|
||
| Point | État |
|
||
|-------|------|
|
||
| Stack technique | **TypeScript partout** — NestJS (backend) + React (frontend) + PostgreSQL + Redis |
|
||
| Monétisation — valeurs exactes (Bits, abos) | *Session dédiée* |
|
||
| Présence stream — détection côté site ou Twitch ? | *À trancher — Direction A* |
|
||
| Chat rewards — tout message ou commandes seulement ? | *À trancher — Direction A* |
|
||
| Direction B — univers partagé ou royaumes isolés ? | *À trancher — Direction B* |
|
||
| Direction B — modèle économique streamers | *À trancher — Direction B* |
|
||
| Durée des saisons PvP | *À définir* |
|
||
| Niveau Beta (post-100) | *À préciser* |
|
||
| Lore & univers | *Redéfinition libre lors d'une session dédiée* |
|
||
| Zones et contenu v1.0 | *À définir selon le scope MVP* |
|