# Curly Braced Syntaxes

Curly braced syntaxes (like {{user}}) are used to insert special values into the text. The syntaxes can be used in almost any text field in the client, including chat messages, character descriptions, and lorebook entries.

The syntaxes are replaced with the actual values when the message is sent or when the text is displayed in the client. The syntaxes can be nested and combined with other syntaxes, for example, {{calc::{{getvar::a}}+{{getvar::b}}}}.

The syntaxes are case-insensitive, so {{user}}, {{User}}, and {{USER}} are all the same. Some of the syntaxes require parameters, which are separated by :: (two colons).

Some of the syntaxes require arrays as parameters. use {{array::A::B::C...}} syntax to create an array. Some of the syntaxes are block syntaxes (like {{#if A}}), which are started with {{#NAME A}} and ended with {{/NAME}}. The block syntaxes can be nested, and starts with #. it can also be closed with {{/}} instead of {{/NAME}}. block syntaxes's content's indentation and whitespace would be trimmed, unless for some syntaxes like {{#if-pure A}} which would keep the indentation and whitespace.

# Data Syntaxes

# `{{user}}`

This will be replaced with the personas's name.

# `{{char}}`

This will be replaced with the character's name. If you are chatting in a group chat, if the speaker is user, this will be replaced with group chat name. if the speaker is character, this will be replaced with the speaker's name.

# `{{description}}`

Alias: {{char_desc}}

This will be replaced with the character's description.

# `{{example_dialogue}}`

Alias: {{example_message}}

This will be replaced with an array of example dialogue of the character.

# `{{persona}}`

Alias: {{user_persona}}

This will be replaced with the persona's description.

# `{{lorebook}}`

Alias: {{world_info}}

This will be replaced with array of lorebook entries.

# `{{history}}`

Alias: {{messages}}

This will be replaced with array of messages in current chat.

# `{{chat_index}}`

This will be replaced with the index of the message in the chat. The chat index starts from 0 except for the first message. The first message has an index of -1. If the {{chat_index}} is used in non-chat context, it will be replaced with -1.

# `{{model}}`

This will be replaced with the current model id of the client.

# `{{axmodel}}`

This will be replaced with the current auxiliary model id of the client.

# `{{role}}`

This will be replaced with the current role of the message sender. If the {{role}} is used in non-chat context, it will be replaced with role string.

# `{{maxprompt}}`

This will be replaced with the maxinum tokens setting of the client.

# `{{lastmessage}}`

This will be replaced with the last message in the chat log.

# `{{lastmessageid}}`

Alias: {{lastmessageindex}}

This will be replaced with the index of the last message in the chat log.

# `{{previous_char_chat}}`

Alias: {{lastcharmessage}}

This will be replaced with the last message of the current character in the chat log.

# `{{previous_user_chat}}`

Alias: {{lastusermessage}}

This will be replaced with the last message of the user in the chat log.

# `{{previous_chat_log::A}}`

This will be replaced with the chat message with the index of A in the chat log. If the message does not exist, it will be replaced with Out of range

# `{{first_msg_index}}`

This will be replaced with the index of the first message in the chat log.

# `{{screen_width}}`

This will be replaced with the width of the screen in pixels.

# `{{screen_height}}`

This will be replaced with the height of the screen in pixels.

# `{{user_history}}`

This will be replaced with the array of messages of the user in the chat log.

# `{{char_history}}`

This will be replaced with the array of messages of the character in the chat log.

# Time Syntaxes

# `{{time}}`

This will be replaced with the current time, in the format HH:MM:SS in client's timezone.

# `{{time::A}}`

Alias: {{datetimeformat:A}}, {{date::A}}

This will be replaced with the current time, in format of A in client's timezone.

The format A can include the following:

YYYY for the year.
YY for the year in two digits.
MM for the month.
DD for the day.
DDDD for the day count of the year.
HH for the hour, in 24-hour format.
hh for the hour, in 12-hour format.
mm for the minute.
ss for the second.
A for the AM/PM indicator.
X for the unix timestamp.
x for the unix timestamp in milliseconds.

for example, {{time::YYYY-MM-DD HH:mm:ss}} will be replaced with the current time in the format 2024-12-31 23:59:59 if the current time is 2024-12-31 23:59:59.

# `{{time::A::B}}`

Alias: {{datetimeformat::A::B}}, {{date::A::B}}

Same as {{time::A}}, but the time would be in the unix timestamp B instead of the current time.

# `{{date}}`

This will be replaced with the current date, in the format YYYY-MM-DD in client's timezone.

# `{{isotime}}`

This will be replaced with the current time, in the format HH:MM:SS in the UTC timezone.

# `{{isodate}}`

This will be replaced with the current date, in the format YYYY-MM-DD in the UTC timezone.

# `{{message_time}}`

This will be replaced with the time when the message was sent. The returned time format would determined by the browser or OS settings.

If the {{message_time}} is used in non-chat context or the first message, it will be replaced [Cannot get time] string. If the message was sent before {{message_time}} syntax was introduced, it will be replaced with [Cannot get time, message was sent in older version] string.

# `{{message_date}}`

This will be replaced with the date when the message was sent. The returned date format would determined by the browser or OS settings.

If the {{message_date}} is used in non-chat context or the first message, it will be replaced [Cannot get time] string. If the message was sent before {{message_date}} syntax was introduced, it will be replaced with [Cannot get time, message was sent in older version] string.

# `{{message_idle_duration}}`

This will be replaced with the time when the user's previous message was sent subtracted by the time when the user's second previous message was sent. The returned time format would be HH:MM:SS format.

If the {{message_idle_duration}} is used in non-chat context or the first message, it will be replaced [Cannot get time] string. If the message was sent before {{message_idle_duration}} syntax was introduced, it will be replaced with [Cannot get time, message was sent in older version] string. If there are no previous messages, it will be replaced with [No user message found] string.

# `{{idle_duration}}`

This will be replaced with the time when the user's previous message was sent subtracted by the current time. The returned time format would be HH:MM:SS format.

# `{{message_unixtime_array}}`

This will be replaced with the array of unix timestamps of the chat log.

# Emotion/Asset Syntaxes

# `{{asset::A}}`

This will be replaced with the element with the source of the additional asset path data named A of the current character. type of the element would be determined by the asset type automatically.

# `{{emotion::A}}`

This will be replaced with the image element with the source of the emotion image path data named A of the current character.

# `{{audio::A}}`

This will be replaced with the audio element with the source of the additional asset path data named A of the current character.

# `{{bg::A}}`

This will be replaced with the background image element with the source of the additional asset path data named A of the current character.

# `{{video::A}}`

This will be replaced with the video element with the source of the additional asset path data named A of the current character.

# `{{video-img::A}}`

This will be replaced with the video element with the source of the additional asset path data named A of the current character. unlike {{video::A}}, the element would be displayed like an image element.

# `{{raw::A}}`

This will be replaced with additional asset path data named A of the current character.

# `{{img::A}}`

This will be replaced with the image element with the source of the additional asset path data named A of the current character.

# `{{assetlist}}`

This will be replaced with the array of names of additional assets of the current character.

# `{{emotionlist}}`

This will be replaced with the array of names of emotion images of the current character.

# Math/Condition Syntaxes

# `{{? A}}`

Alias: {{calc::A}}

This will be replaced with the result of the calculation of the provided expression A. for example, {{? 5+3}} will be replaced with 8. You can nest other syntaxes in the expression.

These are the supported operators and functions:

A+B for addition of A and B.
A-B for subtraction of B from A.
A*B for multiplication of A and B.
A/B for division of A by B.
A%B for remainder of the division of A by B.
A^B for A raised to the power of B.
A||B for A or B.
A&&B for A and B.
!A for not A.
A==B for A is equal to B.
A!=B for A is not equal to B.
A>B for A is greater than B.
A>=B for A is greater than or equal to B.
A<B for A is less than B.
A<=B for A is less than or equal to B.
$<name> for getting the value of the chat variable named <name>. <name> should be named with only alphanumeric characters and underscore.

Some of the syntaxes has aliases:

| for ||
& for &&
= for ==
≤ for <=
≥ for >=

The boolean values are represented as 1 for true and 0 for false. Note that {{? A}} syntax is only for numeric and boolean values. for string values, use other syntaxes like {{equal::A::B}}.

# `{{equal::A::B}}`

This will be replaced with 1 if A is equal to B, otherwise it will be replaced with 0. unlike {{? A}}, this syntax works for any type of values.

# `{{not_equal::A::B}}`

Alias: {{notequal::A::B}}

This will be replaced with 1 if A is not equal to B, otherwise it will be replaced with 0. unlike {{? A}}, this syntax works for any type of values.

# `{{floor::A}}`

This will be replaced with the largest integer less than or equal to A.

# `{{ceil::A}}`

This will be replaced with the smallest integer greater than or equal to A.

# `{{abs::A}}`

This will be replaced with the absolute value of A.

# `{{startswith::A::B}}`

This will be replaced with 1 if A starts with B, otherwise it will be replaced with 0.

# `{{endswith::A::B}}`

This will be replaced with 1 if A ends with B, otherwise it will be replaced with 0.

# `{{contains::A::B}}`

This will be replaced with 1 if A contains B, otherwise it will be replaced with 0.

# `{{prefill_supported}}`

This will be replaced with 1 if the model supports prefilling, otherwise it will be replaced with 0.

# `{{lower::A}}`

This will be replaced with A converted to lowercase.

# `{{upper::A}}`

This will be replaced with A converted to uppercase.

# `{{capitalize::A}}`

This will be replaced with A with the first letter capitalized.

# `{{round::A}}`

This will be replaced with A rounded to the nearest integer.

# `{{trim::A}}`

This will be replaced with A with leading and trailing whitespaces removed.

# `{{jbtoggled}}`

This will be replaced with the current state of the jailbreak toggle. If jailbreak is enabled, it will be replaced with 1, otherwise it will be replaced with 0.

# Variable Syntaxes

# `{{getvar::A}}`

This will be replaced with the value of the chat variable A. If the chat variable A is not defined, it will be replaced with null.

# `{{setvar::A::B}}`

This will set the chat variable A to B and be replaced with an empty string. {{setvar::A::B}} only works when it is in the chat context and it is not the first message.

If its possible, it is recommended to use trigger script instead of this syntax.

# `{{addvar::A::B}}`

This will increment the chat variable A by B and be replaced with an empty string. for example, if variable A is 5 and {{addvar::A::3}} is used, the variable A will be 8. {{addvar::A::B}} only works when it is in the chat context and it is not the first message.

# `{{getglobalvar::A}}`

This will be replaced with the value of the global variable A. If the global variable A is not defined, it will be replaced with null.

# Array Syntaxes

# `{{array::A::B::C...}}`

This will be replaced with an array of B, C, and so on. This can be used to create an array from multiple parameters.

Currently array uses § as separator, but this might change in the future. so it is recommended to use this syntax instead of using § directly.

# `{{array_length::A}}`

Alias: {{arraylength::A}}

This will be replaced with the length of array A. this would not work with strings.

# `{{array_element::A::B}}`

This will be replaced with the element of array A at index B. index starts from 0. if the index is out of range, it will be replaced with null. if index is negative, it will be counted from the end of the array.

# `{{array_push::A::B}}`

This will be replaced with array A with element B pushed to the end.

# `{{array_pop::A}}`

This will be replaced with array A with the last element removed.

# `{{array_shift::A}}`

This will be replaced with array A with the first element removed.

# `{{array_splice::A::B::C::D...}}`

This will be replaced with array A with C, D, and so on inserted at index B.

# `{{split::A::B}}`

This will be replaced with an array of strings that are separated by B in A.

# `{{join::A::B}}`

This will be replaced with a string that is created by joining the elements of array A with B.

# Utility Syntaxes

# `{{slot}}`

If it is used in prompt template, pipeline or translator prompt, it will be replaced to original slot content. otherwise, it will not be replaced.

# `{{slot::A}}`

If it is used in {{#each C D}} block, and if D is same as A, it will be replaced to the current element of the array. otherwise, it will not be replaced.

# `{{position::A}}`

If it is used in prompt template, it will be replaced to the lorebooks that uses position pt_<A> like pt_personality. if the corresponding lorebook does not exist, it will be replaced with an empty string. otherwise, it will not be replaced.

# `{{random::A::B...}}`

Alias: {{random:A,B...}}

This will be replaced with a random value from the provided parameters. for example, {{random::A::B::C}} will be replaced with either A, B, or C. If no parameters are provided, it will be replaced with random number between 0 and 1.

# `{{pick::A::B...}}`

Alias: {{pick:A,B...}}

This would work same as {{random::A::B...}}, except the seed would be the same for the same message which would make the result consistent. This also doesn't work with no parameters.

# `{{roll::A}}`

Alias: {{roll:A}}

This will be replaced with a random number between 1 and A. if A starts with d, it will be replaced with a random number between 1 and A without the d.

# `{{rollp::A}}`

Alias: {{rollp:A}}

This would work same as {{roll::A}}, except the seed would be the same for the same message which would make the result consistent.

# `{{spread::A}}`

This will be replaced with a a string created by joining the elements of array A with :: (two colons). This can be used to make multi-parameter syntaxes from arrays. For example, {{random::{{spread::{{array::chicken::pizza::hamburger}}}}}} will act same as {{random::chicken::pizza::hamburger}}.

# `{{replace::A::B::C}}`

This will be replaced with A with all occurrences of B replaced with C.

# `{{range::A}}`

This will be replaced with an array of numbers from 0 to A - 1.

# `{{length::A}}`

This will be replaced with the length of A. this would not work with arrays.

# `{{none}}`

Alias: {{blank}}

This will be replaced with an empty string. Useful for removing the default text.

If its used in first message, the first message will work as if it not exists.

# `{{br}}`

Alias: {{newline}}

This will be replaced with a line break.

# `{{tonumber::A}}`

This would trim all non-numeric characters except for .. This doesn't guarantee that the result is a valid number.

# Block Syntaxes

# `{{#if A}}`

This will be replaced with the content if A is 1, otherwise it will be replaced with an empty string.

Example:

{{#if {{equal::1::1}}}}
Hello Alice!
{{/if}}

# `{{#if-pure A}}`

Same as {{#if A}}, but it would keep the indentation and whitespace of the content.

# `{{#each A B}}`

This will be replaced with the content for each element of the array A. The current element of the array will be replaced with B.

Example:

{{#each {{array::chicken::pizza::hamburger}} item}}
{{slot::item}}
{{/each}}

will be replaced with

chickenpizzahamburger

# Unrecommended Syntaxes

Unrecommended syntaxes are deprecated. They are still functional, but they might not work as expected, and might be removed in the future updates.

Please use the recommended syntaxes instead.

# `<user>`

Works the same as {{user}}. Deprecated due to inconsistency in naming, and syntax conflict. Use {{user}} instead.

Dude to syntax conflict, this syntax might not work as expected.

# `<bot>`

Alias: <char>

Works the same as {{char}}. Deprecated due to inconsistency in naming, and syntax conflict. Use {{char}} instead.

Dude to syntax conflict, this syntax might not work as expected.

# `{{main_prompt}}`

Alias: {{system_prompt}}

This will be replaced with the main prompt of the prompt setting. Deprecated due to incompiatibility with the prompt template system.

# `{{global_note}}`

Alias: {{ujb}}, {{system_note}}

This will be replaced with the global_note of the prompt setting. Deprecated due to incompiatibility with the prompt template system.

# `{{personality}}`

Alias: {{char_persona}}

This will be replaced with the character's personality description. Deprecated due to deprecation of personality description.

# `{{scenario}}`

This will be replaced with the character's scenario description. Deprecated due to deprecation of scenario description.

# `{#if A B #}`

This will be replaced with the content if A is equal to B, otherwise it will be replaced with an empty string. Deprecated due to introduction of blocked {{#if A}} syntax.

Use {{#if A}} {{/if}} block syntax instead.

# `{{remaind::A::B}}`

This will be replaced with the remainder of the division of A by B.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A%B}} or {{? A%B}} instead.

# `{{greater::A::B}}`

This will be replaced with 1 if A is greater than B, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A>B}} or {{? A>B}} instead.

# `{{greater_equal::A::B}}`

Alias: {{greaterequal::A::B}}

This will be replaced with 1 if A is greater than or equal to B, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A>=B}} or {{? A>=B}} instead.

# `{{less::A::B}}`

This will be replaced with 1 if A is less than B, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A<B}} or {{? A<B}} instead.

# `{{less_equal::A::B}}`

Alias: {{lessequal::A::B}}

This will be replaced with 1 if A is less than or equal to B, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A<=B}} or {{? A<=B}} instead.

# `{{and::A::B}}`

This will be replaced with 1 if A and B are both 1, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A&&B}} or {{? A&&B}} instead.

# `{{or::A::B}}`

This will be replaced with 1 if A or B is 1, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A||B}} or {{? A||B}} instead.

# `{{pow::A::B}}`

This will be replaced with A raised to the power of B.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::A^B}} or {{? A^B}} instead.

