Counters
A counter is a chat command that increments by one each time it is invoked. Counters are useful for tracking running totals on stream, such as deaths per session, retries, donations milestones, or any other recurring tally.
Counters are managed on the Counters page (/counters), separate from regular commands. In chat they behave like a regular command: a viewer types the trigger, the bot responds with the message template, and the stored count increases by one.
How it differs from a regular command
| Custom command | Counter | |
|---|---|---|
| Response | Static template, expanded with {user}, {displayname}, {channel}. | Same, with the additional {count} variable. |
| State | Stateless. | Persists a count value, incremented atomically on each invocation. |
| Reset | Not applicable. | Workspace members with the appropriate permission can override or reset the count from the dashboard. |
In all other respects a counter is configured like a custom command: trigger, aliases, cooldowns, permission, and an enabled toggle.
Creating a counter
Click New counter on /counters and fill in:
| Field | Notes |
|---|---|
| Trigger | Starts with !, lowercase, letters/digits/underscore/hyphen, max 32 chars. Example: !lost. |
| Aliases | Comma-separated. Up to 10. Each alias must be unique within your workspace. |
| Message | Up to 400 characters. Template variables: {count}, {user}, {displayname}, {channel}. |
| Counter value | Initial value when creating; current value when editing. Edit it to override; click the reset icon to set it back to 0. |
| Global cooldown (s) | 0 = no limit. Maximum 86 400 (24 h). |
| Per-user cooldown (s) | 0 = no limit. Same maximum. |
| Minimum role | Same six-tier scale as commands (Everyone / Follower / Subscriber / VIP / Moderator / Broadcaster). |
| Enabled | If off, the trigger is reserved but the bot stays silent. |
Example
- Trigger:
!deaths - Aliases:
!died, !rip - Message:
Death count for this stream: {count}. - Cooldowns: 5 s global, 0 per-user
After seven invocations, chat displays: "Death count for this stream: 7."
Editing a counter
Click the edit icon on the row. The dialog displays the current count. If a chat invocation increments the counter while the dialog is open, your save will not overwrite that increment unless you modify the count value yourself. AveloBot only sends a count override when the field differs from its value at the time the dialog was opened.
Two distinct permission concepts
Two different permission mechanisms apply to counters and should not be confused:
counters.managecontrols which workspace members can view and edit the Counters page. By default this includes the Owner, every Admin, and every Moderator. See Team & permissions to adjust this.- Minimum role on each individual counter controls which Twitch chatters can trigger it (Everyone, Follower, Subscriber, VIP, Moderator, Broadcaster). This is independent of workspace membership.
A workspace Moderator can therefore edit a counter whose minimum role is Subscriber, even if they are not themselves subscribed to your Twitch channel.