2026-03-10 18:24:01 +01:00
# Open The Box - Game Design Document
> **Version**: 0.1.0-alpha
> **Date**: 2026-03-10
> **Auteur**: Equipe Open The Box
> **Architecture de reference**: Black Box Sim (Brian Cronin)
> **Plateforme**: CLI (.NET / C#)
> **Localisation**: FR / EN
---
## Table des matieres
1. [Vue d'ensemble / Concept ](#1-vue-densemble--concept )
2. [Mecanique principale : ouverture de boites ](#2-mecanique-principale--ouverture-de-boites )
3. [Systeme de progression CLI (Phases 0-8) ](#3-systeme-de-progression-cli-phases-0-8 )
4. [Systeme de boites ](#4-systeme-de-boites )
2026-03-15 18:43:42 +01:00
5. [Reactions en chaine (interactions automatiques) ](#5-reactions-en-chaine-interactions-automatiques )
2026-03-10 18:24:01 +01:00
6. [Personnalisation ](#6-personnalisation )
7. [Materiaux et Craft ](#7-materiaux-et-craft )
8. [Ressources ](#8-ressources )
9. [Aventures interactives ](#9-aventures-interactives )
10. [Personnages ](#10-personnages )
11. [Localisation ](#11-localisation )
---
## 1. Vue d'ensemble / Concept
**Open The Box** est un jeu CLI (Command-Line Interface) d'ouverture de boites dans lequel le joueur decouvre progressivement un univers riche en ouvrant des boites contenant des objets, des lieux, des personnages, des cosmetiques et des meta-ameliorations.
### Pitch
> *Ouvrez une boite. Elle contient une autre boite. Celle-ci contient une cle. La cle ouvre un coffre. Le coffre contient un fragment d'histoire. L'histoire deverrouille un nouveau personnage. Le personnage revele un lieu. Le lieu offre une aventure. L'aventure recompense... une boite.*
### Piliers de design
1. **La curiosite comme moteur** -- Chaque ouverture de boite est une micro-revelation. Le joueur ne sait jamais ce qu'il va trouver, et chaque trouvaille enrichit l'univers du jeu.
2. **Progression de l'interface** -- Le CLI lui-meme evolue au fil du jeu. On commence avec un `Console.ReadLine` basique et on termine avec un layout complet Spectre.Console avec panneaux, couleurs, animations et raccourcis clavier.
3. **Emergent gameplay par combinaison** -- Les objets interagissent entre eux de maniere automatique (auto-activation). Une cle trouvee active automatiquement le coffre correspondant, revelant de nouveaux contenus.
4. **Profondeur cachee** -- Sous l'apparence simple d'un jeu d'ouverture de boites se cache un systeme de craft, d'aventures interactives, de personnalisation et de narration.
### Architecture Black Box Sim (Brian Cronin)
Le jeu suit le pattern "Black Box Sim" :
- **Entree** : une action simple (ouvrir une boite)
- **Traitement** : un systeme opaque de loot tables, conditions, poids et interactions
- **Sortie** : un resultat surprenant et satisfaisant
Le joueur n'a jamais acces aux probabilites exactes. Il decouvre le systeme par l'experience et l'experimentation. Les regles internes sont volontairement opaques -- d'ou le nom "Black Box".
Le modele de donnees est centre sur trois entites :
- **Box** (la boite) -- contient une loot table ponderee
- **Item** (l'objet) -- le resultat d'une ouverture
- **Player** (le joueur) -- son inventaire, ses stats, son etat de progression
---
## 2. Mecanique principale : ouverture de boites
### Boucle de gameplay fondamentale
```
[Joueur] -> Ouvre une boite -> [Systeme de loot] -> Obtient un/des objet(s) -> [Auto-activation] -> Effets en chaine -> [Retour a l'inventaire]
```
### Deroulement d'une ouverture
1. Le joueur selectionne une boite dans son inventaire (ou la boite est auto-selectionnee au debut du jeu).
2. Le systeme de loot tire un ou plusieurs objets selon la loot table de la boite.
3. L'objet est ajoute a l'inventaire du joueur.
4. Le systeme d'auto-activation verifie si des interactions sont possibles avec les objets existants.
5. Si des interactions existent, elles sont executees automatiquement (ouverture de coffre, activation de lieu, etc.).
6. L'affichage est mis a jour en fonction du niveau de progression CLI.
### Premiere ouverture
Le jeu commence avec une unique **Boite de depart** . Cette boite contient toujours (100%) une **Boite a boite** , qui elle-meme contient d'autres boites selon un systeme de poids detaille en section 4.
---
## 3. Systeme de progression CLI (Phases 0-8)
Le coeur de l'originalite d'Open The Box : l'interface elle-meme est un systeme de progression. Le joueur commence avec l'interface la plus minimale possible et debloquer des ameliorations d'interface via les **Boites Meta** .
### Phase 0 -- Console brute
- **Interface** : `Console.ReadLine` / `Console.WriteLine` uniquement
- **Interaction** : le joueur tape du texte pour agir
- **Visuel** : texte blanc sur fond noir, aucune mise en forme
- **Ressenti** : brut, mysterieux, inconfortable volontairement
### Phase 1 -- Couleurs de texte
- **Deblocage** : `UIFeature.TextColors`
- **Ajout** : les objets, noms et quantites s'affichent en couleur
- **Technologie** : codes ANSI basiques (8 couleurs)
- **Impact** : premiere sensation de "progression de l'interface"
### Phase 2 -- Couleurs etendues
- **Deblocage** : `UIFeature.ExtendedColors`
- **Ajout** : palette complete de 256 couleurs, degradees et nuances
- **Technologie** : codes ANSI etendus
- **Impact** : le texte devient visuellement plus riche et lisible
### Phase 3 -- Selection par fleches
- **Deblocage** : `UIFeature.ArrowKeySelection`
- **Ajout** : le joueur peut naviguer dans les menus avec les fleches directionnelles au lieu de taper des commandes
- **Technologie** : `Console.ReadKey` + gestion de curseur
- **Impact** : amelioration majeure de l'ergonomie
### Phase 4 -- Panneau d'inventaire
- **Deblocage** : `UIFeature.InventoryPanel`
- **Ajout** : un panneau lateral affiche l'inventaire du joueur en permanence
- **Technologie** : Spectre.Console `Table` ou `Panel`
- **Impact** : le joueur voit enfin son inventaire sans taper de commande
### Phase 5 -- Panneaux de ressources et stats
- **Deblocage** : `UIFeature.ResourcePanel` + `UIFeature.StatsPanel`
- **Ajout** : barres de ressources (HP, Mana, Food, etc.) et statistiques du joueur
- **Technologie** : Spectre.Console `BarChart` et `Table`
- **Impact** : le jeu ressemble desormais a un vrai RPG en CLI
### Phase 6 -- Portrait et chat
- **Deblocage** : `UIFeature.PortraitPanel` + `UIFeature.ChatPanel`
- **Ajout** : affichage ASCII du portrait du joueur (base sur les cosmetiques equipes) + panneau de chat avec les PNJ
- **Technologie** : Spectre.Console `Canvas` ou `Markup` avance
- **Impact** : dimension sociale et visuelle
### Phase 7 -- Animations et craft
- **Deblocage** : `UIFeature.BoxAnimation` + `UIFeature.CraftingPanel`
- **Ajout** : animations d'ouverture de boites (texte defilant, effets visuels ASCII) + panneau de craft
- **Technologie** : Spectre.Console `Live` et `Status`
- **Impact** : le jeu devient spectaculaire et immersif
### Phase 8 -- Full Layout
- **Deblocage** : `UIFeature.FullLayout` + `UIFeature.KeyboardShortcuts`
- **Ajout** : mise en page complete avec tous les panneaux organises, raccourcis clavier pour toutes les actions
- **Technologie** : Spectre.Console `Layout` complet
- **Impact** : l'interface finale, riche et complete -- la recompense ultime pour la progression
### Tableau recapitulatif
| Phase | UIFeature(s) | Technologie principale |
|-------|-------------------------------------|-----------------------------|
| 0 | *(aucun)* | Console.ReadLine |
| 1 | TextColors | ANSI 8 couleurs |
| 2 | ExtendedColors | ANSI 256 couleurs |
| 3 | ArrowKeySelection | Console.ReadKey |
| 4 | InventoryPanel | Spectre.Console Panel/Table |
| 5 | ResourcePanel, StatsPanel | Spectre.Console BarChart |
| 6 | PortraitPanel, ChatPanel | Spectre.Console Canvas |
| 7 | BoxAnimation, CraftingPanel | Spectre.Console Live/Status |
| 8 | FullLayout, KeyboardShortcuts | Spectre.Console Layout |
---
## 4. Systeme de boites
### Hierarchie complete
Le systeme de boites est le coeur du jeu. Chaque boite contient une **loot table** ponderee. Les boites peuvent contenir d'autres boites, creant un systeme recursif et emergent.
### Boite de depart
> *La toute premiere boite du jeu.*
| Contenu | Poids | Notes |
|----------------------|-------|---------------------------|
| Boite a boite | 100% | Toujours garantie |
La Boite de depart est unique. Elle n'apparait qu'une seule fois au tout debut du jeu.
### Boite a boite
> *La boite qui contient des boites. Le nexus central du jeu.*
La Boite a boite est le hub de distribution principal. Elle contient une selection ponderee parmi toutes les sous-boites disponibles du jeu.
| Contenu | Poids | Conditions |
|------------------------|--------|-----------------------------------------|
| Boite Meta | 20 | *(toujours disponible)* |
| Boite stylee | 15 | *(toujours disponible)* |
| Boite aventure | 15 | *(toujours disponible)* |
| Boite d'amelioration | 12 | Si ressources OU equipement > 0 |
| Boite de fourniture | 12 | Si ressources > 0 |
| Boite noire | 8 | *(toujours disponible)* |
| Boite a histoire | 6 | *(toujours disponible)* |
| Boite a musique | 5 | *(toujours disponible)* |
| Boite a Cookies | 4 | *(toujours disponible)* |
| Boite legendaire | 2 | *(toujours disponible)* |
| Boite legend'hair | 1 | *(toujours disponible)* |
> **Note** : Les poids sont relatifs. Le total n'est pas forcement 100 -- les poids sont normalises au moment du tirage. Les boites conditionnelles sont exclues du tirage si la condition n'est pas remplie.
---
### Boite Meta
> *La boite qui ameliore le jeu lui-meme.*
La Boite Meta contient des deblocages d'interface (UIFeatures) et des ameliorations meta du jeu. Elle est essentielle a la progression du joueur car c'est le seul moyen d'ameliorer l'interface CLI.
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| UIFeature (prochain deblocage) | 60 | Deverrouille la prochaine phase CLI |
| Badge de progression | 15 | Badge commemoratif |
| Font deblocable | 10 | Nouvelle police pour l'interface |
| TextColor (nouveau slot) | 10 | Personnalisation des couleurs de texte |
| Boite Meta (recursion) | 5 | 5% de chance d'obtenir une autre Boite Meta |
Le systeme de deblocage des UIFeatures est **sequentiel** : on debloque toujours la prochaine phase dans l'ordre (Phase 1, puis 2, puis 3, etc.). Si toutes les phases sont deja debloquees, le poids de UIFeature est redistribue aux autres entrees.
---
### Boite stylee
> *La boite de la mode et du style.*
La Boite stylee contient des cosmetiques pour personnaliser l'apparence du joueur.
| Contenu | Poids | Notes |
|--------------------------|-------|--------------------------------------------------------|
| Coiffure (HairStyle) | 25 | Style de cheveux aleatoire |
| Yeux (EyeStyle) | 20 | Style d'yeux aleatoire |
| Corps (BodyStyle) | 15 | Style de corps aleatoire |
| Jambes (LegStyle) | 15 | Style de jambes aleatoire |
| Bras (ArmStyle) | 10 | Style de bras aleatoire |
| Teinture (TintColor) | 10 | Couleur de teinture applicable a n'importe quel slot |
| Nouveau genre | 5 | **ERROR: les boites n'ont pas de genre.** |
> **Note speciale sur "Nouveau genre"** : Cette entree est un easter egg volontaire. Si le joueur tombe sur "Nouveau genre", le systeme affiche un message d'erreur humoristique : `"ERROR: les boites n'ont pas de genre."` et le joueur ne recoit rien -- sauf un Badge special "Genre Error" s'il ne l'a pas deja.
---
### Boite legend'hair
> *La boite legendaire... capillaire.*
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Coiffure Legendaire (garantie) | 100 | Tire parmi les coiffures de rarete Legendaire ou Mythic |
La Boite legend'hair garantit **toujours** une coiffure de rarete Legendaire ou superieure. C'est la boite la plus rare de la Boite a boite (poids 1).
Coiffures legendaires disponibles :
- **StardustLegendary** -- des cheveux faits de poussiere d'etoile, brillants et changeants
- **Fire** -- des cheveux de flammes vivantes
- **Cyberpunk** -- coiffure high-tech avec effets neon
---
### Boite legendaire
> *La boite du prestige absolu.*
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Coiffure Legendaire | 30 | Identique a Boite legend'hair |
| Objet Legendaire | 25 | Item de rarete Legendaire (arme, armure) |
| Personnage Legendaire | 20 | Personnage rare et puissant |
| Lieu Legendaire | 15 | Lieu unique et memorable |
| Blueprint Legendaire | 10 | Blueprint de station de craft rare |
Contrairement a la Boite legend'hair (garantie capillaire), la Boite legendaire offre un objet legendaire dans n'importe quelle categorie.
---
### Boite aventure
> *La porte vers neuf mondes differents.*
La Boite aventure contient un **jeton d'aventure** (AdventureToken) qui deverrouille une aventure interactive dans un des 9 themes du jeu.
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Boite aventure Space | 14 | Aventure spatiale |
| Boite aventure Medieval | 14 | Aventure medievale |
| Boite aventure Pirate | 14 | Aventure pirate |
| Boite aventure Contemporary | 12 | Aventure contemporaine |
| Boite aventure Sentimental | 10 | Aventure sentimentale / romance |
| Boite aventure Prehistoric | 10 | Aventure prehistorique |
| Boite aventure Cosmic | 10 | Aventure cosmique |
| Boite aventure Microscopic | 8 | Aventure microscopique |
| Boite aventure DarkFantasy | 8 | Aventure dark fantasy |
Chaque sous-boite d'aventure contient :
- 1 AdventureToken du theme correspondant
- 1 objet thematique (arme, armure ou consommable lie au theme)
- Chance de : 1 personnage thematique (20%), 1 fragment de lore (30%)
---
### Boite d'amelioration
> *La boite qui rend plus fort.*
**Condition d'apparition** : le joueur doit posseder au moins une ressource OU un equipement dans son inventaire. Si cette condition n'est pas remplie, la Boite d'amelioration est exclue de la loot table de la Boite a boite.
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Amelioration de ressource max | 35 | +10% au cap d'une ressource aleatoire |
| Amelioration d'equipement | 25 | +1 niveau a un equipement possede |
| Amelioration de stat | 20 | +1 a une statistique aleatoire |
| Blueprint de station | 15 | Plan pour construire une nouvelle station |
| Amelioration de station | 5 | +1 niveau a une station existante |
---
### Boite de fourniture
> *La boite du ravitaillement.*
**Condition d'apparition** : le joueur doit posseder au moins une ressource active (debloquee). Si le joueur n'a encore aucune ressource, cette boite n'apparait pas.
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Health (soin) | 20 | Restaure des points de vie |
| Mana | 15 | Restaure des points de mana |
| Food (nourriture) | 20 | Restaure de la nourriture |
| Stamina (endurance) | 15 | Restaure de l'endurance |
| Gold (or) | 15 | Ajoute de l'or |
| Energy (energie) | 10 | Restaure de l'energie |
2026-03-18 19:04:06 +01:00
| Ink (encre) | 3 | Restaure de l'encre (ressource rare) |
2026-03-10 18:24:01 +01:00
| Oxygen (oxygene) | 2 | Restaure de l'oxygene (ressource rare) |
> **Note** : Seules les ressources deja debloquees par le joueur peuvent apparaitre dans le tirage. Les poids sont recalcules dynamiquement.
---
### Boite noire
> *La boite mysterieuse. Personne ne sait ce qu'elle contient avant de l'ouvrir.*
La Boite noire est speciale : son contenu est totalement aleatoire et peut provenir de **n'importe quelle** autre loot table du jeu. Elle peut contenir :
- Un objet de n'importe quelle rarete (Common a Mythic)
- Un cosmetique de n'importe quel slot
- Un materiau de n'importe quel type et forme
- Un personnage
- Un fragment de lore
- Un token d'aventure
- Une autre boite (y compris une autre Boite noire, dans de tres rares cas)
La Boite noire est le symbole meme du principe "Black Box" du jeu : l'opacite totale.
---
### Boite a histoire
> *La boite qui raconte.*
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Fragment de Lore | 50 | Un morceau d'histoire du monde |
| Story Item | 25 | Un objet lie a la narration |
| Personnage (rencontre) | 15 | Un nouveau PNJ se revele |
| Lieu (decouverte) | 10 | Un nouveau lieu est decouvert |
Les fragments de lore se collectionnent et, une fois assembles, revelent des pans entiers de l'histoire du monde d'Open The Box.
---
### Boite a musique
> *La boite qui chante.*
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Musique d'ambiance | 40 | Theme musical pour un lieu ou une aventure |
| Jingle d'ouverture | 25 | Son joue a l'ouverture de boite |
| Theme de personnage | 20 | Musique associee a un PNJ |
| Boite a musique rare | 10 | Musique rare ou legendary |
| Easter egg sonore | 5 | Son cache, reference culturelle |
> **Note technique** : les "musiques" sont representees par des descriptions textuelles et des patterns ASCII art dans la console. Si le systeme audio est disponible, elles peuvent aussi etre jouees.
---
### Boite a Cookies
> *La boite des petits plaisirs.*
| Contenu | Poids | Notes |
|----------------------------------|-------|------------------------------------------|
| Cookie de fortune | 40 | Message aleatoire (humoristique ou sage) |
| Cookie de buff | 25 | Buff temporaire (+10% chance de rare) |
| Cookie de craft | 15 | Accelere le prochain craft |
| Cookie dore | 10 | Effet rare et memorable |
| Cookie d'XP | 7 | Bonus d'experience |
| Cookie meta | 3 | Effet meta-game (change une regle) |
---
2026-03-15 18:43:42 +01:00
## 5. Reactions en chaine (interactions automatiques)
2026-03-10 18:24:01 +01:00
### Principe
2026-03-15 18:43:42 +01:00
Les reactions en chaine sont le systeme spectaculaire d'Open The Box. Lorsqu'un objet est ajoute a l'inventaire du joueur, le systeme verifie automatiquement si cet objet peut reagir avec un autre objet deja present. Si une reaction se produit, elle peut generer de nouveaux objets qui declenchent eux-memes d'autres reactions -- creant une cascade visible et excitante.
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
### Philosophie
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
Le joueur n'initie jamais une reaction manuellement. Il ouvre une boite, recoit des objets, et observe les consequences. Les reactions en chaine sont le "feu d'artifice" du jeu : imprevisibles, spectaculaires, et recompensant l'accumulation strategique d'objets dans l'inventaire.
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
Les descriptions des objets reactifs indiquent toujours leur potentiel de combinaison, creant de l'anticipation chez le joueur qui possede un objet en attente de son partenaire.
### Coffres thematiques
Chaque theme d'aventure possede un **coffre** (tag `Openable` ) qui apparait dans les boites d'aventure correspondantes. Les coffres sont des objets inertes tant que le joueur ne possede pas la cle correspondante.
| Coffre | Cle correspondante | Contenu a l'ouverture |
|-------------------------|-----------------------|----------------------------------------------------|
| Coffre spatial | Cle spatiale | Carte stellaire + Coordonnees spatiales |
| Coffre medieval | Cle medievale | Blason royal + Parchemin ancien |
| Coffre pirate | Cle pirate | Carte au tresor + Boussole pirate |
| Coffre contemporain | Cle contemporaine | Badge VIP + Cle USB |
| Coffre dark fantasy | Cle dark fantasy | Grimoire maudit + Anneau sombre |
| Coffre mysterieux | Cle mysterieuse | Objet aleatoire legendaire |
> **Note** : La cle mysterieuse (`mysterious_key`) reagit avec n'importe quel coffre. C'est un joker rare.
### Catalyseurs
Les **catalyseurs** sont des objets rares qui participent aux reactions sans etre consommes. Ils restent dans l'inventaire et peuvent declencher plusieurs chaines au fil du temps.
| Catalyseur | Effet | Source |
|-------------------------|-----------------------------------------------------|----------------------------|
| Pierre alchimique | Participe a toute reaction de type Combine | Boite legendaire |
### Flux de reaction en chaine
2026-03-10 18:24:01 +01:00
```
1. Objet ajoute a l'inventaire
2026-03-15 18:43:42 +01:00
2. Le systeme cherche des reactions possibles avec les objets existants
3. Si une reaction est trouvee :
a. Les objets reactifs sont consommes (sauf les catalyseurs)
b. La reaction produit de nouveaux objets et/ou deblocages
c. Compteur de chaine : +1
d. Les nouveaux objets sont re-injectes dans l'etape 2
4. Fin de la chaine quand plus aucune reaction n'est possible
5. Si chaine >= 2 : bonus de chaine applique
```
### Compteur de chaine et bonus
Le compteur de chaine est affiche en temps reel pendant la cascade.
| Longueur de chaine | Affichage | Bonus |
|---------------------|-------------------|-------------------------------------------------|
| x1 | *(pas de bonus)* | Reaction simple, pas de bonus |
| x2 | ⚡ Chaine x2 ! | Objet bonus aleatoire (rarete Uncommon+) |
| x3 | ⚡⚡ Chaine x3 ! | Boite rare en bonus |
| x4+ | ⚡⚡⚡ Chaine x4+ ! | Boite legendaire en bonus |
### Types de reaction (InteractionResultType)
Chaque reaction produit un resultat parmi :
- **OpenBox** -- la cle ouvre le coffre, revelant son contenu (les objets produits peuvent declencher d'autres reactions)
- **Unlock** -- deblocage d'un contenu (aventure, personnage)
- **Combine** -- combinaison de plusieurs objets en un resultat (carte + boussole = localisation du tresor)
### Regles de reaction
Chaque regle dans `interactions.json` definit :
- `requiredItemTags` : tags que le nouvel objet doit posseder pour declencher la regle
- `requiredItemIds` : objets specifiques devant etre presents dans l'inventaire
- `consumeTrigger` : si `false` , l'objet declencheur n'est pas consomme (catalyseur)
- `resultData` : les objets/effets produits par la reaction
- `descriptionKey` : le message narratif affiche au joueur (avec placeholders `{0}` et `{1}` pour les noms des objets impliques)
- `isAutomatic` : toujours `true` pour les reactions en chaine
- `priority` : ordre de resolution quand plusieurs reactions sont possibles
### Descriptions d'objets et anticipation
Les objets reactifs portent dans leur description un indice de combinaison. Exemples :
| Objet | Description |
|------------------|--------------------------------------------------------------------------|
| Cle medievale | *"Une cle ornee d'un blason. Elle cherche un coffre a sa mesure..."* |
| Coffre medieval | *"Un coffre verrouille, orne du meme blason qu'une certaine cle..."* |
| Carte au tresor | *"X marque l'emplacement... mais sans boussole, impossible de s'orienter."* |
| Boussole pirate | *"L'aiguille pointe vers un tresor... si seulement tu avais la carte."* |
| Cle mysterieuse | *"Cette cle semble pouvoir ouvrir n'importe quel coffre..."* |
### Exemple de chaine complete
2026-03-10 18:24:01 +01:00
```
2026-03-15 18:43:42 +01:00
Boite d'aventure pirate ouverte !
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
Tu as recu :
- Coffre pirate [Rare]
- Plume de perroquet [Commun]
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
⚡ Reaction ! Ta Cle pirate et ton Coffre pirate reagissent...
La cle tourne, le coffre s'ouvre !
→ Carte au tresor [Epic]
→ Boussole pirate [Rare]
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
⚡⚡ Chaine x2 ! Ta Carte au tresor et ta Boussole pirate s'alignent...
Les coordonnees se revelent !
→ 🎉 Aventure 'Iles Perdues' debloquee !
2026-03-10 18:24:01 +01:00
2026-03-15 18:43:42 +01:00
⚡⚡ Bonus de chaine x2 : Boite coolos en recompense !
```
2026-03-10 18:24:01 +01:00
---
## 6. Personnalisation
### Slots cosmetiques
Le joueur peut personnaliser l'apparence de son avatar a travers 5 slots cosmetiques :
#### Coiffure (CosmeticSlot.Hair)
| Style | Rarete | Description |
|-------------------|-------------|----------------------------------------------------|
| None | -- | Pas de coiffure (defaut) |
| Short | Common | Cheveux courts classiques |
| Long | Common | Cheveux longs |
| Ponytail | Uncommon | Queue de cheval |
| Braided | Rare | Tresses elaborees |
| Cyberpunk | Epic | Coiffure high-tech avec effets neon |
| Fire | Legendary | Cheveux de flammes vivantes |
| StardustLegendary | Mythic | Cheveux de poussiere d'etoile |
#### Yeux (CosmeticSlot.Eyes)
| Style | Rarete | Description |
|-------------------|-------------|----------------------------------------------------|
| None | -- | Pas de style d'yeux (defaut) |
| Blue | Common | Yeux bleus |
| Green | Common | Yeux verts |
| RedOrange | Uncommon | Yeux rouge-orange |
| Brown | Common | Yeux marron |
| Black | Uncommon | Yeux noirs profonds |
| Sunglasses | Rare | Lunettes de soleil |
| PilotGlasses | Rare | Lunettes d'aviateur |
| AircraftGlasses | Epic | Lunettes de pilote de chasse |
| CyberneticEyes | Legendary | Yeux cybernetiques lumineux |
| MagicianGlasses | Epic | Lunettes de magicien (rondes, dorees) |
#### Corps (CosmeticSlot.Body)
| Style | Rarete | Description |
|-------------------|-------------|----------------------------------------------------|
| Naked | Common | Torse nu (defaut) |
| RegularTShirt | Common | T-shirt classique |
| SexyTShirt | Uncommon | T-shirt echancre |
| Suit | Rare | Costume elegant |
| Armored | Epic | Armure complete |
| Robotic | Legendary | Corps robotique |
#### Jambes (CosmeticSlot.Legs)
| Style | Rarete | Description |
|-------------------|-------------|----------------------------------------------------|
| None | -- | Aucun style (defaut) |
| Naked | Common | Jambes nues |
| Slip | Common | Sous-vetement |
| Short | Uncommon | Short |
| Panty | Uncommon | Collants |
| RocketBoots | Epic | Bottes a reaction |
| PegLeg | Rare | Jambe de bois (pirate) |
| Tentacles | Legendary | Tentacules a la place des jambes |
#### Bras (CosmeticSlot.Arms)
| Style | Rarete | Description |
|-------------------|-------------|----------------------------------------------------|
| None | -- | Aucun style (defaut) |
| Short | Common | Bras courts |
| Regular | Common | Bras normaux |
| Long | Uncommon | Bras longs |
| Mechanical | Epic | Bras mecaniques |
| Wings | Legendary | Ailes a la place des bras |
| ExtraPair | Mythic | Paire de bras supplementaire (4 bras au total) |
### Teintures (TintColor)
Les teintures sont applicables a **n'importe quel** slot cosmetique. Elles modifient la couleur de l'objet cosmetique equipe.
| Teinture | Rarete | Effet visuel |
|-----------|-----------|-------------------------------------------|
| None | -- | Couleur d'origine |
| Cyan | Common | Teinte cyan |
| Orange | Common | Teinte orange |
| Purple | Uncommon | Teinte violette |
| WarmPink | Uncommon | Teinte rose chaud |
| Light | Common | Version eclaircie |
| Dark | Common | Version assombrie |
| Rainbow | Epic | Multicolore arc-en-ciel |
| Neon | Rare | Effet neon brillant |
| Silver | Rare | Teinte argentee metallique |
| Gold | Epic | Teinte doree |
| Void | Legendary | Noir absolu avec reflets d'etoiles |
---
## 7. Materiaux et Craft
### Materiaux (7 types)
Le systeme de craft repose sur 7 types de materiaux, classes par ordre de rarete et de puissance :
| Materiau | Rarete d'apparition | Tier | Description |
|---------------|---------------------|------|--------------------------------------|
| Wood | Common | 1 | Bois, le materiau le plus basique |
| Bronze | Common | 2 | Bronze, alliage simple |
| Iron | Uncommon | 3 | Fer, materiau intermediaire |
| Steel | Rare | 4 | Acier, materiau avance |
| Titanium | Epic | 5 | Titane, materiau de haute technologie|
| Diamond | Legendary | 6 | Diamant, materiau precieux |
| CarbonFiber | Mythic | 7 | Fibre de carbone, materiau ultime |
### Formes de materiaux (9 formes)
Chaque materiau peut exister sous differentes formes, obtenues par transformation dans les stations de craft :
| Forme | Description | Station typique |
|----------|------------------------------------------|--------------------------|
| Raw | Materiau brut, non transforme | *(aucune)* |
| Refined | Materiau raffine, pret a l'emploi | Foundry |
| Nail | Clou, pour la construction | Anvil |
| Plank | Planche (surtout pour le bois) | SawingPost |
| Ingot | Lingot (surtout pour les metaux) | Furnace |
| Sheet | Feuille ou plaque fine | Forge |
| Thread | Fil (pour le tissage et la couture) | Loom |
| Dust | Poudre (pour l'alchimie) | MortarAndPestle |
| Gem | Gemme taillee (pour la joaillerie) | Jewelry |
### Combinatoire
Avec 7 materiaux et 9 formes, le systeme offre **63 combinaisons** possibles de materiaux (7 x 9 = 63). Toutes les combinaisons ne sont pas forcement accessibles immediatement -- certaines necessitent des stations de craft specifiques.
### Stations de craft (30+ stations)
Les stations de craft sont debloquees via des **Blueprints** (WorkstationBlueprint) trouves dans les boites. Chaque station permet de transformer des materiaux et de fabriquer des objets.
| Station | Description | Specialite |
|------------------------|-------------------------------------------------------|-----------------------------|
| Foundry | Fonderie pour raffiner les materiaux bruts | Raw -> Refined |
| Workbench | Etabli polyvalent | Craft general |
| Furnace | Four pour creer des lingots | Refined -> Ingot |
| Loom | Metier a tisser | Refined -> Thread |
| Anvil | Enclume pour forger clous et outils | Ingot -> Nail, outils |
| AlchemyTable | Table d'alchimie | Potions, elixirs |
| Forge | Forge avancee | Ingot -> Sheet, armes |
| SawingPost | Poste de sciage | Wood -> Plank |
| Windmill | Moulin a vent | Transformation de grains |
| Watermill | Moulin a eau | Transformation hydraulique |
| OilPress | Presse a huile | Production d'huiles |
| PotteryWorkshop | Atelier de poterie | Objets en ceramique |
| TailorTable | Table de couturier | Vetements, cosmetiques |
| MortarAndPestle | Mortier et pilon | Refined -> Dust |
| DyeBasin | Bassin de teinture | Teintures |
| Jewelry | Atelier de joaillerie | Refined -> Gem, bijoux |
| Smoker | Fumoir | Conservation de nourriture |
| BrewingVat | Cuve de brassage | Boissons, potions |
| EngineerDesk | Bureau d'ingenieur | Blueprints avances |
| WeldingStation | Poste de soudure | Assemblage metal |
| DrawingTable | Table a dessin | Plans et schemas |
| EngravingBench | Banc de gravure | Gravure et enchantement |
| SewingPost | Poste de couture | Thread -> vetements |
| MagicCauldron | Chaudron magique | Potions magiques puissantes |
| TransformationPentacle | Pentacle de transformation | Transformation d'objets |
| PaintingSpace | Espace de peinture | Art et decoration |
| Distillery | Distillerie | Alcools, essences |
| Printer3D | Imprimante 3D | Objets complexes modernes |
| MatterSynthesizer | Synthetiseur de matiere | Creation de materiaux rares |
| GeneticModStation | Station de modification genetique | Modifications biologiques |
| TemporalBracelet | Bracelet temporel | Manipulation du temps |
| StasisChamber | Chambre de stase | Conservation et evolution |
---
## 8. Ressources
Le joueur gere 8 ressources qui influencent sa capacite a explorer, combattre, crafter et survivre.
| Ressource | Icone | Description | Utilisation principale |
|-----------|-------|--------------------------------------------------|--------------------------------|
| Health | HP | Points de vie | Survie, combat |
| Mana | MP | Points de magie | Sorts, enchantements |
| Food | FD | Nourriture | Exploration, stamina |
| Stamina | ST | Endurance | Actions physiques, craft |
2026-03-18 19:04:06 +01:00
| Ink | IN | Encre | Rituels, magie noire |
2026-03-10 18:24:01 +01:00
| Gold | GD | Or | Commerce, ameliorations |
| Oxygen | O2 | Oxygene | Exploration spatiale/sous-marine|
| Energy | EN | Energie | Machines, stations de craft |
### Mecaniques de ressources
- Chaque ressource a un **maximum** (cap) qui peut etre ameliore via la Boite d'amelioration.
- Les ressources se consomment lors des aventures, du craft et des interactions.
- Les ressources se restaurent via la Boite de fourniture, les consommables et certaines interactions.
2026-03-18 19:04:06 +01:00
- Certaines ressources sont conditionnelles : **Ink** n'apparait qu'avec le theme DarkFantasy, **Oxygen** qu'avec le theme Space ou des aventures sous-marines.
2026-03-10 18:24:01 +01:00
### Deblocage des ressources
Les ressources ne sont pas toutes disponibles des le debut :
| Ressource | Condition de deblocage |
|-----------|-----------------------------------------------------|
| Health | Debloquee des le debut |
| Mana | Premiere rencontre avec un personnage magique |
| Food | Premiere aventure exploree |
| Stamina | Premiere action physique (combat, craft) |
2026-03-18 19:04:06 +01:00
| Ink | Deblocage du theme DarkFantasy |
2026-03-10 18:24:01 +01:00
| Gold | Premier lieu de commerce decouvert |
| Oxygen | Deblocage du theme Space OU aventure sous-marine |
| Energy | Premiere station de craft construite |
---
## 9. Aventures interactives
### Les 9 themes
Les aventures interactives sont des sequences narratives jouables en CLI, chacune avec son propre univers, ses personnages et ses defis.
#### 1. Space (Espace)
- **Ambiance** : science-fiction, exploration spatiale
- **Lieux typiques** : vaisseaux spatiaux, stations orbitales, planetes alien
- **Ressource cle** : Oxygen
- **Personnages associes** : Farah (pilote), Samuel (ingenieur)
- **Mood possible** : Investigation, Spooky
- **Environnement** : Nature (planetes), Town (stations)
#### 2. Medieval (Medieval)
- **Ambiance** : fantasy medievale, chateaux et donjons
- **Lieux typiques** : chateaux, forets enchantees, villages
- **Ressource cle** : Mana, Stamina
- **Personnages associes** : Malkith (chevalier), Linu (magicienne)
- **Mood possible** : Tragedy, Romance
- **Environnement** : Nature, Town
#### 3. Pirate
- **Ambiance** : age d'or de la piraterie
- **Lieux typiques** : navires, iles au tresor, ports
- **Ressource cle** : Gold, Stamina
- **Personnages associes** : Duncan (capitaine), Chenda (navigatrice)
- **Mood possible** : Comedy, Investigation
- **Environnement** : Water, Town
#### 4. Contemporary (Contemporain)
- **Ambiance** : monde moderne, thriller urbain
- **Lieux typiques** : villes, bureaux, appartements
- **Ressource cle** : Energy, Gold
- **Personnages associes** : Sandrea (journaliste), Pierrick (hacker)
- **Mood possible** : Investigation, Comedy
- **Environnement** : Town
#### 5. Sentimental
- **Ambiance** : romance, relations humaines, emotions
- **Lieux typiques** : parcs, cafes, plages au coucher du soleil
- **Ressource cle** : Health (emotionnel), Mana (intuition)
- **Mood possible** : Romance, Tragedy, Comedy
- **Environnement** : Nature, Town
#### 6. Prehistoric (Prehistorique)
- **Ambiance** : ere prehistorique, survie primitive
- **Lieux typiques** : grottes, jungles, volcans
- **Ressource cle** : Food, Stamina
- **Personnages associes** : personnages primitifs
- **Mood possible** : Dark, Comedy
- **Environnement** : Nature
#### 7. Cosmic (Cosmique)
- **Ambiance** : echelle cosmique, entites divines, dimensions paralleles
- **Lieux typiques** : nebuleuses, trous noirs, dimensions alternatives
- **Ressource cle** : Mana, Energy
- **Mood possible** : Spooky, Dark
- **Environnement** : Nature (cosmique)
#### 8. Microscopic (Microscopique)
- **Ambiance** : monde microscopique, cellules, atomes
- **Lieux typiques** : interieur d'un corps humain, molecules, circuits
- **Ressource cle** : Energy, Oxygen
- **Mood possible** : Investigation, Spooky
- **Environnement** : Nature (biologique)
#### 9. DarkFantasy (Dark Fantasy)
- **Ambiance** : fantasy sombre, horreur gothique
- **Lieux typiques** : cryptes, forets maudites, tours sombres
2026-03-18 19:04:06 +01:00
- **Ressource cle** : Ink, Mana
2026-03-10 18:24:01 +01:00
- **Personnages associes** : Malkith (version sombre)
- **Mood possible** : Dark, Spooky, Tragedy
- **Environnement** : Nature, Town
### Structure d'une aventure
Chaque aventure suit cette structure :
1. **Introduction** -- mise en contexte narrative
2. **Exploration** -- le joueur decouvre des lieux et interagit avec l'environnement
3. **Rencontres** -- dialogues avec des PNJ, choix narratifs
4. **Defi** -- combat, enigme ou epreuve
5. **Resolution** -- conclusion de l'aventure avec recompenses
### Recompenses d'aventure
- Objets thematiques (armes, armures, cosmetiques du theme)
- Materiaux rares
- Fragments de lore
- Boites speciales (chance de Boite legendaire)
- Deblocage de personnages
---
## 10. Personnages
### Personnages principaux
Les personnages sont des PNJ que le joueur rencontre et debloque au fil du jeu. Chaque personnage a sa personnalite, son histoire et ses liens avec les themes d'aventure.
#### Farah
- **Role** : Pilote spatiale, exploratrice
- **Theme principal** : Space
- **Personnalite** : courageuse, optimiste, impulsive
- **Lien** : guide le joueur dans les aventures spatiales
- **Quete personnelle** : retrouver son vaisseau perdu
#### Malkith
- **Role** : Chevalier, gardien
- **Theme principal** : Medieval / DarkFantasy
- **Personnalite** : honneur, loyaute, tourmente interieure
- **Lien** : protege le joueur dans les aventures medievales et sombres
- **Quete personnelle** : racheter une faute passee
#### Linu
- **Role** : Magicienne, erudite
- **Theme principal** : Medieval / Cosmic
- **Personnalite** : curieuse, enigmatique, bienveillante
- **Lien** : enseigne la magie et les mysteres cosmiques au joueur
- **Quete personnelle** : dechiffrer un grimoire ancien
#### Chenda
- **Role** : Navigatrice, cartographe
- **Theme principal** : Pirate
- **Personnalite** : pragmatique, debrouillarde, loyale
- **Lien** : guide le joueur sur les mers et dans les explorations
- **Quete personnelle** : cartographier le monde entier
#### Duncan
- **Role** : Capitaine pirate, aventurier
- **Theme principal** : Pirate
- **Personnalite** : charismatique, audacieux, impredictible
- **Lien** : leader naturel, entraine le joueur dans des peripeties
- **Quete personnelle** : trouver le tresor ultime
#### Sandrea
- **Role** : Journaliste d'investigation
- **Theme principal** : Contemporary
- **Personnalite** : tenace, intelligente, ethique
- **Lien** : devoile les mysteres du monde contemporain
- **Quete personnelle** : reveler une conspiration mondiale
#### Samuel
- **Role** : Ingenieur, inventeur
- **Theme principal** : Space / Contemporary
- **Personnalite** : methodique, creatif, reserve
- **Lien** : construit et ameliore les equipements du joueur
- **Quete personnelle** : creer l'invention qui changera le monde
#### Pierrick
- **Role** : Hacker, specialiste techno
- **Theme principal** : Contemporary / Cosmic
- **Personnalite** : cynique, brillant, anti-conformiste
- **Lien** : deverrouille les secrets technologiques et numeriques
- **Quete personnelle** : hacker la realite elle-meme
### Personnages secondaires
Au-dela des 8 personnages principaux, le jeu contient de nombreux PNJ secondaires :
- **Marchands** -- vendent et achetent des objets contre de l'or
- **Gardiens de lieux** -- protegent l'acces aux lieux importants
- **Conteurs** -- revelent des fragments de lore
- **Artisans** -- gerent les stations de craft
- **Guides d'aventure** -- accompagnent le joueur dans les aventures thematiques
- **Enigmatiques** -- personnages mysterieux qui apparaissent aleatoirement
### Relations entre personnages
Les personnages ont des relations entre eux qui influencent les dialogues et les aventures :
- **Farah & Samuel** -- collaboration professionnelle, amitie
- **Malkith & Linu** -- respect mutuel, mentor/eleve
- **Duncan & Chenda** -- capitaine/navigatrice, confiance totale
- **Sandrea & Pierrick** -- journaliste/hacker, alliance tactique
- **Malkith (Medieval) & Malkith (DarkFantasy)** -- deux facettes du meme personnage
---
## 11. Localisation
### Langues supportees
| Code | Langue | Statut |
|------|----------|-------------|
| FR | Francais | Principal |
| EN | Anglais | Secondaire |
### Strategie de localisation
- **Texte de l'interface** : localise via des fichiers de ressources (`.resx` ou JSON)
- **Noms des objets** : localises (ex: "Epee en acier" / "Steel Sword")
- **Noms des personnages** : non localises (les noms propres restent identiques)
- **Fragments de lore** : localises integralement (textes narratifs)
- **Aventures** : dialogues et descriptions localises
- **Enums et cles internes** : en anglais (code source)
### Exemples de localisation
| Cle | FR | EN |
|-------------------------|------------------------------|-----------------------------|
| `ui.open_box` | Ouvrir la boite | Open the box |
| `ui.inventory` | Inventaire | Inventory |
| `item.steel_sword` | Epee en acier | Steel Sword |
| `resource.health` | Points de vie | Health Points |
| `adventure.space.intro` | L'espace infini s'ouvre... | The infinite space opens... |
| `box.starter` | Boite de depart | Starter Box |
| `box.meta` | Boite Meta | Meta Box |
| `box.stylish` | Boite stylee | Stylish Box |
| `error.gender` | ERROR: les boites n'ont pas de genre. | ERROR: boxes don't have a gender. |
---
## Annexe A : Glossaire
| Terme | Definition |
|----------------------|----------------------------------------------------------------------------|
| Black Box Sim | Pattern de design ou les mecaniques internes sont opaques pour le joueur |
| Loot table | Table de probabilites definissant le contenu d'une boite |
| Auto-activation | Interaction automatique entre objets de l'inventaire |
| UIFeature | Fonctionnalite d'interface debloquable |
| Blueprint | Plan permettant de construire une station de craft |
| Fragment de lore | Morceau d'histoire collectible |
| AdventureToken | Jeton d'acces a une aventure thematique |
| Teinture | Couleur applicable a un cosmetique |
| Boite a boite | Boite centrale contenant d'autres boites |
| Boite noire | Boite au contenu totalement aleatoire |
## Annexe B : Conditions de loot (LootConditionType)
Les conditions de loot controlent la disponibilite des objets dans les loot tables :
| Condition | Description |
|--------------------|----------------------------------------------------------|
| HasItem | Le joueur possede un objet specifique |
| HasNotItem | Le joueur ne possede PAS un objet specifique |
| ResourceAbove | Une ressource est au-dessus d'un seuil |
| ResourceBelow | Une ressource est en-dessous d'un seuil |
| BoxesOpenedAbove | Le nombre total de boites ouvertes depasse un seuil |
| HasUIFeature | Le joueur a debloque une fonctionnalite d'interface |
| HasWorkstation | Le joueur possede une station de craft specifique |
| HasAdventure | Le joueur a acces a un theme d'aventure |
| HasCosmetic | Le joueur possede un cosmetique specifique |
## Annexe C : Stats du joueur
| Stat | Description | Impact |
|----------------|------------------------------------------------|--------------------------------------|
| Strength | Force physique | Degats melee, capacite de transport |
| Intelligence | Intelligence | Degats magiques, efficacite de craft |
| Luck | Chance | Probabilites de loot ameliorees |
| Charisma | Charisme | Prix des marchands, dialogues |
| Dexterity | Dexterite | Esquive, vitesse, precision |
| Wisdom | Sagesse | Regeneration de mana, intuition |
---
*Fin du Game Design Document -- Open The Box v0.1.0-alpha*
