Public Help
Merkmale

Lorebooks

Umfassende Anleitung zum Erstellen, Importieren, Verwalten und Verknüpfen von Lorebooks mit KI-Charakteren auf Public.

Lehrbücher (oft auch als Weltinfo bezeichnet) sind eigenständige Sammlungen von Überlieferungen, Schauplätzen, Fraktionsdetails, magischen Systemen und Referenzwissen, auf die Sie verlinken können KI-Charaktere. Wenn Sie mit einem Charakter chatten, werden relevante Einträge aus dem verknüpften Lorebook dynamisch abgerufen und direkt in die Eingabeaufforderung des Modells eingefügt.

Im Gegensatz zur Kernpersönlichkeit eines Charakters ist ein Lorebook vollständig modular aufgebaut: Sie können dasselbe Lorebook mit mehreren Charakteren verknüpfen (z. B. indem Sie ein gemeinsames Starfall Academy Lorebook mit Mira, Tobin, Professor Vale und Lord Ashgrave verknüpfen) oder Lorebooks austauschen, ohne die Stimme des Charakters zu verändern.

Kernkonzepte

Um das Beste aus Lorebooks herauszuholen, ist es hilfreich zu verstehen, wie sie zu den anderen Rollenspiel-Tools auf Public passen:

  • Charakterpersönlichkeit – definiert, wer der Charakter ist: sein Sprechstil, seine Hintergrundgeschichte, seine Macken und Verhaltensrichtlinien.
  • Chat-Personas – definiert, wer Sie sind: Ihr Name, Ihr Aussehen und Ihre Identität im Gespräch. Siehe Chat-Personas.
  • Lehrbücher – definiert die Welt um dich herum: historische Ereignisse, Fraktionen, Orte, Zaubersprüche, Technologieregeln und Beziehungsgeschichten.

Private vs. öffentliche Lorebooks

SichtbarkeitWer kann es mit einem Charakter verknüpfen?Wer kann es bearbeiten oder löschen?
PrivatNur duNur du (der Schöpfer)
PublicJeder Ersteller auf Public kann es beim Erstellen oder Bearbeiten seiner Charaktere verknüpfenNur du (der Schöpfer)

Nur der Besitzer kann ein Lorebook bearbeiten oder löschen. Wenn Sie ein Lorebook löschen, verlieren alle damit verknüpften Charaktere die Verknüpfung sicher, ohne dass ihre Konversationsverläufe oder Persönlichkeiten verloren gehen.


So funktioniert die Kontextinjektion

Wenn Sie in einem Charakter-Chat eine Nachricht senden, führt das Backend eine schnelle Kontext-Assembly-Pipeline aus, bevor es die Antwort der KI generiert:

1. Gescannte Textziele

Die Kontext-Engine sucht im gesamten aktiven Konversationskontext nach übereinstimmenden Einträgen: – Die letzte eingehende Nachricht des Benutzers

  • Chat-Verlauf der letzten Gespräche
  • Fortlaufende Gesprächszusammenfassung
  • Angeheftete und automatisch extrahierte Charakterspeicher – Die ursprüngliche Begrüßung des Charakters

2. Eintragsübereinstimmungstypen

Jeder Eintrag in einem Lorebook hat eines von zwei Auslöseverhalten:

  • Keyword-ausgelöst (constant: false) – Der Eintrag definiert eine Liste von Schlüsselwörtern (z. B. ["emberwing", "house of the phoenix"]). Wenn irgendwo im gescannten Konversationstext ein Schlüsselwort vorkommt (Teilzeichenfolgenübereinstimmung ohne Berücksichtigung der Groß-/Kleinschreibung), wird der Eintrag ausgelöst.
  • Konstant (constant: true) – Der Eintrag ist immer enthalten in jedem einzelnen Nachrichtenaustausch, wobei Schlüsselwörter vollständig ignoriert werden. Ideal für globale Szenario-Basislinien (z. B. „Das Jahr ist 1204, und der Schleier verbirgt die Starfall Academy vor der Außenwelt“).

3. Prioritäten- und Budgetverwaltung

