Méthode de création

Cette page est la méthode et la référence du code d'un œuf LiveGotchi : comment on dessine une créature, ses évolutions, ses pouvoirs, un décor, et ce que le code doit dire. Elle se lit aussi bien qu'elle se donne à une IA à qui on demande d'en écrire un. Tout ce qui est écrit ici est ce que l'atelier de création accepte, ni plus ni moins.

Ce qu'on te demande

LiveGotchi est une créature en pixels qui vit sur l'overlay d'un direct Twitch. Elle naît d'un œuf, éclot, puis évolue d'étape en étape selon ce que le direct lui apporte. Un joueur te donne cette page, souvent avec un œuf existant en modèle, et te demande d'en écrire un : tu réponds avec un seul document JSON, complet, et rien d'autre. Une clôture ```json autour est tolérée ; un commentaire, une phrase avant ou après, un JSON incomplet ne le sont pas.

• Si le joueur te donne un œuf en modèle, garde sa grille et son style ; change ce qu'il te demande de changer.
• Si le joueur te demande une seule animation ou une seule image, réponds avec le fragment demandé, dans la même forme que ci-dessous.
• Chaque contrainte de cette page est vérifiée à l'import : un écart refuse tout le code, avec la raison. Relis les limites à la fin avant de répondre.

Sommaire

1. La structure d'un œuf
2. Étapes, éclosions, évolutions, branches
3. Les conditions et les besoins
4. Les animations
5. Les images, les calques, la palette
6. Les repères de la grille
7. Comment dessiner
8. Les pouvoirs
9. La répartition
10. Les décors
11. Toutes les limites
12. Les erreurs les plus fréquentes
13. Un œuf complet en exemple

1. La structure d'un œuf

Un œuf est un objet JSON. Ses champs, dans l'ordre où il vaut mieux les écrire :

Aucun autre champ n'est admis. Un champ inconnu refuse le code.

2. Étapes, éclosions, évolutions, branches

Chaque entrée de etapes est une étape de la vie de la créature : une apparence, avec ses animations, et ce qu'il faut pour y arriver.

Les mots

• L'œuf est la première étape. Elle n'a pas de sous, pas de condition, et une seule animation, nommée oeuf.
• Une éclosion est une étape juste sous l'œuf. C'est la première apparence de la créature.
• Une évolution est une étape sous une éclosion, ou sous une autre évolution. L'atelier les numérote : Évolution 1, Évolution 2…
• Des branches sont plusieurs étapes qui se rattachent à la même. Quand la créature est prête à évoluer, elle prend la première branche, dans l'ordre de la liste, dont la condition est remplie.
• Le repli est une branche sans condition : la créature y va quand aucune autre branche ne s'ouvre — il attend d'abord l'heure de la sœur la plus tardive, pour que chacune ait sa chance. Écris-le en dernier parmi ses sœurs. Une étape sans repli et dont aucune condition ne se remplit garde la créature où elle est.
• La profondeur compte les niveaux sous l'œuf : l'éclosion est au niveau 1, l'évolution qui la suit au niveau 2, et ainsi de suite.

Les bornes : l'œuf ouvre huit éclosions au plus ; une étape ouvre dix branches au plus ; l'arbre descend dix niveaux au plus sous l'œuf. Une créature n'a pas besoin de tout ça : une éclosion et trois ou quatre évolutions en ligne font déjà une belle vie. Un arbre linéaire (chaque étape sous la précédente, sans branche) est parfaitement valable.

Les stades de la créature suivent la profondeur : éclos, petit, jeune, ado, adulte, aguerri, ancien, sage, légende, mythe. Le joueur les voit dans l'élevage ; toi, tu n'as qu'à nommer les étapes.

3. Les conditions et les besoins

Une condition est un objet dont chaque champ est un critère. Tous les critères présents doivent être remplis en même temps. Les compteurs se mesurent pendant les heures d'antenne : le temps où le joueur est en direct. Le temps hors direct ne compte pas.

Combien d'heures ? Une évolution se mérite

Compte au moins dix heures d'antenne par étape, et jusqu'à vingt-quatre pour les dernières. En dessous, la créature traverse tout l'arbre en une soirée et le joueur n'a plus rien à attendre.

Ce que tu écris n'est pas une récompense à distribuer : c'est un défi engageant. Le streamer doit le poursuivre sur des semaines, et son chat doit pouvoir le suivre avec lui.

• Monte l'exigence en descendant dans l'arbre : dix heures pour l'éclosion, quinze pour la suivante, vingt puis vingt-quatre pour les dernières.
• Mêle les compteurs du direct aux heures : une évolution qui demande des followers, des messages ou un raid donne au public un rôle à jouer.
• Laisse un repli atteignable : une branche exigeante qui échoue doit mener quelque part, pas bloquer la créature pour toujours.

Les quatre états : sante, force, precision, mana. Les compteurs :

Les besoins ont un seul champ, usure : pour chaque état, une vitesse d'usure parmi 0.5, 0.75, 1, 1.5, 2. Un état absent s'use comme d'habitude. Exemple : { "usure": { "sante": 2, "mana": 0.5 } } pour une étape fragile mais sociable.

{
  "nom": "Renard ardent", "sous": "Renardeau",
  "condition": { "minHeures": 12, "minJauge": { "force": 60 }, "minCompteur": { "follows": 10 } },
  "besoins": { "usure": { "force": 1.5 } },
  "animations": { … }
}

Un tempérament par branche, dès le soigné. Deux voies nées de la même éclosion ne se distinguent pas seulement par leur allure : donne à chaque feuille — une étape qui n'a rien sous elle — ses propres besoins. La voie de la force mange plus, celle du mana s'ennuie plus vite. Sans cela, choisir une branche ne change rien à la façon de s'en occuper, et le choix devient décoratif.

4. Les animations

animations est un objet : le nom de l'animation en clé, et pour valeur une palette et une liste d'images. Les noms sont en minuscules, sans espace ni accent, 24 caractères au plus. Certains noms ont un rôle ; tout autre nom est admis mais l'overlay ne saura pas quand le jouer.

Le sens

marche, course, saut, vol, grimpe, attaque et sort se dessinent une seule fois, la créature tournée vers la droite. L'overlay les retourne en miroir quand elle va vers la gauche. Ne dessine jamais une version « vers la gauche ».

Le rythme

Chaque animation a huit images au plus par défaut (le studio peut relever cette borne ; le joueur te le dira). Une étape a 40 animations au plus. Les images se jouent en boucle, dans l'ordre ; deux à quatre images suffisent pour un repos qui respire, quatre à six pour une marche.

Quelles émotions dessiner, et quand elles se jouent

Quatorze noms d'émotion sont acceptés, listés ci-dessus. Tu n'as pas à les dessiner toutes, et il vaut mieux en réussir quatre que bâcler quatorze.

Quand elles se jouent. L'overlay choisit une seule émotion à chaque instant, dans cet ordre, et s'arrête à la première qui répond :

1. morte, puis endormie : elles priment sur tout.
2. une humeur passagère, posée par ce qui vient de se passer, le temps qu'elle dure.
3. malade, si la santé tombe à 20 % ou moins.
4. le besoin exprimé : il passe avant les seuils, c'est ce que la créature réclame et c'est à lui que le streamer doit répondre.
5. fatigue sous 15 % de force, ennuye sous 15 % de précision, triste sous 15 % de mana.
6. sinon la moyenne des quatre états : heureux au-dessus de 85 %, content au-dessus de 65 %, ennuye au-dessus de 40 %, triste en dessous.

L'animation qui porte le nom de l'émotion remplace le repos tant qu'elle dure. Si tu ne l'as pas dessinée, le repos continue : rien ne casse, mais la créature ne dit rien de ce qu'elle ressent.

Lesquelles choisir en premier. Celles que cet ordre produit vraiment : malade, affame, fatigue, ennuye, triste, content, heureux. Les rares — amoureux, fier, effraye — se dessinent après, quand les sept premières existent.

Réagir à ce que dit le chat. Le champ declencheurs, en tête de l'œuf, associe un mot ou un émoji à une émotion : "declencheurs": { "🔥": "excite", "gg": "fier", "Kappa": "content" }. Quand le chat l'écrit, la créature joue cette émotion. La clé est un mot ou un émoji de 24 caractères au plus, comparée sans majuscules ; la valeur, une émotion que la créature dessine — une émotion sans animation refuse le code. Soixante-quatre entrées au plus. C'est le créateur qui décide ; le streamer ne remplit que les cases laissées libres et ne réécrit jamais une clé de l'œuf.

5. Les images, les calques, la palette

Une animation :

"repos": {
  "palette": { "#": "#c8742a", "o": "#ffffff", "x": "#1a1a1a" },
  "images": [
    { "calques": [ { "nom": "Corps", "rangees": [ "................", … 16 rangées … ] } ] },
    { "calques": [ { "nom": "Corps", "rangees": [ … ] }, { "nom": "Yeux", "opacite": 100, "rangees": [ … ] } ] }
  ]
}

• La palette est propre à l'animation : un caractère → une couleur #rrggbb. Un caractère est un seul signe ; le point . est réservé au transparent et ne se déclare pas.
• Une image est une liste de calques, quatre au plus, du fond vers le devant. Chaque calque a un nom (24 caractères au plus), ses rangees, et, facultatifs, visible (vrai par défaut) et opacite (1 à 100).
• Les rangées : exactement grille chaînes de exactement grille caractères, du haut vers le bas, de gauche à droite. Chaque caractère est dans la palette, ou est le point.
• Une image donnée comme simple liste de rangées, sans calques, est acceptée : c'est un seul calque nommé « Fond ».
• Une image peut porter "effets": ["Choc"] : les pouvoirs de l'œuf, par nom, qu'elle déclenche quand elle s'affiche. C'est ainsi qu'une attaque lance un projectile au bon moment.

6. Les repères de la grille

Une grille n'est pas un cadre flottant : c'est une scène. Trois repères la tiennent, les mêmes pour toutes les images d'un œuf. Les oublier est l'erreur de dessin la plus fréquente.

             l'axe, entre les colonnes 8 et 9
                    |
   rangée  1   ................   le ciel : vide
   rangée  2   ......####......
   rangée  3   .....#oooo#.....
   rangée  4   ....#oooooo#....
      ...      ................
   rangée 14   ....#oo..oo#....
   rangée 15   .....#o..o#.....
   rangée 16   .....##..##.....   la ligne de sol : les pieds y touchent

• L'œuf se pose comme le reste. Son bas touche la dernière rangée. Un œuf centré verticalement paraît suspendu, et l'éclosion le fait sauter d'un coup.
• Le sol ne bouge pas d'une étape à l'autre. Un bébé haut de dix rangées et un adulte de cinquante partagent la même ligne de sol : l'adulte occupe plus de rangées vers le haut. C'est ce qui donne l'impression qu'il grandit.
• Ni d'une image à l'autre. Dans une animation, les pieds restent sur la même rangée ; ce qui respire, c'est le corps. Un personnage qui monte et descend en entier donne l'impression de flotter.
• Deux exceptions, et deux seulement. vol se dessine en l'air. saut quitte le sol sur ses images du milieu et le retrouve à la dernière.
• Les décors ont leurs propres repères. Une tuile de sol ou de papier peint remplit toute sa grille, bord à bord, sans marge : elle se répète, et une marge ferait un trou. Un élément, un cadre, un tableau se centrent sur l'axe et posent leur base sur la dernière rangée.

La vérification tient en une ligne : regarde la dernière rangée de ton image de repos. Si elle est vide, ta créature flotte.

7. Comment dessiner

Une créature LiveGotchi est du pixel art, affiché agrandi et net, sans lissage. Ce qui marche :

• Des aplats. Pas de dégradé, pas de flou, pas d'anti-crénelage, pas d'ombre douce. Chaque pixel est une couleur pleine ou rien.
• Peu de couleurs. Quatre à huit par animation : une couleur de base, une ombre, une lumière, un contour, les yeux. Un contour sombre d'un pixel rend la silhouette lisible sur n'importe quel fond.
• Une silhouette claire. À 16, la créature occupe presque toute la grille ; à 32 et 64, laisse une marge d'un ou deux pixels et garde des formes simples. La lisibilité prime sur le détail.
• Les repères tenus. Les pieds sur la ligne de sol, le corps centré sur l'axe, le haut de la grille dégagé : voir les repères, c'est ce qui se rate le plus souvent.
• La cohérence. Toutes les images d'une animation gardent la même position, la même taille, la même palette. Entre deux étapes, la créature grandit ou change, mais on doit la reconnaître.
• Le mouvement par différence. Pour une marche, déplace les pattes et fais osciller le corps d'un pixel ; pour un repos, une respiration d'un pixel et un clignement suffisent.

Vérifie chaque rangée avant de répondre : le nombre de caractères est la cause d'erreur la plus fréquente. Compte-les. Une rangée de 15 ou de 17 caractères refuse tout le code.

8. Les pouvoirs

Les pouvoirs (champ effets) se déclarent à deux endroits, au choix :

• En tête de l'œuf : le pouvoir existe pour tout l'arbre. Un cœur dessiné une fois sert au bébé comme à l'adulte.
• Dans une étape, même champ et même forme : le pouvoir est acquis là. Il sert à cette étape et à tout ce qui en descend, jamais avant, jamais sur une branche sœur.

C'est une règle, pas un rangement. Une image qui déclenche un pouvoir que son étape n'a pas encore acquis fait refuser tout le code, en disant de quelle étape vient le pouvoir. Sers-t'en pour raconter la montée en puissance : une éclosion sobre, un adulte armé, deux branches sœurs qui divergent, la voie de la force gagne l'impact et celle du mana gagne l'aura.

Un pouvoir écrit en tête de l'œuf reste disponible partout : c'est le bon endroit pour ce que la lignée entière partage. Seize au plus par œuf, toutes étapes confondues. Ils se déclenchent par leur nom depuis une image. Chacun :

"effets": [
  { "nom": "Boule de feu", "comportement": "projectile", "reglages": { "vitesse": "rapide", "trajectoire": "droite", "degats": true },
    "images": { "palette": { "#": "#ff6b1a", "o": "#ffd166" }, "images": [ [ … 16 rangées … ], [ … ] ] } },
  { "nom": "Secousse", "comportement": "camera", "reglages": { "genre": "tremblement", "force": 2, "duree": 6 } }
]

Puis, dans l'animation sort de l'étape, l'image du lancer porte "effets": ["Boule de feu", "Secousse"].

Combien de pouvoirs, et où les acquérir

Jamais deux au même stade. Un pouvoir marque une étape ; deux d'un coup n'en marquent aucune. Étale-les, c'est ce qui fait sentir la montée en puissance.

Au moins un par feuille de branche, sur toute créature qui ramifie. Une voie se choisit pour ce qu'elle donne, pas seulement pour son allure. Une créature à deux fourches a trois feuilles : trois pouvoirs propres, en plus de ceux du tronc.

Des formes distinctes, pas des noms distincts. Deux pouvoirs d'une même créature ne partagent jamais leur silhouette ni leur couleur dominante : un orbe, un pépin, une étoile, une page. Et le nom dit le dessin — « Boule de feu » est une boule de feu, pas une aura verte.

Ce que ça coûte, et à qui. Les pouvoirs ne comptent pas dans les 160 animations d'un œuf : ils ont leur propre plafond, seize. Mais ils coûtent à la publication, comme toute image : 1 crédit par image en 16 et en 32, 4 crédits en 64. Six pouvoirs de cinq images en 64, c'est 120 crédits pour le créateur. Ce n'est pas une raison d'y renoncer, c'en est une de ne pas dessiner trente images pour un éclair.

9. La répartition

Le direct nourrit la créature. Chaque famille d'évènements donne des points, et la repartition dit quelle part, en pour cent, va à chaque état. Chaque ligne fait exactement 100, en entiers. Une famille absente donne un quart à chaque état. Le champ entier est facultatif.

"repartition": {
  "follow":     { "sante": 50, "force": 20, "precision": 10, "mana": 20 },
  "chat":       { "sante": 10, "force": 10, "precision": 40, "mana": 40 },
  "energies":   { "sante": 20, "force": 60, "precision": 10, "mana": 10 },
  "abonnement": { "sante": 40, "force": 10, "precision": 10, "mana": 40 },
  "raid":       { "sante": 10, "force": 50, "precision": 20, "mana": 20 }
}

Les familles : follow (followers), chat (messages), energies (bits, dons), abonnement (subs et subs offerts), raid.

Combien de familles régler. Laisser la répartition vide donne un quart à chaque état pour tout : la créature se nourrit alors de la même façon d'un message et d'un raid, ce qui n'apprend rien au streamer. Règle au moins deux familles dès le soigné, trois pour un chef-d'œuvre, et rends-les différentes l'une de l'autre — sinon autant tout laisser vide.

10. Les décors

Un décor se code comme un œuf, avec un genre, une seule étape, sans sous, sans condition, sans pouvoirs, sans répartition. Ses images ne déclenchent aucun pouvoir. Grille 16, 32 ou 64.

{
  "nom": "Dalles de pierre", "genre": "sol", "grille": 32,
  "etapes": [ { "nom": "Dalles", "animations": {
    "tuile-1": { "palette": { "#": "#6b6b7a", "-": "#4a4a58" }, "images": [ [ … 32 rangées … ] ] },
    "tuile-2": { "palette": { "#": "#6b6b7a", "-": "#4a4a58" }, "images": [ [ … ] ] }
  } } ]
}

11. Toutes les limites

12. Les erreurs les plus fréquentes

• Une rangée qui n'a pas exactement grille caractères, ou une image qui n'a pas exactement grille rangées.
• Un caractère utilisé dans une rangée mais absent de la palette de cette animation. Chaque animation a sa propre palette.
• Une couleur qui n'est pas écrite #rrggbb en six chiffres hexadécimaux.
• Une étape sans sous, ou dont le sous vise une étape déclarée plus bas, ou mal orthographiée.
• Deux étapes du même nom.
• Une animation oeuf hors de la première étape, ou une autre animation dans la première étape.
• Une condition sur l'œuf, ou un critère inconnu.
• Un champ que cette page ne cite pas, à n'importe quel niveau.
• Une réponse qui n'est pas uniquement le JSON.

13. Un œuf complet en exemple

Un œuf en 16 × 16, réduit à l'essentiel : l'œuf, une éclosion avec repos et marche, une évolution et son repli.

{
  "nom": "Créature d'exemple",
  "grille": 16,
  "affinite": "force",
  "etapes": [
    {
      "nom": "Œuf",
      "animations": {
        "oeuf": {
          "palette": { "#": "#c8742a", "o": "#f2b27a" },
          "images": [
            [ "................", "................", "......####......", ".....#oooo#.....", "....#oooooo#....", "....#oooooo#....", "...#oooooooo#...", "...#oooooooo#...", "...#oooooooo#...", "...#oooooooo#...", "....#oooooo#....", "....#oooooo#....", ".....#oooo#.....", "......####......", "................", "................" ]
          ]
        }
      }
    },
    {
      "nom": "Braisillon",
      "sous": "Œuf",
      "animations": {
        "repos": {
          "palette": { "#": "#1a1a1a", "r": "#e8532a", "o": "#ffb347", "w": "#ffffff" },
          "images": [
            [ "................", "................", "......####......", ".....#rrrr#.....", "....#rrrrrr#....", "....#rwrrwr#....", "....#r#rr#r#....", "....#rrrrrr#....", ".....#rrrr#.....", "....#rrrrrr#....", "...#rrrrrrrr#...", "...#rrrrrrrr#...", "....#rrrrrr#....", ".....#o##o#.....", "......#..#......", "................" ],
            [ "................", "................", "................", "......####......", ".....#rrrr#.....", "....#rrrrrr#....", "....#rwrrwr#....", "....#r#rr#r#....", "....#rrrrrr#....", ".....#rrrr#.....", "....#rrrrrr#....", "...#rrrrrrrr#...", "...#rrrrrrrr#...", "....#rrrrrr#....", ".....#o##o#.....", "......#..#......" ]
          ]
        },
        "marche": {
          "palette": { "#": "#1a1a1a", "r": "#e8532a", "o": "#ffb347", "w": "#ffffff" },
          "images": [
            [ "................", "................", "......####......", ".....#rrrr#.....", "....#rrrrrr#....", "....#rrrwrw#....", "....#rrr#r##....", "....#rrrrrr#....", ".....#rrrr#.....", "....#rrrrrr#....", "...#rrrrrrrr#...", "...#rrrrrrrr#...", "....#rrrrrr#....", ".....#o#.#o#....", "....#..#..#.....", "................" ],
            [ "................", "................", "......####......", ".....#rrrr#.....", "....#rrrrrr#....", "....#rrrwrw#....", "....#rrr#r##....", "....#rrrrrr#....", ".....#rrrr#.....", "....#rrrrrr#....", "...#rrrrrrrr#...", "...#rrrrrrrr#...", "....#rrrrrr#....", ".....#o##o#.....", "......#..#......", "................" ]
          ]
        }
      }
    },
    {
      "nom": "Braisier",
      "sous": "Braisillon",
      "condition": { "minHeures": 10, "minJauge": { "force": 60 } },
      "animations": { "repos": { "palette": { "#": "#1a1a1a", "r": "#e8532a" }, "images": [ [ … 16 rangées … ] ] },
                      "marche": { "palette": { "#": "#1a1a1a", "r": "#e8532a" }, "images": [ [ … ], [ … ] ] } }
    },
    {
      "nom": "Cendrier",
      "sous": "Braisillon",
      "animations": { "repos": { "palette": { "#": "#1a1a1a", "g": "#8a8a8a" }, "images": [ [ … ] ] },
                      "marche": { "palette": { "#": "#1a1a1a", "g": "#8a8a8a" }, "images": [ [ … ], [ … ] ] } }
    }
  ]
}

Dans une vraie réponse, chaque « … » est remplacé par les rangées complètes : un code avec des points de suspension n'est pas un code.

← Retour à l'atelier de création · Accueil