Skip to reference

Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

Do · Actions · supported

Set counter

Set a named counter to a specific value.

action.set_counter · 2.8.0

Browse all entries

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

  1. Choose action category Chat Bot Commands, select Set counter, and click Add action.
  2. Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
  3. Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
  4. 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

FieldInput / optionsDefaults / limitsAvailability
Counter name
counter_name
text

Editor defaults: {"automation":"","timer":"","command":"","pad":""}

Example hint: deaths

Supports variables
Value
value
text

Editor defaults: {"automation":"0","timer":"0","command":"0","pad":"0"}

Example hint: 0

Supports variables
Platform
platform
select
  • Same platform as event: event
  • Twitch + YouTube + Kick: all
  • Twitch: twitch
  • YouTube: youtube
  • Kick: kick
  • TikTok: tiktok

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

Downloads and AI prompt
Download JSONDownload Markdown