Modelle verfügen über endliche Eingabeaufforderungskontextfenster. Um schnelle, kohärente und kostengünstige Antworten zu gewährleisten, erzwingt Public ein Injektionsbudget:

  • Zeichenbudgetlimit: Bis zu 1.800 Zeichen (LOREBOOK_INJECT_MAX_CHARS) von Lorebook-Inhalten können pro Nachricht eingefügt werden.
  • Prioritätsreihenfolge: Alle übereinstimmenden Einträge (sowohl konstant als auch durch Schlüsselwörter ausgelöst) werden nach Priorität in absteigender Reihenfolge sortiert (100 vor 50, vorher 0).
  • Budgetanpassung: Einträge werden nacheinander hinzugefügt, beginnend mit der höchsten Priorität, bis das Budget von 1.800 Zeichen erreicht ist. Übersteigt ein Eintrag das verbleibende Budget, wird er weggelassen (bzw. eingepasst, wenn es sich um den ersten Eintrag handelt).

4. Injektionsblockformat

Ausgelöste Einträge werden in einen sauberen Block formatiert und an die Systemeingabeaufforderung des Charakters übergeben:

Relevant world info:
- Universal setting: Magie wird nur an der Starfall Academy gelehrt, und die Außenwelt hält sie für einen Mythos.
- Emberwing House schätzt Mut und Loyalität. Gegründet von Aria Emberwing; die Farben sind Kupfer und Schwarz.
- Duellzauber: Flare blendet einen Gegner; Binding Thread verlangsamt ihn; Mirror Ward reflektiert kleine Flüche.

Feldspezifikationen und -grenzen

Lorebook-Metadaten

FeldTypErforderlichGrenzen und Beschreibung
nameZeichenfolgeErforderlichMaximal 120 Zeichen. Name der Welt oder Umgebung.
descriptionZeichenfolgeOptionalMaximal 500 Zeichen. Kurze Zusammenfassung der Einstellung.
visibilityZeichenfolgeOptional"private" (Standard) oder "public". Public Lorebooks erscheinen in der Suche und Entdeckung.
tagsArrayOptionalBis zu 20 Tags. Tags werden gekürzt und in Kleinbuchstaben geschrieben.
entriesArrayOptionalBis zu 100 Einträge pro Lorebook.

Eintragsmetadaten

FeldTypErforderlichGrenzen und Beschreibung
contentZeichenfolgeErforderlichMaximal 1.000 Zeichen. Der tatsächliche Weltinformationstext, der in das Modell eingefügt wird.
constantBoolescher WertOptionalStandard false. Wenn true, dieser Eintrag ist bei jedem Nachrichtenaustausch immer aktiv.
keysArrayErforderlich, wenn nicht konstantBis zu 20 Schlüssel, jeweils maximal 64 Zeichen. Lösen Sie Wörter oder Phrasen aus. Ignoriert, wenn constant: true.
enabledBoolescher WertOptionalStandard true. Schalten Sie die Option aus, um einen Eintrag vorübergehend zu deaktivieren, ohne ihn zu löschen.
priorityNummerOptionalStandard 0. Höhere Zahlen werden zuerst eingefügt, wenn der Kontextraum eingeschränkt ist (z. B. 100, 85, 50).

Unterstützte JSON-Formate

Sie können Lorebooks in drei standardisierten Formaten importieren, einfügen und exportieren:

1. Natives Public Lorebook-Schema (empfohlen)

Dies ist das native JSON-Schema von Public. Es unterstützt alle Felder direkt:

{
  "name": "Starfall Academy",
  "description": "Comprehensive lorebook covering Starfall Academy's houses, spells, lore, and magical laws.",
  "visibility": "public",
  "tags": [
    "fantasy",
    "starfall",
    "academy",
    "magic",
    "spells"
  ],
  "entries": [
    {
      "keys": [],
      "content": "Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth. Magic is channeled through focus crystals.",
      "enabled": true,
      "constant": true,
      "priority": 100
    },
    {
      "keys": [
        "emberwing",
        "aria emberwing",
        "house of the phoenix"
      ],
      "content": "Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black. Its common room is at the top of the Ember Tower.",
      "enabled": true,
      "constant": false,
      "priority": 85
    },
    {
      "keys": [
        "focus crystal",
        "crystal lore",
        "crystal vault"
      ],
      "content": "Every student bonds with one focus crystal. Crystals are grown from rare minerals and hold a single element such as flame, tide, or storm. A bond breaks only by choice.",
      "enabled": true,
      "constant": false,
      "priority": 80
    },
    {
      "keys": [
        "flare",
        "binding thread",
        "mirror ward"
      ],
      "content": "Dueling spells: Flare (blinds an opponent), Binding Thread (slows them), and Mirror Ward (creates a shield that reflects minor curses).",
      "enabled": true,
      "constant": false,
      "priority": 75
    }
  ]
}

