Macro (CBS)

Macro là các token trong dấu ngoặc nhọn kép được mở rộng lúc yêu cầu. Chúng hoạt động trong trường nhân vật, mục sổ tri thức, preset, lời chào và văn bản chat thường, và có thể lồng nhau.

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

Đối số ngăn bằng dấu hai chấm kép. Macro lạ mở rộng thành rỗng thay vì lỗi, nên lỗi gõ không bao giờ làm hỏng một yêu cầu.

random chọn một đối số mới mỗi lần mở rộng, pick đưa ra lựa chọn ổn định cho cuộc trò chuyện, và roll gieo xúc xắc theo ký hiệu d.

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

Lần gieo và ngẫu nhiên được cấp hạt giống theo lượt: tạo lại tái dùng cùng giá trị, nên vuốt không gieo lại xúc xắc của bạn.

Biến chat tồn tại theo từng nhánh cuộc trò chuyện; biến toàn cục tồn tại trên mọi chat. Đặt chúng trong bất kỳ văn bản hỗ trợ macro nào hoặc từ kịch bản trigger.

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

Lưu trữ theo nhánh nghĩa là vuốt sang nhánh khác sẽ khôi phục trạng thái biến của nhánh đó; các nhánh anh em không bao giờ rò rỉ giá trị cho nhau.

Khối bọc nội dung: if chỉ kết xuất thân khi điều kiện đúng, each duyệt mảng với thay thế khe, và when thêm nhánh else theo dòng.

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

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

pure và escape bảo vệ dấu ngoặc nhọn nguyên văn khỏi bị mở rộng; bất kỳ thẻ đóng nào cũng đóng khối mở trong cùng.

Macro chú thích biến mất trước khi mô hình nhìn thấy, lý tưởng cho ghi chú trong trường thẻ. Dùng khối pure khi cần hiển thị cú pháp macro theo đúng nguyên văn.

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