# Cuisinier Meshy — version intégrée

Le personnage humain de `assets/story/intro/08_omelette_single.png` a été préparé en pose T avec l'outil imagegen intégré, puis généré et riggé par le serveur MCP officiel Meshy. La référence est `source/meshy_v2/cook_t_pose.png` ; son prompt complet est conservé dans `source/meshy_v2/reference_prompt.txt`.

## Livrables

- Modèle du jeu : `assets/models/player/intro_cook_meshy/intro_cook_meshy.glb` (chemin relatif à `big-egg-3d`).
- Source Blender avec textures embarquées et huit animations : `source/meshy_v2/intro_cook_meshy.blend`.
- Aperçus : `source/meshy_v2/Idle_preview.png`, `Walking_preview.png`, `RunFast_preview.png`, `Triple_Combo_Attack_preview.png`, `intro_cook_meshy_walk.gif`.
- Construction reproductible à partir des téléchargements : `build_meshy_cook.py` avec Blender 4.5. Aucune génération payante n'est relancée par ce script.
- Serveur et client MCP locaux : `../meshy/README.md`. La configuration globale de Codex est indépendante.

Le modèle exporté contient 57 697 triangles, 24 os, une surface texturée et les matériaux PBR du modèle Meshy original. L'icosphère auxiliaire présente dans l'export de rig Meshy a été retirée pour ne pas fausser le cadrage et la taille en jeu. Le visage est fixe et les doigts ne sont pas articulés séparément.

## Animations et gestionnaire PHP

La seule modification des données est le chemin `player_configs.default_player.model_3d.path`, dans le maître et le brouillon PHP. Toutes les associations, vitesses, offsets, l'os `Spine`, le masque du haut du corps et les fondus restent ceux de la fiche joueur.

| État du joueur | Clip |
| --- | --- |
| Repos | Idle |
| Marche | Walking |
| Attaque | Triple_Combo_Attack |
| Dash | RunFast |
| Blessure | Hurt |

`Walking` et `Running` viennent des animations incluses dans le rigging Meshy. `RunFast` accélère la course. `Idle`, `Hurt`, `Triple_Combo_Attack`, `Dead` et `Skill_01` sont adaptés de la bibliothèque de la première version, avec correction entre les poses A et T. Les appuis du repos et du recul conservent l'angle des semelles du nouveau modèle. Les clips n'entraînent pas de déplacement horizontal du joueur : la simulation 2D garde cette responsabilité.

Le gestionnaire PHP scanne le nouveau GLB et propose ses huit clips. Les anciens GLB restent disponibles dans son sélecteur pour revenir à une version précédente.

## Provenance et crédits

- Génération : Meshy 7, modèle standard texturé PBR 2K, pose T, remesh demandé à 30 000 polygones ; tâche `01a0aa62-ac21-7582-b495-35755ded3c73` : **30 crédits**.
- Squelette et marche/course incluses : tâche `01a0aa67-ce2b-70d7-9cec-dd2629be00f8` : **5 crédits**.
- Total des tâches Meshy de cette intervention : **35 crédits**. Aucun achat ni recharge effectué. Ce total provient des tâches, pas de la différence du solde du compte, qui peut aussi évoluer avec d'autres usages.
- La clé a été transmise au serveur local en mémoire, sans être enregistrée dans le projet.

## Validation du 16 septembre 2026

- Validateur PHP : zéro erreur dans le maître et le brouillon ; API de scan : ressource importée et huit clips reconnus.
- Contrôle ciblé du héros : zéro échec ; skin lié au squelette et poses réellement différentes dans les cinq états.
- Parcours graphique : clavier, restaurant, départ comique, projections, donjon et retour intact réussis.
- Test général exécuté seul : **57 échecs, identiques au témoin avant changement**. Une exécution simultanée avec le rendu a ajouté sept échecs de service ; ils disparaissent lors de l'exécution isolée.
- Le test complet du pont rencontre une erreur dans son contrôle de construction (`bridge_3d_check.gd:137`, hypothèse sur un enfant `MeshInstance3D`). Elle est reproduite avec l'ancien personnage. Les avertissements graphiques de libération de texture à la fermeture étaient également présents avant cette intervention.
- Comparaison des fichiers : seul le chemin du modèle joueur change ; les réglages et modifications indépendantes du brouillon sont préservés.

Journaux et sauvegarde avant intégration : `_backups/meshy-cook-integration-20260916/`. Sauvegarde initiale de l'intervention : `_backups/meshy-cook-20260916/`.