Goals
Set a target for followers, subs, bits or anything a macro counts, with milestones on the way, and react when you pass them.
A goal is a target the stream works toward: 50 followers, 20 subs this month, 5,000 bits tonight, or any number a macro moves. CroStream counts progress from your channel’s events by itself, shows it on a bar with milestones, starts it over when a stream, day, week or month ends, and runs macros when you pass a milestone or reach the target. Overlay widgets can show it live.
Goals are built in; they need no connection beyond Twitch for the goals that count Twitch events.
The Goals page
Section titled “The Goals page”Open Goals in the sidebar (under Automate). Each goal is a card showing:
- its label, its progress as current / target, and a progress bar with a mark for each milestone;
- buttons: −1 and +1, Set…, Reset, Edit and Delete. A goal that follows a counter has no value of its own, so it has no −1, +1 or Set…: change the counter instead.
Goal settings
Section titled “Goal settings”| Setting | What it does |
|---|---|
| Name | The goal’s key, used in {goal.<name>}. Lowercase letters, digits, - and _, up to 40 characters. It can’t change after you create the goal; to rename it for display, change the label. |
| Label | The name people see, such as Followers. |
| Description | A note for yourself. |
| What the goal counts | See What counts. |
| Target | The value that completes the goal. |
| Start value | Added to what is counted, for a goal that starts part way: the followers you already have, for example. A reset returns to it. |
| Starts over | See Starting over. |
| Carry over | Keep what went over the target as the start of the next round, when a day, week or month ends. |
| Milestones | Marks between the start and the target. Up to 20, each a value or a percent of the target, with an optional label. |
| Bar color and Bar text | Hints for overlay widgets that show this goal. The text can use {label}, {current}, {target}, {percent} and {remaining}, which the widget fills in. |
Targets, start values and milestone values go up to 1,000,000,000. You can have up to 200 goals.
What counts
Section titled “What counts”| Counts | Each of these adds |
|---|---|
| Followers | 1 for each new follower. |
| Subs | 1 for each sub: new subs, resubs and gifted subs, one each. A gift of five subs counts five. |
| Sub points | Like subs, but weighted by tier: tier 1 and Prime count 1, tier 2 counts 2 and tier 3 counts 6. |
| Bits | The bits of each cheer, power-ups included. |
| Raiders | The viewers who arrive with each raid. |
| Manual | Nothing by itself: only what macros and the Goals page add. |
| Counter | Follows the value of one of your counters. The goal has no value of its own. |
Note: Gifted subs aren’t counted twice
CroStream counts a sub once per recipient. The announcement of a gift (“Ann gifted 5 subs”) would count the same subs again, so goals ignore it. A goal’s progress matches the subs that actually happened.
Test events (the Test button on a trigger) count for nothing. Anything a macro adds or sets with the goal actions counts on top of what the goal counted.
Starting over
Section titled “Starting over”| Starts over | When |
|---|---|
| Never | Never. It keeps counting until you reset it. |
| Each stream | When the stream goes live. |
| Daily | At midnight, by the clock of the PC that runs CroStream. |
| Weekly | At midnight on Monday. |
| Monthly | At midnight on the 1st. |
| Date range | It counts only between a From and an Until you set; leave Until empty for no end. |
Starting over puts the goal back to its start value and fires Goal reset. With Carry over on, a goal that went over its target starts the next round with the extra. If CroStream was closed when a day, week or month ended, the goal starts over when CroStream opens. A goal that follows a counter doesn’t start over by itself; the counter’s own reset rule decides.
Use a goal in a macro
Section titled “Use a goal in a macro”Show it in any text
Section titled “Show it in any text”| Write | You get |
|---|---|
{goal.<name>} |
Progress as current/target, such as 12/50. |
{goal.<name>.current} |
The current value. |
{goal.<name>.target} |
The target. |
{goal.<name>.percent} |
How far it is, in percent. It can pass 100. |
{goal.<name>.remaining} |
How much is left to the target; 0 once reached. |
{goal.<name>.label} |
The goal’s label. |
Goal actions
Section titled “Goal actions”The Goals group of the palette has nine actions:
| Action | What it does | Outputs |
|---|---|---|
| Add to a goal | Adds to its value; a negative amount takes away. The amount is 1 when empty. | {current}, {previous}, {delta}, {percent}, {done} |
| Set a goal’s value | Sets it, for example to a total you read from somewhere else. | {current}, {previous}, {delta}, {percent}, {done} |
| Reset a goal | Starts it over from its start value. | {current}, {previous}, {delta}, {percent}, {done} |
| Set a goal’s target | Changes the target, for example to raise it after it’s reached. | {target}, {previous}, {percent} |
| Read a goal | Reads its progress and settings. | {current}, {target}, {remaining}, {percent}, {done}, {label}, {metric}, {period} |
| Create a goal | Makes a goal. If the name exists, it fails or keeps the existing goal. | {current}, {target} |
| Change a goal’s settings | Edits the settings. Fields left empty stay as they are. | {target} |
| Delete a goal | Removes it and its progress. | {previous} |
| List goals | Lists every goal. | {names}, {count} |
A goal that follows a counter can’t be added to, set or reset by a goal
action: change the counter. Every setting accepts {variables}. Full details
are in the Actions reference.
React to a goal
Section titled “React to a goal”| Event | Fires when |
|---|---|
| Goal progress | A goal’s value changes, for example for every follower. Pick a direction: any, up or down. It doesn’t appear in the activity feed. |
| Goal milestone reached | A goal passes one of its milestones going up. Limit it to one milestone by its label or value. |
| Goal reached | A goal reaches its target. It fires again after the goal has started over and gets there again. |
| Goal reset | A goal starts over. Pick the cause: any, manual, macro, stream or period. |
| Goal created and Goal deleted | A goal is made or removed. |
Going down never fires a milestone or the target; going up across one again
fires it again. The macro gets {goal}, {label}, {current}, {previous},
{delta}, {target}, {percent}, {remaining}, {done}, {how} and
{cause}, plus {milestone} and {milestone_value} for a milestone. See the
Events reference.
For example, to thank chat at the halfway point of a follower goal: make a
goal followers that counts Followers with target 100 and a milestone
50% labeled Halfway, then a trigger on Goal milestone reached that
runs a macro sending Halfway to \{goal.followers.target\} followers! Thank you!
Check a goal in a condition
Section titled “Check a goal in a condition”An If step can check the live values Goal percent, Goal value and Goal reached. See Conditions.
Goals in overlays
Section titled “Goals in overlays”Overlays and custom widgets read a goal as the data key goal.<name>: its
current value, target, percent, label, milestones and the color and text you
set. CroStream has no built-in goal widget; any widget from the
gallery or one you build yourself
can read it. Goal bars from the gallery that read a counter keep working.
See Overlay data.
Free plan
Section titled “Free plan”The free plan has 1 goal. Subscribers to Haliebug13 on Twitch have unlimited goals.
If you’re over the limit, for example after a subscription lapses, your goals keep counting and you can still adjust, reset and re-target them from macros and the Goals page. Editing their other settings and adding goals need a subscription. Deleting is always allowed.
Related
Section titled “Related”- Counters, which a goal can follow.
- Macros, Triggers and Actions.
- Widget gallery and Overlay data.
- Config file and API.