TetaRdPG/GDD.md

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