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.
Place-specific placeholders¶
Some features supply extra values while processing their own templates. These are separate from the 201 generally registered macros. Use them in the named feature.
Agents and Companions¶
An Agent run can supply the text it is currently processing under these equivalent names:
{{currentMessage}}
{{lastMessage}}
{{latestMessage}}
{{response}}
{{currentResponse}}
{{latestResponse}}
{{assistantMessage}}
For a reply rewrite or a Companion, this is commonly the reply being processed. Other stages can supply a larger context or an empty value. Here, lastMessage can replace the ordinary chat macro of the same name.
Other Agent values are:
| Placeholder | Meaning |
|---|---|
{{assistantName}} |
Name attached to the supplied message, when available |
{{agentName}} |
Name of the Agent running |
{{generationType}} |
Kind of request, such as normal, swipe or continue |
{{full-mewmory}} |
The combined NPC and memory context prepared for the writer, not the whole memory archive |
{{mewmory-facts}} |
Prepared character sheets, story records and source passages |
{{mewmory-interview}} |
Prepared interviews and subjective character views |
{{group-cards}} |
Every group member's description, personality and scenario, in group order, including muted members marked as muted |
{{active-lore}} |
Lore selected for the current reply or prepared for the Agent's run |
{{active-authors-note}} |
The active Author's Note text |
{{tracker-state}} |
Saved values from enabled trackers that extract their results into chat metadata, the chat's stored extra information |
{{continuity-notes}} |
The latest completed note from an enabled Continuity Companion, or empty when it is off |
{{continuity-corrections}} |
What an enabled Continuity Corrector changed in the reply being processed, or empty when it is off |
The Mewmory values are empty when it is off for the chat and don't start a fresh memory search. Group cards are empty outside a group. A character's interview opinions aren't automatically established story events.
For automatic reply processing, active lore follows the writer's selected lore. A manual Agent run handled by the server can select lore for the current chat and reuse that selection if the run resumes. Browser-run helpers use prepared lore for the current chat, which can be empty if none is available. Tracker state contains saved tracker values, not every Companion note.
These values belong to Agents and Companions. Neconyan 1.3.1 adds the three scene-context values and 1.3.3 adds the two continuity values; they don't change the generally registered macro catalogue's count.
Keep the Agent’s run timing in mind. A prompt prepared before a reply exists cannot read that future reply.
Slash-command scripts¶
A slash-command script can use:
pipe reads the previous command’s output. var reads a variable in that script’s scope, with an optional index. These are script values, separate from the ordinary chat and global stores. Script closures can also supply additional local macro names.
Image caption templates¶
The caption feature supplies this value while turning an image caption into a message. It is not a general way to caption an image from any prompt field.
Character Expressions¶
How expressions are picked → Image generation and cleanup supplies these values to the Quick Image Gen Prompt field:
{{generationInstructions}}
{{characterName}}
{{expression}}
{{expressions}}
{{characterCard}}
{{framingInstructions}}
{{sheetInstructions}}
{{backgroundInstructions}}
They are specific to expression generation, not generally registered macros, so the catalogue stays at 201. Substitution is case-insensitive and happens in one pass: text copied out of a character card is never expanded again. Required generation and sheet instructions are included even when your template omits them, and background instructions are appended unless the template places {{backgroundInstructions}} itself.
Custom macro arguments¶
A custom macro can use the argument names you define, along with positional names:
They exist while that custom template is being expanded. Another person needs the custom definition, its arguments and any referenced variables to reproduce the result.
Similar-looking syntax¶
Regex replacement fields can use capture references such as $1. Prompt templates can have their own fields, and extensions can add others. Those formats are not interchangeable with a globally registered macro. Use the reference beside the editor you are working in.