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

Increment user counter

Add to one viewer inside a user counter category. Blank username uses the triggering viewer.

action.increment_user_counter · 2.8.0

Browse all entries

Requirements and availability

User counter category and viewer identity.

Picker contexts: automation, timer, command, pad.

Behavior

Resolve category, username and amount; blank username uses event user, missing amount is 1. Adjust one viewer per target platform.

Configure in the app

Open: Do → Advanced Actions (commands only) → Add action

Steps

  1. Choose action category Chat Bot Commands, select Increment user 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 category
category
text

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

Example hint: Check In

Supports variables
Username
username
text

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

Example hint: {user}

Supports variables
Amount
amount
text

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

Example hint: 1

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.

{
  "category": "Check In",
  "username": "ExampleViewer",
  "amount": "1",
  "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.increment_user_counter
  • public/index.html — getBuilderActionEntries / createDefaultAction

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1

Downloads and AI prompt
Download JSONDownload Markdown