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.

Miso

Taro

Nori

Spacing and choices¶

These core macros handle spacing, comments, conditions and random choices.

For a choice that should stay fixed, use pick or the saved-choice macros. A fresh random or roll can change whenever the prompt is processed, including a preview or a repeated preparation step.

//¶

Adds a comment for you to read while editing. The comment disappears when the prompt is prepared.

{{// Keep this note out of the prompt}}

Result: No text.

Arguments and other names

comment: Your editing note. For several lines, use the block form shown in the examples.
More values: add each extra item after ::. See the example for its format.
Other accepted names: comment.

More examples:

{{//}}A longer comment
can span lines.{{///}}

banned¶

Adds a word to the banned-word setting for supported Text Completion connections and produces no text.

{{banned::suddenly}}

This depends on the selected provider supporting banned words. It does not enforce a universal ban on every model.

Arguments and other names

word: Word to ban for Text Completion backend.

else¶

Starts the alternative inside an if block. Use it only between the opening and closing if tags.

{{if::false}}Day{{else}}Night{{/if}}

Result: Night.

if¶

Chooses which text to include. Empty text, false, off and 0 count as false. Only the chosen branch runs its nested macros.

{{if::{{hasvar::location}}}}Location: {{getvar::location}}{{else}}Choose a location.{{/if}}

Use the comparison macros when checking numbers. A plain condition such as 0 > 0 is non-empty text and can count as true. See conditions.

Arguments and other names

condition: The value to check. A macro name or variable shorthand can supply it. Put ! before the condition to reverse it.
content: The block to include when the condition is true. Use {{else}} for the alternative.

input¶

Reads the text currently in the chat composer. It can be empty after sending or in a request without a browser composer.

{{input}}

newline¶

Inserts one or more newlines. One newline by default, more if the count argument is specified.

{{newline}}

Arguments and other names

count: Optional. Number of newlines to insert. Default: 1.

More examples:

{{newline::2}}

noop¶

Produces no text. Useful when a template needs an intentionally empty macro.

{{noop}}

outlet¶

Inserts the lore text collected for a named custom outlet. An outlet is a location in your prompt where matching lore entries are placed.

{{outlet::scene-details}}

Arguments and other names

key: Outlet key.

pick¶

Chooses an item using the chat, source text and macro position. These inputs determine the result.

{{pick::rainy::clear::misty}}

Editing or moving the macro can change the result. The /reroll-pick command resets the saved choice seed.

Arguments and other names

More values: add each extra item after ::. See the example for its format.

random¶

Chooses one item each time the text is evaluated. It can change several times while preparing one reply.

{{random::rainy::clear::misty}}

Arguments and other names

More values: add each extra item after ::. See the example for its format.

reverse¶

Reverses the characters of the argument provided.

{{reverse::I am Lana}}

Arguments and other names

value: The string to reverse.

roll¶

Rolls dice and returns the total. In 3d6+4, roll three six-sided dice and add 4. A plain number means one die with that many sides.

{{roll::1d20}}

Arguments and other names

formula: The dice to roll, such as 1d20 or 3d6+4.

More examples:

{{roll::6}}
{{roll::3d6+4}}

space¶

Returns one or more spaces. One space by default, more if the count argument is specified.

{{space}}

Arguments and other names

count: Optional. Number of spaces to insert. Default: 1.

More examples:

{{space::4}}

trim¶

Used alone, removes newlines immediately around the macro. Used as a block, returns its content with surrounding whitespace removed.

{{trim}}  Hello  {{/trim}}

Result: Hello.

Arguments and other names

content: Optional. Content to trim (when used as scoped macro)