Guide des lorebooks SillyTavern : une voie plus simple

Un lorebook dans SillyTavern est un fichier au format JSON contenant des entrées : chaque entrée possède un ensemble de mots-clés, un niveau de profondeur/priorité et un bloc de texte décrivant un personnage, un lieu, un objet ou un événement. Lorsqu'un mot-clé apparaît dans votre historique de chat ou dans votre dernier message, SillyTavern injecte l'entrée correspondante dans la fenêtre de contexte de l'IA (généralement vers la fin du prompt, via le mode d'insertion « post-history »). Les entrées peuvent aussi être définies comme « constant » pour qu'elles se chargent toujours. Le système prend en charge jusqu'à 1000 entrées par lorebook, même si la limite pratique dépend de la taille de votre contexte (par exemple, 4096 tokens pour la plupart des API gratuites). Chaque entrée dispose d'un champ « secondary key » pour les déclencheurs à plusieurs mots, et d'un curseur « probability » (0-100 %) qui contrôle si l'entrée se déclenche à chaque fois ou seulement parfois—utile pour les rencontres aléatoires. Vous pouvez aussi attribuer un « role » (system, user, assistant ou character) pour que l'entrée soit formatée comme un dialogue. Les lorebooks sont enregistrés sous forme de fichiers .json dans le dossier /data/default-user/lorebooks/. Le principal avantage est que les lorebooks déchargent la mémoire de votre carte de personnage principale, ce qui permet à l'IA de rester concentrée sur la scène en cours sans oublier les faits déjà établis.

Ouvrez SillyTavern, allez dans l'onglet « Lorebook » (l'icône de livre dans la barre latérale gauche). Cliquez sur « Import » pour charger un fichier .json existant ou partez de zéro avec « Add Entry ». Une entrée vide comporte ces champs : Primary Keywords (séparés par des virgules, par exemple « tavern, inn, bar »), Secondary Keys (déclencheurs alternatifs, par exemple « The Drunken Dragon »), Content (le texte injecté lorsqu'elle est déclenchée—gardez-le sous 300 tokens pour plus d'efficacité), Depth (entier de 0 à 50 ; plus la profondeur est élevée, plus l'entrée est placée près de l'attention de l'IA—utilisez 10 pour les faits de base, 30 pour les points d'intrigue critiques), Probability (100 % = se déclenche toujours, 50 % = une fois sur deux), Role (« system » pour la narration, « character » pour un dialogue en personnage), Group (pour organiser plusieurs entrées sous un onglet) et Is Constant (cochez cette case pour toujours charger l'entrée, en ignorant les mots-clés). Pour une taverne, définissez les mots-clés sur « tavern, inn, barkeep », le contenu sur « The Rusty Nail Tavern has oak tables, a roaring fireplace, and a mute barkeep named Gregor who communicates via chalkboard. » Depth 10, probability 100 %, role system. Enregistrez. Testez en tapant « I enter the tavern »—l'IA devrait maintenant mentionner Gregor.

Au-delà de la simple correspondance de mots-clés, les lorebooks de SillyTavern prennent en charge les déclencheurs regex via le champ « Secondary Keys » en activant l'option « Regex » pour chaque entrée. Utilisez des motifs comme \bsword\b|\bblade\b pour correspondre aux deux mots. Les curseurs de probabilité vous permettent de créer une lore imprévisible : réglez une entrée « hidden door » à 20 % pour que l'IA ne la mentionne qu'occasionnellement, ce qui force l'exploration. Les balises de rôle (system, user, assistant, character) contrôlent le formatage de l'entrée. Les entrées avec le rôle « character » sont injectées comme si la compagne les avait dites—utile pour les histoires personnelles des PNJ. Les entrées avec le rôle « system » restent des faits narratifs neutres. Vous pouvez aussi utiliser le champ « Group » pour organiser les entrées en groupes repliables (par exemple « NPCs », « Locations », « Quests ») afin de faciliter les modifications ultérieures. Une astuce puissante : créez une entrée avec des mots-clés comme « * » (joker) et réglez la probabilité à 1 %—cela injecte un détail d'ambiance aléatoire (par exemple « the air smells of rain ») dans chaque scène. La profondeur compte plus que vous ne le pensez : les entrées dont la profondeur dépasse 30 sont placées après le prompt principal mais avant le dernier message de l'utilisateur, ce qui les rend plus influentes. Expérimentez avec une profondeur de 1 à 5 pour les faits de monde passifs qui ne doivent pas supplanter la scène active.

SillyTavern vous permet d'associer des lorebooks à des personnages individuels ou de les activer globalement. Les lorebooks spécifiques à un personnage sont idéaux pour les compagnes dotées d'histoires ou d'objets uniques (par exemple, le grimoire d'un sorcier qui ne se déclenche que lorsque vous discutez avec ce sorcier). Pour l'attribuer, ouvrez la fiche du personnage, allez dans l'onglet « Advanced » et sélectionnez un lorebook dans le menu déroulant. Les lorebooks de monde se chargent pour n'importe quel personnage et conviennent mieux aux lieux persistants (une taverne qui apparaît dans plusieurs aventures) ou aux règles universelles (systèmes de magie, géographie). La règle de base : si le lore concerne un seul personnage, rendez-le spécifique à ce personnage ; s'il concerne le cadre, utilisez un lorebook de monde. Vous pouvez aussi empiler jusqu'à 5 lorebooks par personnage (via l'onglet « Lorebooks » de l'éditeur de personnage). Des entrées qui se chevauchent entre plusieurs lorebooks peuvent créer des conflits : l'IA risque de se perdre si deux entrées définissent le même lieu différemment. Pour éviter cela, adoptez une convention de nommage hiérarchique : « World_Tavern » contre « Character_Wizard_Spellbook ». Côté performance, les lorebooks de monde analysent tous les mots-clés à chaque message ; gardez donc le total des entrées sous 300 pour l'ensemble des lorebooks actifs afin d'éviter les ralentissements avec de grandes fenêtres de contexte.

