Counters

A counter is a custom whole number (like sit-up reps or today's death count) you can adjust from chat commands, reward effects, the wheel, automations, or the dashboard, all shown on a single OBS overlay as "name + value + unit".

What it solves

Streams often have "the thing this session is counting" that is not points (no per-viewer balance) and not a goal (no target or percentage) — just a number that changes, where the streamer wants full control over how it moves and when it resets. Counters are the smallest tool for exactly that: a name, a number, a unit.

Getting started

1. Create a counter and give it a name (e.g. "Sit-ups"); an ID is generated automatically and can be renamed later.
2. Optionally set a unit, starting value, min/max range, and the three step sizes used by the quick +/- buttons.
3. Switch to the "OBS Widget" tab, add the source URL to your streaming software, and pick a theme.

Five ways to adjust it

A counter's value can change from five places: the quick buttons on the dashboard console, chat commands (!addcounter / !setcounter), reward effects, wheel prize actions, and automation rule actions. All five go through the same clamping logic — hitting the limit just stops the value there, with no error and no overshoot.

One OBS overlay for the whole channel

Unlike goals, which each get their own overlay, counters share a single source URL per channel that shows every enabled counter at once. The reason is simple: every OBS browser source is its own Chromium instance, so opening one source per counter costs the streamer's own CPU and RAM. If you only want a few counters in a particular scene, use the "generate a split source URL" tool on the OBS Widget tab — pick the counters to include, copy the filtered URL, and add it as a separate source.

Common misconceptions

• Renaming the ID doesn't break old messages or commands. The previous ID is kept as a permanent alias, so existing custom messages and chat command lookups keep resolving correctly.
• Disabled and "hidden from OBS" are different things. Disabling a counter makes every adjustment action a no-op; "show on OBS" only controls whether it's visible on the overlay — the two don't affect each other.
• There is no automatic reset. The value only changes through an explicit adjust/set/reset action — it doesn't clear itself at day or stream boundaries. Use the "Reset" button when you want to go back to the starting value.
• Going past the min/max doesn't error, it just stops. An adjustment at the boundary still succeeds; the value simply stays clamped at the limit instead of failing.
• {counter|ID} only resolves in messages and alert boxes. You can insert another counter's current value into a custom message with {counter|ID} (the variable panel in the message editor lets you pick one, and the chip shows the counter's name). It is only substituted in chat messages and in an alert box's title / subtitle — pasting it into a Twitch command argument, a built-in command argument, or the "redemption success message" won't raise an error, it just renders as blank. The editor only offers the chip on fields that support it, so watch out when typing it by hand or copying between fields.
• No currency conversion, and no per-viewer share. A counter is a single channel-level number, not something each viewer accumulates individually — that's what points and check-ins are for.

Settings

The text below is taken from the in-app help, so it stays in sync with the actual interface.

Chat commands

These are the default command names; they can be renamed or given aliases in the dashboard.

• !counter — Check the current value of a custom counter (!counter ID).
• !addcounter — Add to (or subtract from) a custom counter's value (!addcounter ID amount, MOD).
• !setcounter — Set a custom counter to a specific value (!setcounter ID value, MOD).

Other notes

• The old ID will be kept as a permanent alias — existing messages and commands keep working.
• Step sizes for the three quick +/- buttons in Quick Actions.
• Off by default. When enabled, a chat message is sent every time this counter changes.
• Preview only — this does not affect real values.
• Pick the counters to show, then copy a filtered OBS source URL for a separate browser source.
• Chat commands for custom counters. Set enable, cooldown and aliases on the Commands page.

Other settings

These settings have no additional help text in the dashboard; only their names are listed here.

• Custom integer counters you can adjust from chat commands, reward redemptions, the wheel, or automations, shown live on the OBS widget.
• Quick Actions
• No active counters yet. Go to the Counters tab to add or enable one.
• Apply
• Reset
• No counters yet
• Select a counter on the left, or create a new one
• Over plan limit
• Disabled
• Untitled counter
• Drag to reorder
• Basic
• Name
• Unit
• Value Range & Steps
• Initial value
• Minimum
• Maximum
• Step 1
• Step 2
• Step 3
• Accent Color
• Restore default
• Default
• Chat Announcement
• Announce in chat when the value changes
• Change message
• Counter name
• Counter ID
• Current value
• Change amount
• Action failed
• Demo +1
• Layout & Theme
• Layout
• Theme
• Alignment
• List
• Row
• Grid
• Classic
• Minimal
• Card
• Neon
• Glass
• Digital
• Left
• Center
• Right
• Font & Colors
• Font
• Text color
• Background color
• Corner radius
• Displayed Content
• Thousands separator
• Show counter name
• Show unit
• Change amount color
• Split Source URL
• Viewer commands
• Mod commands
• MOD only
• amount
• value
• Manage commands