Bible Produit · Stake Engine · v0.1

TAILS NEVER FAILS

Le pile-ou-face dans sa forme la plus pure — augmenté d'une couche émotionnelle qui transforme chaque spin en clip.

Tails Never Fails — key art
Coin-flip · 2 boutons TAILS ×3 · EDGE ×1000 RTP cible ~96 % Web · PixiJS + Svelte
01 — La thèse

Pourquoi les gens jouent — et où est le génie

On joue au casino pour trois raisons fondamentales : l'espoir de gagner, passer le temps, et vivre une parenthèse hors du cadre social — un frisson en marge du rapport « travail = argent ».

La plupart des machines noient cette essence sous des couches de complexité (lignes, scatters, bonus à tiroirs). Tails Never Fails fait l'inverse : il distille le jeu à son atome le plus pur — un pile ou face — que tout le monde comprend en une seconde, sans tutoriel, dans n'importe quelle langue.

Le nom vient de l'argot superstitieux qu'on lance avant de flipper une pièce : « tails never fails ». Il porte déjà la promesse et le folklore du geste.

La couche de génie — l'antagoniste incarné. Le jeu n'est pas neutre : il a un visage. Un villain qui réagit émotionnellement à ton résultat — il jubile quand tu perds, enrage quand tu gagnes, et s'effondre en larmes quand tu casses l'EDGE. Le joueur ne vient plus seulement chercher de l'argent : il vient faire pleurer le méchant. C'est ce ressort de schadenfreude qui transforme un coin-flip en machine à clips — et qui donne au streamer un objectif au-delà du gain.

Note de positionnement : le villain est un personnage de fiction (un archétype de cupidité), jamais une cible réelle. C'est à la fois un choix éthique et un choix business — la compliance Stake, les processeurs de paiement et les ad networks rejettent tout contenu fondé sur l'identité réelle d'un groupe. Un méchant inventé donne le même game-feel sans le risque de dépublication.

02 — Le concept de jeu

Une pièce, trois issues, deux boutons

La pièce peut retomber de trois façons. Le joueur parie sur l'une des deux issues gagnantes :

TAILSpaie ×3
HEADSperd toujours ☠
EDGEpaie ×1000

La force du design : EDGE donne un nom et une image intuitive à la « Tranche ». Personne n'a besoin qu'on lui explique pourquoi c'est rare et pourquoi ça paie énorme — c'est de la physique de cour de récré.

Boucle de stream. Spin → réaction du villain → résultat. Le clip naît tout seul : la rage sur un gros TAILS, l'apocalypse émotionnelle sur un EDGE. Format vertical natif, sans montage, infiniment déclinable.
03 — Le roster

Choisis ton adversaire (= ta volatilité)

Comme un select-screen de jeu vidéo, le joueur choisit le villain qu'il veut affronter dans un carrousel. Chaque villain = un profil de volatilité. Le RTP reste équitable et stable (~96 %, certifiable) ; ce qui change, c'est le top multiplicateur de l'EDGE et sa rareté — le vrai levier de sensation.

Lead · Haute volatilité

The Goblin Banker

Gobelin avare aux doigts crochus, accroché à son magot. Cupidité grotesque, comique, 100 % fictive. Il garde le plus gros tas — donc le plus gros jackpot.

EDGE ×1000 · ~1 / 1 042
Le moonshot ultime.

Volatilité moyenne

The Showman (« The House »)

Le maître de cérémonie en costard au sourire carnassier (celui du key art). Incarne « la maison qui déteste payer ». Intemporel, safe.

EDGE ×100 · ~1 / 104
L'équilibre risque/fréquence.

Basse volatilité

The Algorithm

Mascotte IA narquoise au néon. « The house always wins. » Pleure des larmes glitchées sur le jackpot. Moderne, ultra-streamable.

EDGE ×50 · ~1 / 52
Gains fréquents, sensations douces.

Le roster est extensible : chaque nouveau villain est un événement de contenu (saison, collab streamer, skin événementiel) sans toucher au moteur.

04 — Le math

Modèle, RTP & volatilité

Modèle de base — chaque bouton est un bet mode avec sa propre distribution. On gagne uniquement si la face choisie sort.

RTP(bet) = P(face gagnante) × multiplicateur
P(Heads) + P(Tails) + P(Edge) = 1
Cible : RTP ≈ 96 % sur chaque bet (ajustable par juridiction)

Pari TAILS — constant sur tous les villains

IssueMultiProbabilitéFréquenceRTP
Tails×30,3200~1 / 3,196 %
Perte (Heads/Edge non choisi)×00,6800

Pari EDGE — varie par villain (= levier de volatilité)

VillainEDGE ×P(Edge)FréquenceRTPVolatilité
Goblin Banker×10000,00096~1 / 1 04296 %Haute
The Showman×1000,00960~1 / 10496 %Moyenne
The Algorithm×500,01920~1 / 5296 %Basse
Le bon levier. On garde le RTP identique entre villains (équité + certification simple). Ce qui change la sensation, c'est la taille du top-multi et sa rareté. Plus le jackpot est gros, plus l'EDGE est rare — la variance grimpe, le « temps avant ruine » se raccourcit, mais l'espérance reste honnête.
Max-win cap. Le plafond de gain se définit côté math (multiplicateur max dans les tables) et sa fréquence est calibrée par le force_record de l'optimiseur. Le ×1000 du Goblin = ton cap actuel. À figer explicitement avant la certif (Stake attend un cap déclaré).

