Macros (CBS)

Macros are double-brace tokens that expand at request time. They work in character fields, lorebook entries, presets, greetings and chat text, and they nest.

{{char}} smiles at {{user}}.
{{random::sunny::rainy::foggy}}
{{calc::1+2*3}}

Arguments are separated with double colons. Unknown macros expand to nothing instead of erroring, so a typo never breaks a request.

Single braces are not macros. One pair reaches the model as literal text and shows up in replies, the usual cause of stray braces. Matches SillyTavern, RisuAI and JanitorAI, so their cards work unchanged.

{{user}}   expands to your persona name
{user}     stays literal text

random picks one argument fresh each expansion. pick makes a choice that stays stable for the conversation. roll throws dice with d-notation.

{{random::a::b::c}}   {{pick::a::b::c}}   {{roll::d20}}

Rolls and randoms are seeded per turn: a regenerate reuses the same values, so swiping does not reroll dice.

Chat variables persist per conversation branch. Global variables persist across all chats. Set them in any macro-capable text or from trigger scripts.

{{setvar::mood::happy}}
{{getvar::mood}}
{{setglobalvar::visits::1}}

Branch-scoped storage means swiping to another branch restores that branch's variable state. Siblings never leak values into each other.

Blocks wrap content. if renders its body when the condition is truthy. each loops over arrays with slot substitution. when adds line-based else branches.

{{#if {{equal::{{getvar::mood}}::happy}}}}
{{char}} is in a great mood.
{{/if}}

{{#each {{array::red::green::blue}} item}}
Color: {{slot::item}}
{{/each}}

pure and escape protect literal braces from expansion. Any closing tag closes the innermost open block.

Comment macros vanish before the model sees them, so they work for notes inside card fields. Use pure blocks to show macro syntax literally.

{{// note to self, never sent to the model}}
{{#pure}}{{char}} stays literal here{{/pure}}