# `{{not::A}}`

This will be replaced with 1 if A is 0, otherwise it will be replaced with 0.

Deprecated due to upgrade of {{? A}} syntax. use {{calc::!A}} or {{? !A}} instead.

# Curly Braced Syntaxes

# Data Syntaxes

# {{user}}

# {{char}}

# {{description}}

# {{example_dialogue}}

# {{persona}}

# {{lorebook}}

# {{history}}

# {{chat_index}}

# {{model}}

# {{axmodel}}

# {{role}}

# {{maxprompt}}

# {{lastmessage}}

# {{lastmessageid}}

# {{previous_char_chat}}

# {{previous_user_chat}}

# {{previous_chat_log::A}}

# {{first_msg_index}}

# {{screen_width}}

# {{screen_height}}

# {{user_history}}

# {{char_history}}

# Time Syntaxes

# {{time}}

# {{time::A}}

# {{time::A::B}}

# {{date}}

# {{isotime}}

# {{isodate}}

# {{message_time}}

# {{message_date}}

# {{message_idle_duration}}

# {{idle_duration}}

# {{message_unixtime_array}}

# Emotion/Asset Syntaxes

# {{asset::A}}

# {{emotion::A}}

# {{audio::A}}

# {{bg::A}}

# {{video::A}}

# {{video-img::A}}

# {{raw::A}}

# {{img::A}}

# {{assetlist}}

# {{emotionlist}}