A widget is a feature that displays status information inside the chat window. You can show information such as dates, affection levels, relationships, and more alongside the conversation. Widgets can either be automatically generated using AI or created manually by writing the contents yourself.
Compared to traditional status panels written directly in User Notes, widgets are less likely to omit information during conversation output.
When writing content directly in the User Widget [Direct Input] field, the HTML code used for the widget design is also counted as part of the AI's output length. Because of this, the amount of text available for the actual roleplay or conversation may decrease.
On the other hand, the Template Creation feature loads pre-configured design elements in advance, allowing the AI to output only the core data values used inside the widget. This makes it possible to use more of the available output length for the main response itself, resulting in more stable outputs overall.
Additionally, issues such as widgets being cut off midway or parts of the design failing to display are significantly reduced.
Create > Widget Tab > User Widget allows players to create widgets for personal use.
Creating widgets isn't difficult with Ducky. Follow the guide step by step and get started easily!
Ducky is an AI assistant that helps create widgets. Simply describe the information and design you want inside the widget, and Ducky will generate one for you.
You can achieve more accurate results by including the genre or atmosphere, color/theme, and the information fields you want to include.
Example MessagesCreate a pink-themed widget for a romance genre character. Include the date, time, genders and ages of {{char}} and {{user}}, affection level, and relationship.
Create a dark gold-themed widget for a fantasy RPG character. Include the current location, time period, {{user}}'s HP/MP, gold amount, and companion rank with {{char}}.
Create a pastel blue-themed widget for a school-life character. Include the weekday, class period, weather, {{char}}'s mood, and intimacy with {{user}}.
Create a monochrome-themed widget for a mystery thriller. Include case number, current clue count, {{char}}'s suspicion level, and elapsed time.
Create a simple beige-themed widget for a slice-of-life character. Include the date, weather, {{char}}'s condition, and atmosphere with {{user}}.
Ducky can view all currently written state values, status information, and content. If you need to modify the HTML or add additional status values while editing, you can continue using Ducky for revisions as well.
If creating a widget from scratch feels difficult, you can load and use sample themes provided by CaveDuck (Black Theme / Pastel Theme). You may use the samples as-is, or customize them by adding new status values or modifying the design.
Widgets are completed by filling out three sections:① State Values② Instructions③ Widget Content
State Values are the names of the status information displayed inside the widget.
Please use names with clear meanings.Names such as Name1, Name2, or ValueA are not recommended.
Examples:Date, Time, Weather, Affection, Relationship, Location, Money, Stamina etc.
State value names cannot consist entirely of uppercase letters. NPC / Npc ⭕️
Clear state value names help the AI correctly understand the instructions and output values that match the conversation flow.
Instructions define how each state value should be generated and displayed. You can freely decide what kind of value each state value should output and in what format.
Example InstructionsState Value: Date → Write the current date of the conversation. Output example: MM-DD
State Value: Time → Write the current conversation time in 24-hour format. Output example: 14:30
State Value: Weather → Write the current background weather in one word. Output example: Sunny, Rainy, Snowy
State Value: Affection → Write {{char}}'s affection level toward {{user}} as a number between 0 and 100. Output example: 72
State Value: Relationship → Briefly describe the current relationship between {{char}} and {{user}}. Output example: Friends, Lovers, Rivals
State Value: Location → Write the current location where the conversation is taking place. Output example: School Rooftop
State Value: Mood → Write {{char}}'s current mood in one word. Output example: Excited, Irritated, Calm
Providing clear output examples helps maintain consistent formatting.
Widget Content is the section where you create the actual design and layout displayed on screen.
To insert a state value, use the format {{State Value}}. You can also directly select available state values from the list below the editor.
You may freely decorate the widget using text, dividers, emojis, and more.
Since HTML code is supported, you can directly implement your desired styles and layouts.
You can instantly preview the results while editing.
After saving, you can also view translated versions for each language inside the preview window.
Example
<div style="padding:10px; border:1px solid #f5a;">
📅 {{Date}} · 🕒 {{Time}}
<br>
💗 Affection: {{Affection}}
<br>
Relationship: {{Relationship}}
</div>NotesValues displayed through {{State Value}} inside the preview are shown only in the editing language. However, when the widget is actually used in chat, the resulting state values are automatically displayed in the player's language.
Move to an ongoing or new conversation.
If the character has Creator Widgets enabled, you can assign widgets through User Note > User Widget.
Different widgets can be applied for each conversation, allowing different status panel setups depending on the situation.
NotesWhen applying widgets to conversations, the User Note character limit is shared together with the widget. Please adjust the widget length accordingly.
Displaying too many status values may reduce the length of the AI's main response.
If you already have status panel commands written inside User Notes, please remove those commands when applying widgets.
Widgets may not function properly on characters that do not have Creator Widgets enabled.