Samuel Bouchet 04894a4906 Initial project setup: Open The Box CLI game

- .NET 10 console app with Spectre.Console and Loreline integration
- Black Box Sim architecture (simulation separated from presentation)
- Progressive CLI rendering (9 phases from basic to full layout)
- 25+ box definitions with weighted loot tables
- 100+ item definitions (meta, cosmetics, materials, adventure tokens)
- 9 Loreline adventures (Space, Medieval, Pirate, etc.)
- Bilingual content (EN/FR)
- Save/load system
- Game Design Document

2026-03-10 18:24:01 +01:00

48 KiB

Raw Blame History

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

Vue d'ensemble / Concept
Mecanique principale : ouverture de boites
Systeme de progression CLI (Phases 0-8)
Systeme de boites
Auto-activation (cle + coffre, interactions automatiques)
Personnalisation
Materiaux et Craft
Ressources
Aventures interactives
Personnages
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

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.
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.
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.
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

Le joueur selectionne une boite dans son inventaire (ou la boite est auto-selectionnee au debut du jeu).
Le systeme de loot tire un ou plusieurs objets selon la loot table de la boite.
L'objet est ajoute a l'inventaire du joueur.
Le systeme d'auto-activation verifie si des interactions sont possibles avec les objets existants.
Si des interactions existent, elles sont executees automatiquement (ouverture de coffre, activation de lieu, etc.).
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
Blood (sang)	3	Restaure du sang (ressource rare)
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)

5. Auto-activation (cle + coffre, interactions automatiques)

Principe

L'auto-activation est un systeme central d'Open The Box. Lorsqu'un objet est ajoute a l'inventaire du joueur, le systeme verifie automatiquement si cet objet peut interagir avec un autre objet deja present.

Types d'interactions automatiques

Interaction	Declencheur	Resultat
Cle + Coffre	Cle et coffre correspondants	Le coffre s'ouvre, revelant son contenu
Carte + Lieu	Carte d'un lieu + badge d'exploration	Le lieu est deverrouille
Token + Aventure	AdventureToken + seuil de progression	L'aventure devient accessible
Blueprint + Materiaux	Blueprint + materiaux requis	La station de craft est construite
Fragment + Fragment	Fragments complementaires	Un lore complet est revele
Consommable + Ressource	Consommable + ressource cible	La ressource est restauree

Flux d'auto-activation

1. Objet ajoute a l'inventaire
2. Pour chaque objet de l'inventaire :
   a. Verifier si une interaction est possible avec le nouvel objet
   b. Si oui, executer l'interaction
   c. L'interaction peut produire de nouveaux objets
   d. Si de nouveaux objets sont produits, repeter depuis l'etape 2
3. Fin de la chaine d'auto-activation

Chaines d'activation

Les auto-activations peuvent creer des chaines : ouvrir un coffre peut reveler une cle qui ouvre un autre coffre, qui contient un fragment qui complete un lore, qui debloque un personnage. Ces chaines sont l'un des moments les plus satisfaisants du jeu.

Type de resultat d'interaction (InteractionResultType)

Chaque interaction produit un resultat type parmi :

OpenBox -- ouverture d'une boite ou d'un coffre
Craft -- fabrication d'un objet
Transform -- transformation d'un objet en un autre
Consume -- consommation d'un objet (potion, nourriture)
Unlock -- deblocage d'un contenu (lieu, aventure, personnage)
Combine -- combinaison de plusieurs objets en un seul
Teleport -- deplacement vers un nouveau lieu

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
Blood	BL	Sang	Rituels, magie noire
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.
Certaines ressources sont conditionnelles : Blood n'apparait qu'avec le theme DarkFantasy, Oxygen qu'avec le theme Space ou des aventures sous-marines.

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)
Blood	Deblocage du theme DarkFantasy
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
Ressource cle : Blood, Mana
Personnages associes : Malkith (version sombre)
Mood possible : Dark, Spooky, Tragedy
Environnement : Nature, Town

Structure d'une aventure

Chaque aventure suit cette structure :

Introduction -- mise en contexte narrative
Exploration -- le joueur decouvre des lieux et interagit avec l'environnement
Rencontres -- dialogues avec des PNJ, choix narratifs
Defi -- combat, enigme ou epreuve
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

48 KiB Raw Blame History