builazoo/docs/specs/joueur.md

Spécifications : Joueur

Définition

L'utilisateur humain.

Propriétés

• Compte : Authentifié par clé privée (pas de mot de passe).
• Ressources : Pièces, Unités de recherche.
• Zoo : Possède et gère un unique zoo.
• Démarrage : Commence avec 200 pièces et 3 couples reproducteurs basiques.

Actions

• Achat/Vente.
• Placement/Déplacement.
• Upgrade bâtiments/carte.
• Gestion des incidents visiteurs.
• Configuration du profil d'absence (Bot).

Annexes Techniques

1. Données et États

Modèle de Données (JSON)

{
  "id": "uuid",
  "public_key": "string (ed25519)",
  "username": "string",
  "created_at": "timestamp",
  "last_login": "timestamp",
  "resources": {
    "coins": "integer",
    "research_points": "integer"
  },
  "settings": {
    "music_enabled": "boolean",
    "bot_profile_id": "integer"
  }
}

Caractéristiques Initiales

Caractéristique	Valeur Initiale
Pièces	200
Recherche	0
Animaux	3 couples (6 animaux)

Scores Initiaux

Niveau Joueur : 1.

2. Cycles de Vie et Apparition

Conditions d'Apparition

Inscription.

Conditions de Disparition

Suppression compte.

Hérédité

Héritage : Le joueur garde son niveau et ses recherches après un reset.

3. Impacts Environnementaux

Impact Température

Confort : Le joueur doit gérer la température pour ses animaux.

Impact Milieu (Biome)

Stratégie : Le joueur choisit les biomes à développer.

Impact Saisons

Planification : Le joueur adapte sa stratégie aux saisons.

Impact Heure / Jour-Nuit

Gestion : Le joueur gère les cycles d'ouverture.

4. Impacts Biologiques et Sociaux

Impact Reproduction

Démarrage autonome : Le joueur reçoit 3 couples reproducteurs basiques (Lapins/Poules/Canards selon biome) pour garantir une reproduction immédiate et alimenter le marché bas prix.

Impact Mort

Gestion Crise : Le joueur doit réagir aux décès.

Impact Nourriture

Logistique : Le joueur achète la nourriture.

Impact Attractivité (Visiteurs/Animaux)

Objectif : Maximiser l'attractivité.

Impact Valeur

Finance : Gérer le budget.

5. Impacts Logistiques et Économiques

Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)

N/A

Dépenses (Boutiques/Visiteurs)

N/A

Trajet Visiteurs

Design : Le joueur trace les routes.

6. Événements

Événements du Jeu / Carte / Zoo / Ville / Visiteur

• Connexion : Chargement état.
• Quête : Validation.

7. Progression

Tableau des Upgrades

Niveau	Coût	Avantage
1	0	Accès de base
2	1000	Accès statistiques avancées

8. Logique et Interfaces

Pseudo-code Impacts

function playerAction(action):
  if checkResources(action.cost):
    execute(action)

Messages d'Infos / Alerte

ID	Niveau	Message
WELCOME	Info	"Bienvenue dans votre nouveau zoo !"
NO_MONEY	Alerte	"Fonds insuffisants."

Annexes UX/UI

1. Expérience Utilisateur (UX)

HUD Principal (Permanent)

Description UX : Le joueur voit en permanence ses ressources et accès rapides. Description UI : Barre supérieure avec Compteurs (Pièces, Recherche, Réputation). Barre inférieure ou latérale avec Menus (Construction, Carte Monde, Inventaire, Profil). Emplacement : Écran (Overlay). Intégration : Fixe. Navigation : Clic Menu -> Ouverture Panneau. Événements : UI_CLICK.

Assets

• Musiques : N/A
• Sons : ui_click.mp3.
• Graphiques : Style UI "Bois et Pierre" ou "Moderne Clean".
• Images : Icônes (Pièce, Fiole, Marteau, Carte).
• Vidéos : N/A
• Animations : Compteurs qui défilent quand gain/perte.
• Couleurs : Or, Bleu, Blanc.
• Textes : Chiffres, Labels menus.
• Formes : Barres, Boutons ronds.

Profil & Bot (Configuration)

Description UX : Le joueur configure son avatar et son bot d'absence. Description UI : Modal Profil. Onglet "Gestion Absence" avec sélecteur de Bot (Famille > Spécialisation). Emplacement : Menu Profil. Intégration : Modal. Navigation : Profil -> Bot -> Sauvegarder. Événements : SAVE_PROFILE.

Assets

• Musiques : N/A
• Sons : save_success.mp3.
• Graphiques : Portraits de bots.
• Images : Avatars joueurs.
• Vidéos : N/A
• Animations : Checkmark vert.
• Couleurs : Bleu UI.
• Textes : Description des bots ("Le Conservateur : Achète de la nourriture...").
• Formes : Cartes de sélection.