2. Export von SillyTavern World-Infos

Der Importer erkennt automatisch die eigenständigen Exporte von SillyTavern entries ist als Objektverzeichnis verschlüsselt:

{
  "name": "Starfall World Info",
  "description": "SillyTavern export",
  "entries": {
    "0": {
      "uid": 0,
      "key": ["the veil", "magic"],
      "content": "The Veil hides Starfall Academy from the outside world.",
      "constant": true,
      "disable": false,
      "order": 100
    },
    "1": {
      "uid": 1,
      "key": ["starfall academy", "castle"],
      "content": "Starfall Academy stands on a floating island above the Silver Sea.",
      "constant": false,
      "disable": false,
      "order": 50
    }
  }
}

3. SillyTavern-Charakterkarte (character_book)

Sie können auch Charakterkarten (V2- oder V3-Spezifikationskarten) importieren, die a bündeln character_book Objekt:

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "Mira Vale",
    "tags": ["fantasy", "magic"],
    "character_book": {
      "name": "Starfall Library Lore",
      "description": "Magical theory and reference entries",
      "entries": [
        {
          "keys": ["silverkey", "unlocking charm"],
          "content": "The Silverkey charm unlocks standard doors and windows.",
          "enabled": true,
          "constant": false,
          "insertion_order": 10
        }
      ]
    }
  }
}

Erstelle und verwalte Lorebooks

Im Internet

Navigieren Sie zu /lorebooks in Ihrem Browser oder wählen Sie Lorebooks aus dem Seitenleistenmenü.

Von Grund auf neu erstellen

  1. Gehen Sie zu /lorebooks/create.
  2. Geben Sie Ihrem Lorebook einen beschreibenden Namen und optional eine Beschreibung / Tags.
  3. Wählen Sie die Sichtbarkeit Privat oder Public.
  4. Klicken Sie auf Eintrag hinzufügen, um Regeln zu erstellen. Geben Sie Trigger-Schlüsselwörter an oder aktivieren Sie Immer aktiv (konstant).
  5. Klicken Sie zum Speichern auf Lehrebuch erstellen.

Vorhandene Lorebooks importieren

Sie haben zwei Möglichkeiten, vorhandene Weltinformationen schnell zu laden:

  1. Datei importieren – Klicken Sie in der oberen Aktionsleiste auf Datei importieren, um eine Datei hochzuladen .json Laden Sie ein Lorebook oder eine Charakterkartendatei von Ihrem Computer herunter.
  2. JSON einfügen – Klicken Sie auf JSON einfügen, um den Parsing-Dialog zu öffnen:
  • Klicken Sie auf Aus Zwischenablage einfügen, um aus einer anderen App kopierten JSON-Text abzurufen.
  • Klicken Sie auf Beispiel laden, um eine vorab ausgefüllte Starfall Academy-Vorlage zu prüfen.
  • Klicken Sie auf Parsen und Importieren, um das Formular sofort auszufüllen.

Exportieren und Kopieren

  • Klicken Sie auf jedem Bildschirm zum Erstellen, Bearbeiten oder Detail eines Lorebooks auf JSON kopieren.
  • Das gesamte Lorebook wird in standardisiertes Public JSON serialisiert und direkt in Ihre Zwischenablage kopiert.

Verlinkung zu einem KI-Charakter

Sobald Ihr Lorebook erstellt ist:

  1. Öffnen /characters/add (Oder klicken Sie bei einem von Ihnen erstellten Charakter auf Bearbeiten).
  2. Scrollen Sie zur Lorebook (optional)-Auswahl.
  3. Wählen Sie Ihr Lorebook aus oder wählen Sie eines der beliebten öffentlichen Lorebooks aus, die von der Community erstellt wurden.
  4. Speichern Sie Ihren Charakter. Alle nachfolgenden Chats mit diesem Charakter greifen automatisch auf das Lorebook zurück.

