Configurer les polices, tailles et textes par scène

Pokémon Studio permet d'ajouter des polices personnalisées, de définir des tailles de texte supplémentaires et de choisir la police utilisée par les messages et les choix. Ce guide explique où se règlent les polices, comment définir la police par défaut via son ID, et comment attribuer des polices précises à des scènes et aux choix.

Où se configurent les polices

Tout ce qui concerne les polices se trouve dans Tableau de bord > Textes, dans le groupe Paramètres généraux. Enregistrer cet écran écrit le fichier Data/configs/texts_config.json du projet, c'est lui que PSDK lit à l'exécution.

La page se divise en quatre zones :

• Polices : les polices disponibles dans le jeu, chacune adossée à un fichier .ttf.
• Tailles alternatives : des profils de taille réutilisables, sans avoir à ajouter un nouveau fichier de police.
• Messages : la mise en forme du texte dans les fenêtres de message, dont la police utilisée.
• Choix : les mêmes réglages pour les fenêtres de choix.

L'idée clé à garder en tête : dans le reste de la configuration, une police n'est jamais désignée par son nom mais par son ID. Chaque endroit qui choisit une police (la police par défaut, la police de message d'une scène, la police des choix) enregistre un ID de police, pas un nom de fichier. C'est ce qui rend le reste de l'écran, et l'astuce de la police par défaut ci-dessous, compréhensible.

La section Polices propose aussi un interrupteur Utiliser des caractères spéciaux pour les nombres. On le laisse activé si la police fournit ses propres glyphes pour les chiffres (la plupart des polices PSDK le font) ; il n'a aucun effet sur le choix de la police, seulement sur le rendu des nombres.

Ajouter une nouvelle police

Dans Studio, une police est constituée de deux éléments qui doivent concorder : un fichier .ttf sur le disque et une entrée dans le tableau Polices.

1. Copier le fichier .ttf dans le dossier Fonts/ du projet (par exemple Fonts/MaPolice.ttf).
2. Dans Tableau de bord > Textes, section Polices, cliquer sur Ajouter une police d'écriture.
3. Remplir les champs, puis cliquer sur Ajouter la police d'écriture :
   • ID : un numéro unique pour cette police. C'est par lui que le reste du jeu la désigne.
   • Nom : le nom du fichier sans l'extension .ttf. Il doit correspondre exactement au fichier, donc MaPolice pour Fonts/MaPolice.ttf.
   • Taille : la taille de rendu en pixels.
   • Hauteur de ligne : l'espace vertical occupé par une ligne, en pixels.

La nouvelle police apparaît dans le tableau sous forme de ligne. Dans texts_config.json, c'est une entrée de fonts.ttfFiles :

{
  "id": 30,
  "name": "MaPolice",
  "size": 16,
  "lineHeight": 20
}

Studio garde le tableau trié par ID et signale un ID déjà utilisé : deux polices ne peuvent donc pas partager un numéro. Si le Nom ne correspond à aucun fichier réel de Fonts/, la police ne se chargera pas en jeu, même si Studio accepte l'entrée.

Définir la police par défaut

PSDK utilise la police d'ID 0 comme police par défaut : partout où le jeu dessine du texte sans demander de police précise, il se rabat sur la police 0. Le projet de base livre PokemonDS à l'ID 0. Changer « la police du jeu » ne revient donc pas à modifier une seule liste déroulante, mais à faire de votre police celle qui porte l'ID 0.

C'est la manipulation cachée que l'écran n'explicite pas. On ne peut pas simplement attribuer l'ID 0 à sa police tant qu'une autre police occupe le 0, car Studio refuse les ID en double. Il faut échanger les deux ID, en se servant d'un numéro libre comme étape intermédiaire :

1. Donner un ID libre temporaire à la police 0 actuelle (par exemple faire passer PokemonDS de 0 à 99).
2. Attribuer l'ID 0 à votre police. Elle devient la police par défaut.
3. Optionnellement, donner un ID définitif à l'ancienne police en l'éditant de nouveau (par exemple déplacer PokemonDS de 99 à 30), pour qu'elle reste disponible pour les scènes qui en ont besoin.

Comme le tableau se retrie par ID après chaque modification, on suit les lignes par leur nom plutôt que par leur position pendant l'échange. Une fois votre police installée à l'ID 0, tout message, choix ou élément d'interface qui n'a pas demandé de police précise l'utilisera.

Créer des tailles supplémentaires

Une entrée de police porte déjà une Taille et une Hauteur de ligne. Lorsqu'on a besoin du même rendu à une taille différente, inutile d'ajouter un second .ttf. La section Tailles alternatives permet de définir des profils de taille autonomes, chacun identifié par son propre ID.

Dans la section Tailles alternatives, cliquer sur Ajouter une taille alternative, remplir ID, Taille et Hauteur de ligne (il n'y a pas de nom, puisqu'aucun fichier n'est en jeu), puis cliquer sur Ajouter la taille alternative.

{
  "id": 2,
  "size": 22,
  "lineHeight": 26
}

Ces profils ne portent pas de police propre. Ce sont des surcharges de taille que le moteur et les scripts appliquent à du texte existant quand un ID de taille précis est demandé. Comme pour les polices, les ID doivent être uniques et la liste reste triée.

Attribuer une police à une scène précise

La section Messages pilote les fenêtres de message. Elle est organisée par scène de référence, ce qui permet de donner à une scène un rendu différent du reste du jeu :

• Messages par défaut : utilisés partout sauf si une entrée plus précise correspond. C'est l'entrée dont la Scène de référence est laissée vide.
• Messages en combat : l'entrée intégrée pour la scène de combat.
• Cliquer sur Ajouter un type de messages pour cibler une autre scène. Renseigner sa Scène de référence avec le nom de classe de la scène (par exemple Battle::Scene). Le texte d'aide confirme la règle : laisser la scène de référence vide pour appliquer la configuration à toutes les scènes.

Dans chaque entrée, la liste déroulante Police du texte des messages est l'endroit où l'on choisit la police, présentée sous la forme ID - Nom. Les autres champs façonnent la même fenêtre : Couleur du texte des messages, Boîte de dialogue et Boîte des noms (les apparences de fenêtre), Nombre de lignes et Taille de la bordure.

Chaque entrée est un enregistrement sous messages dans le fichier de config, indexé par la scène de référence (any est l'entrée vide, fourre-tout) :

"messages": {
  "any": {
    "windowSkin": null,
    "nameWindowSkin": null,
    "lineCount": 2,
    "borderSpacing": 2,
    "defaultFont": 0,
    "defaultColor": 0,
    "colorMapping": {}
  },
  "Battle::Scene": {
    "windowSkin": null,
    "nameWindowSkin": null,
    "lineCount": 2,
    "borderSpacing": 2,
    "defaultFont": 0,
    "defaultColor": 0,
    "colorMapping": {}
  }
}

À noter : defaultFont enregistre l'ID de la police choisie, ce qui est toute la raison d'être des ID : une police propre à une scène n'est qu'un ID différent dans ce champ.

Attribuer une police aux choix

La section Choix reprend la section Messages pour les fenêtres de choix, avec moins de champs. Elle dispose de la même entrée Choix par défaut (scène de référence vide) et du même bouton Ajouter un type de choix pour cibler une scène précise.

On choisit la police avec la liste déroulante Police du texte par défaut, on règle la Couleur du texte par défaut, l'apparence Boîte des choix et la Taille de la bordure. Chaque entrée est un enregistrement sous choices, là encore indexé par scène de référence :

"choices": {
  "any": {
    "windowSkin": null,
    "borderSpacing": 2,
    "defaultFont": 0,
    "defaultColor": 0,
    "colorMapping": {}
  }
}

Conclusion

• Tous les réglages de police se trouvent dans Tableau de bord > Textes et sont enregistrés dans Data/configs/texts_config.json.
• Une police est un .ttf dans Fonts/ plus une entrée (ID, Nom, Taille, Hauteur de ligne) ; tout le reste désigne une police par son ID, jamais par son nom.
• La police par défaut est celle d'ID 0 : pour la changer, on fait passer sa police à l'ID 0 en utilisant un ID libre comme étape intermédiaire, car Studio interdit les ID en double.
• Les Tailles alternatives ajoutent des profils de taille réutilisables par ID, sans nouveau fichier de police.
• Les Messages et les Choix sont organisés par scène de référence : une scène de référence vide est le cas par défaut, un nom de classe comme Battle::Scene cible une scène, et la police se choisit par entrée via son ID.