Skip to content

The Neconyan handbook

Your guides Miso, Taro & Nori

Choose each guide's gender to change their artwork and pronouns. Your choices stay in this browser, separately from the app.

Lorebook macros

These Macro Enhanced macros read lorebooks. An entry can be found by its title, stored as its memo or comment, or by its numeric identifier. Supplying the book name helps when several books contain the same title.

Without a book name, the usual search order is the chat’s book, the character’s books, then global books. Loading happens in the background, so a first lookup can be empty while the book is being loaded.

Browser prompts only. These macros only run in the browser. Ordinary Roleplay replies build their prompts there, so they work. Conversation replies, Deep Swipe and replies with a selected Notebook context build their prompts on the server and stop before the model request if one is used. Test them in the Macro Enhanced Playground, and see Macro Enhanced in Roleplay prompts for the full list. Ordinary lorebook activation works everywhere.

Reading lore is different from activating it

lore inserts entry content directly. Ordinary lorebook activation selects entries using keywords, conditions and the available budget. A direct macro lookup can duplicate an entry already included elsewhere.

loreactive and the active counts describe the last generation. They do not predict what will activate on the next reply. An entry’s existence alone does not mean it was included.

lore

Inserts the content of a lorebook entry. Macros inside the entry are expanded too.

{{lore::Backstory}}
Arguments and other names
  • entry: The entry title (its memo/comment) or uid.
  • book: Optional. A specific lorebook name. Without it, the chat, character and global books are searched in that order.
  • Other accepted names: wi, me-lore.

More examples:

{{lore::Kingdom::My World}}

loreactive

Lists the titles of the lorebook entries that triggered during the last generation.

{{loreactive}}
Arguments and other names
  • separator: Optional. Placed between the entry titles. Default: ,.
  • Other accepted names: me-loreactive.

lorebooks

Lists the lorebooks bound to this chat (chat book, character books, global books).

{{lorebooks}}
Arguments and other names
  • separator: Optional. Placed between the book names. Default: ,.
  • Other accepted names: me-lorebooks.

lorecount

Counts lorebook entries.

{{lorecount}}
Arguments and other names
  • scope: Optional. 'active' (triggered last generation), 'bound' (enabled entries in the books bound to this chat) or 'all'. Default: active.
  • Other accepted names: me-lorecount.

More examples:

{{lorecount::bound}}

loreentries

Lists the titles of the enabled entries in a lorebook (or in every book bound to this chat).

{{loreentries}}
Arguments and other names
  • book: Optional. A specific lorebook name. Without it, all books bound to this chat. Default: empty text.
  • separator: Optional. Placed between the entry titles. Default: ,.
  • Other accepted names: me-loreentries.

More examples:

{{loreentries::My World}}

loreexists

Returns true if the entry exists in the searched books. Existence does not mean the entry was activated for the current prompt.

{{loreexists::Backstory}}
Arguments and other names
  • entry: The entry title (its memo/comment) or uid.
  • book: Optional. A specific lorebook name.
  • Other accepted names: me-loreexists.

lorefield

Reads one field of a lorebook entry (its keywords, position, depth, probability, ...).

{{lorefield::Backstory::keys}}
Arguments and other names
  • entry: The entry title (its memo/comment) or uid.
  • field: One of: title, keys, secondarykeys, content, position, depth, order, probability, constant, enabled, uid.
  • book: Optional. A specific lorebook name.
  • Other accepted names: me-lorefield.

More examples:

{{lorefield::Backstory::probability}}

lorekeys

Lists the trigger keywords of a lorebook entry, comma separated.

{{lorekeys::Backstory}}
Arguments and other names
  • entry: The entry title (its memo/comment) or uid.
  • book: Optional. A specific lorebook name.
  • Other accepted names: me-lorekeys.

lorepick

Inserts one enabled entry from the selected books. The chat, key and available entries determine the choice.

{{lorepick::Story Seeds}}
Arguments and other names
  • book: Optional. A specific lorebook name. Without it, all books bound to this chat. Default: empty text.
  • key: Optional. A label that keeps different picks independent. Default: empty text.
  • Other accepted names: me-lorepick.

More examples:

{{lorepick::Story Seeds::second-seed}}

loretokens

Estimates the tokens in lore content using about four characters per token. Use the actual model token count when checking a strict limit.

{{loretokens}}
Arguments and other names
  • scope: Optional. 'active' (triggered last generation) or 'bound' (all enabled entries in this chat's books). Default: active.
  • Other accepted names: me-loretokens.

More examples:

{{loretokens::bound}}