Comment c'est produit (Math SDK)

1 · DÉFINIR
GameConfig : multiplicateurs, prix, modes de pari.
2 · SIMULER
run.py lance N simulations → books_base.jsonl.
3 · OPTIMISER
L'optimiseur (Rust) ajuste les poids → RTP cible exact.
4 · EXPORTER
lookUpTable_*.csv + force_record → consommés par le RGS.
05 — Le stack technique

Ce que Stake Engine impose réellement (vérifié sur la doc)

CoucheRéalité Stake EngineStatut
MathMath SDK Python ≥ 3.12. GameConfig → simulations run.py → optimiseur Rust/Cargo qui balance au RTP cible. Sort books.jsonl, lookUpTable_*.csv, force_record.✓ Le coin-flip rentre direct
Front-endPixiJS 8 + Svelte 5 + TypeScript, monorepo TurboRepo, machine à états XState. Le RGS pousse des book events → handlers → events d'animation. Build via pnpm (Node 22.16).⚠ Pas Unity — runtime 100 % web
RGS3 appels : authenticate (session, balance, minBet/maxBet/stepBet/betLevels, jurisdiction) → play (débite, renvoie l'issue) → end-round (paie, clôt). Montants en 6 décimales (1 000 000 = 1,00 $).✓ 2 boutons = 2 bet modes
Anim in-gameRive ou Spine pour le villain temps réel (rage / larmes), intégré aux sprites Pixi.✓ Choix nôtre
Vidéo / promoHiggsfield pour les shorts et le pré-render marketing (pas le runtime).
PublicationLogin → page Files → import du build folder → Publish Game → Front End. Validation ~24 h.
Économie10 % du GGR reversé au dev, mensuel, sans frais cachés.✓ Base du business model
Correction majeure vs. plan initial : le runtime n'est pas Unity — Stake Engine livre du web (PixiJS/Svelte). Unity peut au mieux servir à produire des assets, pas à packager le jeu. On code le front en TypeScript sur le template officiel.

Set-up local (vérifié)

# Front-end
nvm install 22.16.0
npm i -g pnpm@10.5.0
git clone https://github.com/StakeEngine/web-sdk.git
cd web-sdk && pnpm install
pnpm run dev --filter=<game>     # dev server
pnpm run build --filter=<game>   # build à uploader

# Math (Python ≥ 3.12, + Rust pour l'optimiseur)
git clone https://github.com/StakeEngine/math-sdk.git
make run GAME=<game>

Compliance à garder en tête : RTP déclaré = RTP certifié ; max-win cap explicite ; la réponse authenticate porte des flags jurisdiction (ex. socialCasino, disabledTurbo) qu'il faut respecter côté UI.

06 — Go-to-market

Distribution & acquisition

① Featured placement Stake Engine

Exploiter la proposition du CTO Stake Engine pour mettre la machine en avant dès le lancement. La simplicité radicale + le hook villain en font un candidat parfait pour une mise en avant éditoriale.

② Revenue-share streamers

Deals de revenue-share avec des streamers casino via les contacts maltais. Le hook « faire pleurer le villain » donne au streamer un objectif narratif qui dépasse le simple gain — du contenu qui se filme tout seul.

③ Short-form organique

Usine à clips verticaux (Nico + équipe) : moments de rage/larmes du villain. Comptes réels, contenu authentique. Le format est natif au jeu, pas plaqué dessus.

④ Modèle économique

10 % du GGR
Reversé mensuellement par Stake. Chaque villain ajouté = nouveau cycle de contenu et de rétention, sans coût moteur.

Lignes rouges marketing. Pas de réseaux de faux comptes, pas de buzz/controverse fabriqués, pas de ciblage fondé sur le mépris de l'audience. Au-delà de l'éthique : c'est ce qui fait bannir une machine et griller une marque B2B sur Stake. La traction se construit sur le game-feel et le format clip, qui sont déjà excellents.
07 — Roadmap

Prochaines étapes

PHASE 1 · MATH
Figer GameConfig (3 villains), RTP 96 %, cap ×1000. Simuler + optimiser. Livrable : lookup tables certifiables.
PHASE 2 · FRONT
Fork web-sdk, scène coin-flip, 2 boutons, intégration Rive du villain. Câblage RGS (authenticate/play/end-round).
PHASE 3 · ASSETS
Goblin + Showman + Algorithm (états : idle / jubile / rage / larmes). Higgsfield pour les promos.
PHASE 4 · SHIP
Build → upload Files → Publish. Featured placement + activation streamers + vague de shorts.

Cette page est la v0.1 de la bible. À enrichir au fil des décisions (paytables finales, noms définitifs, deck streamers, planning de contenu).