You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 11, 2026. It is now read-only.
Copy file name to clipboardExpand all lines: en/dev/star/guides/plugin-config.md
+20-1Lines changed: 20 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -43,7 +43,7 @@ The file content is a `Schema` that represents the configuration. The Schema is
43
43
}
44
44
```
45
45
46
-
-`type`: **Required**. The type of the configuration. Supports `string`, `text`, `int`, `float`, `bool`, `object`, `list`, `dict`, `template_list`, `file`. When the type is `text`, it will be visualized as a larger resizable textarea component to accommodate large text.
46
+
-`type`: **Required**. The type of the configuration. Supports `string`, `text`, `int`, `float`, `bool`, `object`, `list`, `dict`, `template_list`, `file`, `palette`, `palette_rgb`, `palette_hsv`. When the type is `text`, it will be visualized as a larger resizable textarea component to accommodate large text.
47
47
-`description`: Optional. Description of the configuration. A one-sentence description of the configuration's behavior is recommended.
48
48
-`hint`: Optional. Hint information for the configuration, displayed in the question mark button on the right in the image above, shown when hovering over it.
49
49
-`obvious_hint`: Optional. Whether the configuration hint should be prominently displayed, like `token` in the image above.
@@ -81,6 +81,25 @@ Introduced in v4.13.0, this allows plugins to define file-upload configuration i
81
81
}
82
82
```
83
83
84
+
### `palette` type schema
85
+
86
+
Introduced in v4.15.0, this allows plugins to define color selection configuration items, providing a visual color picker.
87
+
88
+
Three types are supported:
89
+
-`palette`: Returns HEX format (e.g., `#FFFFFF`).
90
+
-`palette_rgb`: Returns RGB format (e.g., `rgb(255, 255, 255)`).
91
+
-`palette_hsv`: Returns HSV format (e.g., `hsv(0, 0%, 100%)`).
92
+
93
+
```json
94
+
{
95
+
"theme_color": {
96
+
"type": "palette",
97
+
"description": "Theme Color",
98
+
"default": "#6200EE"
99
+
}
100
+
}
101
+
```
102
+
84
103
### `dict` type schema
85
104
86
105
Used to visualize editing a Python `dict` type configuration. For example, AstrBot Core's custom extra body parameter configuration:
0 commit comments