Lorebooks
Lorebooks permitem criar entradas de lore acionadas por palavras-chave que são injetadas nas conversas dos NPCs apenas quando relevantes. Em vez de abarrotar a história de fundo de um NPC com cada detalhe, você escreve entradas independentes sobre lugares, facções, história, costumes ou segredos — e o sistema as apresenta no momento certo.
Cada usuário tem entradas ilimitadas. O número que pode ser ativado em uma única conversa depende do seu plano.
Criando uma Entrada
Abra o Atlas e vá para a aba Lorebook. Clique em + Nova Entrada para abrir o editor.
Cada entrada tem os seguintes campos:
| Campo | Descrição |
|---|---|
| Título | Um rótulo curto para a entrada (máx 100 caracteres). Visível para a IA. |
| Palavras-chave | Palavras de ativação separadas por vírgula (até 25, cada uma com máx 50 caracteres). A entrada é ativada quando qualquer palavra-chave aparece na conversa. |
| Conteúdo | O texto de lore injetado na conversa (máx 1.500 caracteres). Conteúdo que ultrapasse o limite é destacado em vermelho para você encurtar. |
| Escopo | Controla onde a entrada pode ser ativada. O padrão é "Em todo lugar". |
| Prioridade | Um número (padrão 100). Números menores = prioridade maior quando mais entradas correspondem do que o orçamento permite. |
| Habilitado | Ative ou desative a entrada sem excluí-la. |
| Sempre Ativo | Quando marcado, a entrada é ativada em toda conversa (dentro do seu escopo) independente de palavras-chave. |
Como a Ativação Funciona
Quando você fala com um NPC, o sistema verifica seu lorebook em duas passagens:
- Entradas Sempre Ativas preenchem primeiro — são ativadas em toda conversa dentro do seu escopo.
- Correspondências de palavras-chave preenchem em seguida — se qualquer palavra-chave da entrada aparecer na conversa, a entrada é ativada (sem distinção entre maiúsculas e minúsculas, correspondência de palavra inteira).
As entradas também podem ser ativadas semanticamente — mesmo sem uma correspondência exata de palavra-chave, o sistema pode apresentar entradas que são tematicamente relevantes para a conversa. Se o jogador mencionar "a velha guerra", uma entrada com palavras-chave como "a Ruptura" ou "cerco" ainda pode ser ativada.
O número total de entradas que podem ser ativadas por conversa é limitado pelo orçamento do seu plano.
Orçamento
| Plano | Slots por conversa |
|---|---|
| Adventurer | 5 |
| Hero | 10 |
A barra de orçamento no topo da aba Lorebook mostra quantas entradas Sempre Ativas você está usando versus seus slots totais. Os slots restantes ficam disponíveis para ativação por palavras-chave e semântica.
Boa prática: Mantenha entradas Sempre Ativas em 1–2 por mundo. Se muitas entradas estiverem definidas como Sempre Ativas, não sobra espaço para ativação por palavras-chave. A barra de orçamento avisa quando entradas Sempre Ativas estão tomando o espaço da ativação dinâmica.
Escopos
Por padrão, entradas têm escopo "Em todo lugar" — podem ser ativadas em qualquer conversa no mundo. Você pode restringir isso adicionando escopos.
Clique em + Adicionar Escopo para abrir uma lista pesquisável das entidades do seu mundo. Tipos de escopo:
- Região — só ativa ao conversar com NPCs naquela região
- Assentamento — só ativa dentro de um assentamento específico
- Distrito — só ativa dentro de um distrito específico
- Construção — só ativa ao conversar com NPCs naquela construção
- NPC — só ativa em conversas com aquele NPC específico
Você pode adicionar um escopo por tipo. Múltiplos escopos funcionam com AND — uma entrada com escopo em uma região e uma construção só ativa quando o NPC está naquela construção naquela região.
Remover todos os escopos redefine a entrada para "Em todo lugar".
Palavras-chave Secundárias
Para controle mais preciso, expanda a seção Palavras-chave Secundárias no editor de entrada. Palavras-chave secundárias adicionam uma segunda condição sobre a correspondência de palavra-chave primária.
Marque Exigir chaves secundárias para habilitar, depois escolha um modo de lógica:
| Lógica | Significado |
|---|---|
| AND ANY | Palavra-chave primária corresponde E pelo menos uma palavra-chave secundária está presente |
| AND ALL | Palavra-chave primária corresponde E todas as palavras-chave secundárias estão presentes |
| NOT ANY | Palavra-chave primária corresponde E nenhuma das palavras-chave secundárias está presente |
| NOT ALL | Palavra-chave primária corresponde E nem todas as palavras-chave secundárias estão presentes |
Exemplo: Uma entrada sobre um escândalo de dízimo poderia ter palavras-chave primárias "impostos, dinheiro, igreja" com palavras-chave secundárias "Embla, o livro-razão" definidas como NOT ANY — a entrada dispara quando o jogador discute impostos, mas não se já mencionou Embla ou o livro-razão.
Importar e Exportar
Importando
Clique em Importar para carregar um arquivo .json. RPBuddy aceita lorebooks no formato SillyTavern / Character Card V2 character_book — compatível com SillyTavern, Chub, Risu, Agnai, Kobold e qualquer plataforma que use a especificação Character Card V2.
Entradas importadas passam por triagem de segurança. Entradas sinalizadas aparecem em uma seção amarela "precisa de revisão" onde você pode editar o conteúdo e salvar novamente.
Exportando
Clique em Exportar para baixar seu lorebook como um arquivo .json no formato character_book do SillyTavern. Dados específicos do RPBuddy (escopos) são preservados em um campo de extensões, então reimportar no RPBuddy restaura suas configurações de escopo.
Gerenciando Entradas
A visualização em lista mostra todas as entradas com título, palavras-chave (as três primeiras são exibidas), badge de Sempre Ativo, tags de escopo e prévia do conteúdo.
- Habilitar/desabilitar entradas com a caixa de seleção em cada linha
- Excluir entradas individuais ou usar Limpar Tudo para remover tudo (exporte primeiro se quiser um backup)
- Editar qualquer entrada clicando nela
Dicas
- Comece pequeno. Algumas entradas bem delimitadas são mais eficazes que dezenas de amplas. Qualidade acima de quantidade.
- Use escopos generosamente. Uma entrada sobre a história de uma construção deve ter escopo para aquela construção — não há razão para ela ser ativada em conversas do outro lado da cidade.
- Mantenha o conteúdo abaixo de 1.500 caracteres. Qualquer coisa além do limite é destacada em vermelho e não chegará à IA. Se uma entrada precisa de mais detalhes, divida-a em múltiplas entradas com diferentes palavras-chave.
- Reserve Sempre Ativo para essenciais. Regras do mundo, diretrizes de tom, ou lore crítica que deve estar sempre presente. Todo o resto deve ser acionado por palavras-chave.
- Não pense demais nas palavras-chave. Você não precisa antecipar cada palavra que um jogador pode usar — o sistema pode captar tópicos relacionados mesmo sem uma correspondência exata.