> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟧 Modifier personnage

# 🟧 Modifier personnage

${frame}[Vidéo : anatomie du bloc Modifier personnage](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/editcharacter.html)

![Modifier personnage](https://celestory-docs-illustrations.netlify.app/fr/Modifierpersonnage_FR.svg)

Le bloc Modifier personnage permet de mettre à jour dynamiquement les attributs et le visuel d'un personnage pendant l'exécution de l'application (ex: chatbot), sans avoir à recréer un nouveau personnage.

Ce bloc est particulièrement utile pour refléter des changements d'état émotionnel ou contextuel d'un personnage (ex: passage de "Bob Joyeux" à "Bob Triste") en modifiant son avatar, son style de texte ou ses effets d'animation.

## 📥 Entrées

-   in (Flow) : Le flux narratif déclenchant la modification du personnage.
-   character (ChatbotCharacterRef) : Référence statique du personnage à modifier.
-   image (Image) : (Optionnel) Nouvelle ressource image pour l'avatar du personnage.
-   entranceEffect (Animation) : (Optionnel) Effet d'animation lors de l'apparition du personnage (ex: entrée par la gauche).
-   textStyle (TextStyle) : (Optionnel) Style de texte appliqué aux messages du personnage (police, couleur).
-   borderImage (Style) : (Optionnel) Style des bulles de discussion (fond, bordure) — pas une simple image, mais une ressource de style pouvant elle-même contenir une image.

## 📤 Sorties

-   out (Flow) : Flux sortant activé après application des modifications au personnage.

## 💡 Exemple d'utilisation

Scénario : Évolution émotionnelle d'un personnage dans un quiz

1. Un personnage "Maître du Quiz" est créé avec un avatar neutre et une bulle de texte bleue.
1. L'utilisateur répond correctement à une question difficile.
1. Le bloc Modifier personnage est déclenché pour cibler "Maître du Quiz".
1. L'entrée image est mise à jour avec un avatar souriant, et textStyle passe en vert.
1. Lors de la prochaine interaction, le personnage apparaît avec son nouveau style, reflétant sa satisfaction.

## ⚙️ Détails Techniques

-   Gestion des options : Les entrées optionnelles non renseignées conservent leur valeur précédente.
-   Performance : Les modifications sont appliquées en temps réel sans rechargement du personnage.
-   Compatibilité : Fonctionne avec tous les blocs affichant des personnages (ex: showText, showCharacter).

---

*Version documentée : v2*