Do · Actions · supported
Set counter
Set a named counter to a specific value.
action.set_counter · 2.8.0
Requirements and availability
Counter storage available.
Picker contexts: automation, timer, command, pad.
Behavior
Resolve counter_name and value; missing value defaults to 0. Dispatch !setcounter.
Configure in the app
Open: Do → Advanced Actions (commands only) → Add action
Steps
- Choose action category Chat Bot Commands, select Set counter, and click Add action.
- Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
- Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
- Use Move action up / Move action down to position this action, then save the containing command, automation, timer or SheevPad button.
Limitations
- Picker availability does not supply missing event variables. Check prerequisites and originating provider.
- An action return value is not automatically a sequence variable. Only documented producers create template outputs.
Fields
| Field | Input / options | Defaults / limits | Availability |
|---|---|---|---|
Counter namecounter_name | text | Editor defaults: {"automation":"","timer":"","command":"","pad":""} Example hint: deaths | Supports variables |
Valuevalue | text | Editor defaults: {"automation":"0","timer":"0","command":"0","pad":"0"} Example hint: 0 | Supports variables |
Platformplatform | select
| Editor defaults: {"automation":"event","timer":"all","command":"event","pad":"all"} | Literal value / selected resource |
Contract details
- Declared Contexts
[ "timer", "automation" ]- Picker Contexts
[ "automation", "timer", "command", "pad" ]- Hidden From Picker
- false
- Required Variables
[]- Failure Behavior
- See the behavior for local skips/errors and context entries for sequence continuation.
- Outputs
[]
Examples
Illustrative configuration; replace fixture resources in the editor. This is not an import file.
{
"counter_name": "deaths",
"value": "5",
"platform": "twitch"
}Related entries
Source and verification
Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.
- src/features/automations.js — ACTION_REGISTRY.set_counter
- public/index.html — getBuilderActionEntries / createDefaultAction
Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1