Lorebooks
Les Lorebooks vous permettent de créer des entrées de lore déclenchées par mots-clés qui s'injectent dans les conversations des PNJ uniquement lorsqu'elles sont pertinentes. Au lieu de surcharger l'histoire d'un PNJ avec tous les détails, vous rédigez des entrées autonomes sur des lieux, factions, l'histoire, les coutumes ou les secrets — et le système les fait apparaître au bon moment.
Chaque utilisateur bénéficie d'entrées illimitées. Le nombre qui peut s'activer dans une seule conversation dépend de votre plan.
Créer une entrée
Ouvrez l'Atlas et allez dans l'onglet Lorebook. Cliquez sur + Nouvelle entrée pour ouvrir l'éditeur.
Chaque entrée possède les champs suivants :
| Champ | Description |
|---|---|
| Titre | Un libellé court pour l'entrée (max 100 caractères). Visible par l'IA. |
| Mots-clés | Mots déclencheurs séparés par des virgules (jusqu'à 25, chacun max 50 caractères). L'entrée s'active quand un mot-clé apparaît en conversation. |
| Contenu | Le texte de lore injecté dans la conversation (max 1 500 caractères). Le contenu dépassant la limite est surligné en rouge pour que vous puissiez le raccourcir. |
| Portée | Contrôle où l'entrée peut s'activer. Par défaut : « Partout ». |
| Priorité | Un nombre (par défaut 100). Les nombres plus bas = priorité plus haute quand plus d'entrées correspondent que le budget ne le permet. |
| Activée | Activez ou désactivez l'entrée sans la supprimer. |
| Toujours active | Quand cochée, l'entrée s'active dans chaque conversation (dans sa portée) indépendamment des mots-clés. |
Fonctionnement de l'activation
Quand vous parlez à un PNJ, le système vérifie votre lorebook en deux passes :
- Les entrées Toujours actives se remplissent d'abord — elles s'activent dans chaque conversation dans leur portée.
- Les correspondances de mots-clés suivent — si l'un des mots-clés de l'entrée apparaît dans la conversation, l'entrée s'active (insensible à la casse, correspondance de mot entier).
Les entrées peuvent aussi s'activer sémantiquement — même sans correspondance exacte de mot-clé, le système peut faire apparaître des entrées thématiquement pertinentes à la conversation. Si le joueur mentionne « l'ancienne guerre », une entrée avec des mots-clés comme « le Déchirement » ou « siège » pourrait tout de même s'activer.
Le nombre total d'entrées pouvant s'activer par conversation est plafonné par le budget de votre plan.
Budget
| Plan | Emplacements par conversation |
|---|---|
| Adventurer | 5 |
| Hero | 10 |
La barre de budget en haut de l'onglet Lorebook montre combien d'entrées Toujours actives vous utilisez par rapport à vos emplacements totaux. Les emplacements restants sont disponibles pour les déclencheurs par mots-clés et sémantiques.
Bonne pratique : Limitez les entrées Toujours actives à 1-2 par monde. Si trop d'entrées sont Toujours actives, il ne reste plus de place pour que les déclencheurs par mots-clés se déclenchent. La barre de budget vous avertit quand les entrées Toujours actives encombrent l'activation dynamique.
Portées
Par défaut, les entrées ont une portée « Partout » — elles peuvent s'activer dans n'importe quelle conversation du monde. Vous pouvez restreindre cela en ajoutant des portées.
Cliquez sur + Ajouter une portée pour ouvrir une liste consultable des entités de votre monde. Types de portée :
- Région — s'active uniquement en parlant aux PNJ de cette région
- Colonie — s'active uniquement au sein d'une colonie spécifique
- District — s'active uniquement au sein d'un district spécifique
- Bâtiment — s'active uniquement en parlant aux PNJ de ce bâtiment
- PNJ — s'active uniquement dans les conversations avec ce PNJ spécifique
Vous pouvez ajouter une portée par type. Les portées multiples sont combinées avec un ET logique — une entrée avec une portée de région et de bâtiment ne s'active que lorsque le PNJ se trouve dans ce bâtiment de cette région.
Supprimer toutes les portées réinitialise l'entrée à « Partout ».
Mots-clés secondaires
Pour un contrôle plus fin, développez la section Mots-clés secondaires dans l'éditeur d'entrée. Les mots-clés secondaires ajoutent une deuxième condition en plus de la correspondance du mot-clé principal.
Cochez Exiger des clés secondaires pour activer, puis choisissez un mode logique :
| Logique | Signification |
|---|---|
| ET UN | Le mot-clé principal correspond ET au moins un mot-clé secondaire est présent |
| ET TOUS | Le mot-clé principal correspond ET tous les mots-clés secondaires sont présents |
| NON UN | Le mot-clé principal correspond ET aucun des mots-clés secondaires n'est présent |
| NON TOUS | Le mot-clé principal correspond ET pas tous les mots-clés secondaires ne sont présents |
Exemple : Une entrée sur un scandale de dîme pourrait avoir les mots-clés principaux « taxes, argent, église » avec les mots-clés secondaires « Embla, le registre » en NON UN — l'entrée se déclenche quand le joueur discute de taxes, mais pas s'il a déjà mentionné Embla ou le registre.
Import et export
Importation
Cliquez sur Importer pour télécharger un fichier .json. RPBuddy accepte les lorebooks au format SillyTavern / Character Card V2 character_book — compatible avec SillyTavern, Chub, Risu, Agnai, Kobold et toute plateforme utilisant la spécification Character Card V2.
Les entrées importées sont soumises à un contrôle de sécurité. Les entrées signalées apparaissent dans une section jaune « à vérifier » où vous pouvez modifier le contenu et ré-enregistrer.
Exportation
Cliquez sur Exporter pour télécharger votre lorebook sous forme de fichier .json au format character_book SillyTavern. Les données spécifiques à RPBuddy (portées) sont préservées dans un champ d'extensions, de sorte que la ré-importation dans RPBuddy restaure vos paramètres de portée.
Gérer les entrées
La vue en liste affiche toutes les entrées avec leur titre, mots-clés (les trois premiers affichés), badge Toujours active, tags de portée et aperçu du contenu.
- Activer/désactiver les entrées avec la case à cocher sur chaque ligne
- Supprimer des entrées individuelles ou utilisez Tout effacer pour tout supprimer (exportez d'abord si vous voulez une sauvegarde)
- Modifier n'importe quelle entrée en cliquant dessus
Conseils
- Commencez petit. Quelques entrées bien ciblées sont plus efficaces que des dizaines d'entrées larges. La qualité plutôt que la quantité.
- Utilisez les portées généreusement. Une entrée sur l'histoire d'un bâtiment devrait être limitée à ce bâtiment — il n'y a aucune raison pour qu'elle s'active dans des conversations à l'autre bout de la ville.
- Gardez le contenu sous 1 500 caractères. Tout ce qui dépasse la limite est surligné en rouge et n'atteindra pas l'IA. Si une entrée nécessite plus de détails, divisez-la en plusieurs entrées avec des déclencheurs de mots-clés différents.
- Réservez Toujours active pour l'essentiel. Les règles du monde, les directives de ton ou le lore critique qui doit toujours être présent. Tout le reste devrait se déclencher par mots-clés.
- Ne sur-réfléchissez pas les mots-clés. Vous n'avez pas besoin d'anticiper chaque mot qu'un joueur pourrait utiliser — le système peut détecter des sujets liés même sans correspondance exacte.