Le problème le plus fréquent, ce sont des entrées qui ne se déclenchent pas. D'abord, vérifiez que les mots-clés apparaissent bien dans le chat : la casse est ignorée, mais la correspondance doit être exacte (pas de correspondance partielle, sauf si les regex sont activées). Ensuite, vérifiez que la probabilité de l'entrée n'est pas réglée sur 0 %. Troisièmement, assurez-vous que le lorebook est activé (interrupteur dans l'onglet Lorebook). Quatrièmement, confirmez que la profondeur de l'entrée n'est pas trop faible (par exemple une profondeur de 0), au point d'être tronquée par la taille du contexte : SillyTavern donne la priorité aux entrées de plus grande profondeur lorsque la fenêtre de contexte est pleine. Autre piège : surcharger le contexte. Si vous avez 50 entrées en profondeur 50, elles se disputeront toutes l'espace de tokens limité. Utilisez la profondeur avec parcimonie (profondeur 1 à 10 pour la plupart des entrées). Si l'IA ignore le lore, ouvrez le « Prompt Item Manager » (l'icône en forme de cube) pour voir exactement ce qui est injecté. Cherchez votre entrée dans la section « Lorebooks ». Si elle est absente, c'est que le mot-clé n'a pas correspondu ou que l'entrée était trop profonde et a été coupée. À noter aussi : les entrées longues (plus de 200 tokens) sont souvent tronquées ; gardez chaque entrée sous 150 tokens. Enfin, évitez les mots-clés en double d'une entrée à l'autre : la première entrée correspondante (par profondeur, puis par ordre) l'emporte.

Les lorebooks ne sont pas de simples encyclopédies statiques : ils peuvent faire avancer des récits évolutifs. Créez une entrée « Plot Hook » avec des mots-clés comme « quête, tâche, mission » et un contenu qui génère un nouvel objectif à chaque fois (par exemple : « Vous entendez des rumeurs sur une mine perdue dans les montagnes. »). Associez-lui une probabilité de 50 % pour que chaque mention ne donne pas systématiquement lieu à une quête. Pour les événements sensibles au temps, utilisez une entrée « Constant » avec une date (par exemple : « Le festival des moissons commence dans 3 jours ») et mettez-la à jour manuellement au fil des jours en jeu. Vous pouvez aussi enchaîner les lorebooks : une entrée déclenchée peut contenir un mot-clé qui en déclenche une autre (par exemple, l'entrée de la taverne déclenche « Gregor »). Cela demande une conception soignée des mots-clés. De nombreux utilisateurs avancés stockent les inventaires de personnages sous forme de lorebooks : chaque objet est une entrée (mots-clés : « potion, potion de soin ») avec un contenu qui le décrit. Quand le joueur dit « utilise potion », l'entrée se déclenche et rappelle à l'IA les effets de l'objet. Pour des mondes vraiment dynamiques, envisagez d'utiliser [SillyTavern's Extras](https://github.com/SillyTavern/SillyTavern-Extras) avec l'intégration des lorebooks, même si cela demande une configuration supplémentaire. Le plafond est élevé : certains utilisateurs font tourner des lorebooks de plus de 500 entrées pour de vastes campagnes de JDR.