Planlimits und Freischaltung

PlanenLorebooks, die Sie erstellen könnenEinträge pro Lorebook
Kostenlos3Bis zu 100
Grundlegend10Bis zu 100
Ersteller / ProfiUnbegrenztBis zu 100

Für die Erstellung eines Lorebooks ist die Freischaltung von Character Lorebooks erforderlich (in der gleichen Fortschrittsstufe wie benutzerdefinierte Chat-Personas). Siehe Abonnements und Gamifizierung.


Best Practices für YouTuber

  • Verwenden Sie beschreibende, spezifische Schlüsselwörter: Verwenden Sie Namen und zusammengesetzte Phrasen wie ["aria emberwing", "house of the phoenix"] statt gebräuchlicher kurzer Wörter wie ["the", "is", "he"].
  • Konstante Einträge für universelle Regeln reservieren: Behalten constant: true Einträge sind auf 1–2 Grundregeln beschränkt (z. B. aktuelle Zeitleiste, Kernweltphysik), damit sie nicht das gesamte Budget von 1.800 Zeichen verbrauchen.
  • Halten Sie den Eintragsinhalt prägnant: Aussagekräftige Einträge mit 1–3 klaren Sätzen ermöglichen, dass mehrere relevante Einträge gleichzeitig in das Kontextfenster passen.
  • Prioritätswerte nutzen: Grundwissen höhere Prioritätswerte geben (100–80) und kleinere dekorative Fakten niedrigere Werte (40–10), sodass der kritischste Kontext garantiert zuerst eingefügt wird.

Häufig gestellte Fragen

Warum wurde mein Lorebook-Eintrag im Chat nicht ausgelöst?

Überprüfen Sie Folgendes:

  1. Ist der Eintrag auf Aktiviert gesetzt?
  2. Ist eines der genauen Schlüsselwörter im letzten Chat oder in der letzten Benutzeraufforderung aufgetaucht? (Bei Übereinstimmungen handelt es sich um Teilzeichenfolgen-Übereinstimmungen, bei denen die Groß-/Kleinschreibung nicht beachtet wird.)
  3. Haben Einträge mit höherer Priorität zuerst das Budget von 1.800 Zeichen gefüllt? Versuchen Sie, die Prioritätsbewertung des Eintrags zu erhöhen.

Kann ich mehr als ein Lorebook mit einem einzelnen Charakter verknüpfen?

Derzeit kann jeder Charakter jeweils mit einem Lorebook verknüpft werden. Wenn Sie Inhalte aus mehreren Lorebooks benötigen, kombinieren Sie deren Einträge mit den Tools JSON einfügen oder Exportieren in einem einzigen Lorebook.

Was passiert, wenn ich ein Lorebook lösche?

Bei Charakteren, die dieses Lorebook verlinkt haben, wird einfach die Lorebook-Referenz gelöscht. Ihre Gespräche, Einstellungen und Erinnerungen bleiben völlig erhalten.

Kann ich ein öffentliches Lorebook bearbeiten, das von jemand anderem erstellt wurde?

Nein. Nur der ursprüngliche Ersteller kann ein Lorebook bearbeiten. Wenn Sie ein öffentliches Lorebook anpassen möchten, sehen Sie sich das Lorebook an, klicken Sie auf JSON kopieren, erstellen Sie ein neues Lorebook und fügen Sie den JSON in Ihre eigene private Kopie ein.

Ist eine mobile Lorebook-Verwaltung verfügbar?

Die vollständige Erstellung und Bearbeitung von Lorebooks ist derzeit in der Web-App verfügbar. Alle Lorebooks, die mit Charakteren im Web verknüpft sind, funktionieren automatisch im Chat auf allen Plattformen, einschließlich Android und iOS.


Verwandte Dokumentation

  • KI-Charaktere – Erstellen Sie benutzerdefinierte Charaktere und verknüpfen Sie Lorebooks
  • Chat-Personas – Definieren Sie im Rollenspiel, wer Sie sind
  • Abonnements – Planen Sie Kontingente und Freischaltungen von Funktionen
  • Web-Übersicht — Webnavigation und Funktionen

Auf dieser Seite