Skip to main content

Lore and Worldbuilding

Lis Novel provides contextually relevant lore entries for your prompts.

Lore context​

lore.context​

Returns the lore entries that are relevant to the current beat and scene.

lore.context -> PromptLoreList

Return value A PromptLoreList of relevant entries.
Empty state Returns null when no entries are relevant (falsy in prompts).
Format Newline-separated entry XML tags with no <lore> wrapper.

Example

Relevant lore:
{lore.context}

Sample output

<location name="Neon Vale" aliases="city">
  <description>Rain-slicked megacity of neon and smog.</description>
</location>
<character name="Sally Quinn" aliases="Sally" pronouns="She/Her">
  <description>Freelance code journalist and information broker.</description>
</character>

Example

{#if lore.context}
  Use the lore below exactly as given:
  {lore.context}
{#else}
  No lore was provided for this scene, so feel free to invent details that fit the tone.
{#endif}

lore.all​

Returns lore entry XML for the entire novel, or only manually linked entries when a target is provided. Hidden entries are excluded.

lore.all(target?) -> string

Arguments

  • target - optional scope for manual entries. Accepts a PromptScene, PromptChapter, or PromptAct.

Return value Unwrapped lore entry XML for the selected scope.
Format Newline-separated entry XML tags. Empty state Returns an empty string when no entries match.

Example

All lore:
{lore.all()}

Example

Manually linked lore for this scene:
{lore.all(scene)}

Lore inclusion rules​

These mirror the UI setting for each entry:

  • Visible (visible): Included when the matcher finds the entry name or alias in the current beat text or scene manuscript.
  • Always (always): Always included in AI lore context, even without matcher hits or manual links.
  • Manual (manual): Excluded from name/alias matching and auto-detection. Included only when manually attached or promoted as POV.
  • Hidden (hidden): Never sent to the AI, even when manually attached.
  • Manual links: Manually linked entries are included unless they are Hidden.
  • POV promotion: The active POV character entry is promoted into lore context unless it is Hidden.

Tips​

  • Use {lore.context} as the default way to supply worldbuilding context.
  • If you only need specific entries, use scene.references(...) to return just the manually linked lore entries for a scene.