Gearuna Début & découverte
Early-game réellement en place — spawn, sondages scriptés, coach tutoriel, déblocages boutique / énergie / recherche.
Début & découverte
Statut : implémenté — source de vérité code : game/definitions/tutorial.ts, earlyDiscovery.ts, surveyScripts.ts, shopUnlocks.ts.
Ce document décrit le scénario early réellement livré. L’ancienne spec « mineurs camp craftés + charbon garanti sondage 2–3 » est abandonnée (voir Historique design).
Intent (conservé)
Remplacer « je spawn déjà dans une mini-usine » par :
- Découvrir le site (sondage)
- Sondage → pierre → fer (charge offerte en poche)
- Première usine : four fuel (bois) + foreuse câblée
- Générateur → énergie réseau
- Science → labo → recherche
Pas de Dynamo. Pas de combat. Machines early = boutique (pas craft manuel de machines).
Spawn (Acte 0)
| Élément | Valeur |
|---|---|
| Canvas | 1 forêt déjà placée |
| Poche | Vide — 1 charge offerte après la 1ʳᵉ récolte de bois |
| Gears | 0 |
| HUD | Boutique / monnaie masqués jusqu’à la carrière de pierre (sondage étape 2) |
| Craft manuel | Aucune recette au départ |
| File sondage | FIRST_SURVEY_SCRIPT → carrière de pierre garantie |
Tooltip charge : « Premier sondage : révèle une carrière de pierre. »
Coach tutoriel (7 étapes)
Affiché tant que le joueur n’a pas produit de recherche (sauf saves legacy déjà en ère énergie sans générateur).
| Étape | Titre | Tâches (ordre) |
|---|---|---|
| 1 | Découvrir le site | Récolter du bois |
| 2 | Trouver la pierre | Activer la sonde → Utiliser la sonde |
| 3 | Trouver le fer | Vendre une ressource → Acheter une sonde → Trouver du fer |
| 4 | Fondre du fer | Acheter un four → Alimenter en bois → Mettre du fer → Faire fondre |
| 5 | Automatiser | Acheter une foreuse → L’alimenter → Dock sur le fer → Relier foreuse → four |
| 6 | Énergie | Acheter un générateur → L’alimenter |
| 7 | Recherche | Craft science rouge → Acheter labo → Sélectionner une tech → Produire de la recherche |
Highlights UI (pulse) selon la tâche active : poche sonde, canvas, Sell, offres boutique, four, foreuse, générateur, onglet recherche, labo.
À la fin du coach (première recherche produite), un dialogue propose de lier son compte pour la sauvegarde cloud et le classement. « Plus tard » masque définitivement ce message sur l’appareil ; la liaison reste accessible dans les réglages HUD.
Sondages scriptés (anti-softlock)
| Moment | Résultat |
|---|---|
| Spawn | Forêt déjà sur le schéma (jamais sondée) |
| 1ʳᵉ charge (offerte) | 100 % carrière de pierre (stone) |
| Prochaine early (pierre + bois présents, fer absent) | Gisement de fer garanti |
| Ensuite | Table aléatoire : fer / cuivre / pierre — pas de forêt, pas de charbon sans tech Charbon |
Implémentation : surveyScriptQueue + resolveNextEarlySurveyPurchaseScript.
Déblocages progressifs
| Déclencheur | Effet |
|---|---|
| 1ᵉʳ bois miné (pioche) | — (boutique toujours masquée) |
| Carrière de pierre révélée (sondage étape 2) | Boutique (machine_dock) + barre de monnaie + zone Sell |
| Pierre + forêt + fer sur le schéma | Offre Four (coal_furnace_mk1) |
| 1 lingot de fer (poche ou sortie four) | Offre Foreuse |
| Au moins une foreuse placée | Offre Générateur |
| Achat / fuel générateur | Jauge Énergie (energy_bar) ; offre Labo |
| Ligne fer → foreuse (fuel) → four (fuel) + ère énergie | Craft science rouge + HUD Recherche |
Prix early (base boutique ; machines scalent ×1,15 / achat) :
| Offre | Prix |
|---|---|
| Charge de sondage | 50 (fixe) |
| Four (fuel) | 100 |
| Foreuse | 200 |
| Générateur | 300 |
| Laboratoire | 500 |
Revente utile early : bois 1 · pierre 2 · fer brut 3 · lingot fer 6.
Machines early (comportement)
Four (coal_furnace_mk1)
- Pins : entrée minerai · sortie lingot · fuel
- Fuel : bois ou charbon (pas charbon seul)
- Recette early : 1 fer brut → 1 lingot / 3 s (cuivre aussi si dispo)
- Sans énergie réseau
Foreuse (drill_mk1)
- Dock sur gisement (exploitation)
- Fuel bois/charbon → énergie interne ; extrait vers buffer / câble
- Pas le « mineur camp buffer-only » de l’ancienne spec
- Première automation = câbler sortie → four
Générateur (generator_mk1)
- Fuel bois/charbon → réserve d’énergie globale
- Débloque l’ère énergie (HUD + machines électriques plus tard)
Craft manuel
- Machines uniquement boutique
- Science rouge : 1 lingot → 1 pack / 5 s (consomme de l’énergie)
- Plaques / bobines : techs ultérieures
Charbon
- Pas au early scripté
- Tech Charbon (
coal_prospecting, 12 science) → sondages peuvent révéler du charbon (1er gisement favorisé) - Tech Cuivre (
copper_prospecting, 15 science) → sondages peuvent révéler du cuivre (1er gisement favorisé) - Meilleur fuel (générateur / four / foreuse) une fois obtenu
Ce que le script enseigne
| Moment | Leçon |
|---|---|
| Forêt + pioche | Explorer / récolter |
| Vente → sonde | Monétiser le terrain |
| Pierre puis fer | Diversité de spots, anti-softlock |
| Four bois | Première machine I/O + fuel |
| Foreuse câblée | Automation graphe |
| Générateur | Énergie réseau |
| Science + labo | Boucle recherche |
Règles dures (anti-softlock)
- Forêt déjà sur le schéma au spawn (jamais sondée)
- 1ʳᵉ charge offerte → pierre
- Fer garanti via prochain achat early (pierre + forêt présents)
- Coach jusqu’à produire de la recherche
- Tâche automate : dock fer + lien four (évite science sans ligne)
- Pas d’énergie HUD tant que le générateur n’est pas là
- Charbon hors tuto (tech)
Historique design
Ancienne intention (non livrée) :
- 1ᵉʳ sondage = pierre ; charbon garanti sondages 2–3
- Mineurs craftés (pierre/bois/fer), buffer inventaire, pas de pin usine
- Four fuel charbon uniquement ; bois réservé aux mineurs
Puis : 1ʳᵉ charge → forêt, 2ᵉ → pierre, 3ᵉ → fer.
Remplacé par : forêt au spawn, 1ʳᵉ charge → pierre, fer au prochain achat early ; four/foreuse/générateur boutique ; fuel bois early ; charbon via recherche.