מאקרו (CBS)

מאקרו הם אסימונים בסוגריים מסולסלים כפולים שמתרחבים בזמן הבקשה. הם עובדים בשדות דמות, ברשומות ספר לור, בפריסטים, בברכות פתיחה ובטקסט השיחה, והם ניתנים לקינון.

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

ארגומנטים מופרדים בנקודתיים כפולות. מאקרו לא מוכר מתרחב לכלום במקום להחזיר שגיאה, כך ששגיאת הקלדה לעולם לא שוברת בקשה.

סוגריים בודדים אינם מאקרו. זוג אחד מגיע למודל כטקסט מילולי ומופיע בתשובות, הסיבה הרגילה לסוגריים תועים. תואם ל-SillyTavern, ל-RisuAI ול-JanitorAI, כך שהכרטיסים שלהם עובדים ללא שינוי.

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

המאקרו random בוחר ארגומנט אחד מחדש בכל הרחבה. המאקרו pick מבצע בחירה שנשארת יציבה לאורך השיחה. המאקרו roll מטיל קוביות בסימון d.

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

הטלות וערכים אקראיים נזרעים לכל תור: יצירה מחדש משתמשת באותם ערכים, כך שהחלקה לא מטילה קוביות מחדש.

משתני שיחה נשמרים לכל ענף שיחה. משתנים גלובליים נשמרים בכל השיחות. הגדירו אותם בכל טקסט שתומך במאקרו או מסקריפטים מפעילים.

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

אחסון בהיקף ענף פירושו שהחלקה לענף אחר משחזרת את מצב המשתנים של אותו ענף. ענפים אחים לעולם לא מדליפים ערכים זה לזה.

בלוקים עוטפים תוכן. הבלוק if מציג את גופו כשהתנאי מתקיים. הבלוק each עובר על מערכים עם החלפת משבצות. הבלוק when מוסיף ענפי else מבוססי שורות.

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

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

הבלוקים pure ו-escape מגנים על סוגריים מילוליים מהרחבה. כל תג סוגר סוגר את הבלוק הפתוח הפנימי ביותר.

מאקרו הערה נעלמים לפני שהמודל רואה אותם, כך שהם מתאימים להערות בתוך שדות כרטיס. השתמשו בבלוקי pure כדי להציג תחביר מאקרו כלשונו.

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