Skip to content

StreamElements sub-actions

Add user points

Gives a viewer StreamElements loyalty points, or takes some away with a negative number. Good for rewards.

Setting What to put in
User The viewer's login name. The default %userName% means the person who ran the action. Make sure it is their name on the streaming site. Starts as: %userName%.
Points How many points to give. Use a minus sign, like -50, to take points away. Starts as: 100.

Variables it adds

Variable What it holds
%sePoints% Their points after the change

Type id: streamelements.addUserPoints

Get latest tips

Looks up your most recent StreamElements tips. Handy to show or read out the latest supporters.

Setting What to put in
Tips How many of the latest tips to fetch. 5 gets the five newest. Starts as: 5.

Variables it adds

Variable What it holds
%seTipCount% How many tips were found
%seTip0User% Who sent the newest tip (use 1, 2, 3... for older ones)
%seTip0Amount% How much it was (use 1, 2, 3... for older ones)
%seTip0Currency% Its currency
%seTip0FormattedAmount% The amount written nicely
%seTip0Message% Their message
%seTip0CreatedAt% When it was sent

Type id: streamelements.getTips

Get points leaderboard

Looks up your top viewers by StreamElements loyalty points. Handy to read out a top list in chat.

Setting What to put in
Users How many people to fetch, starting from the top. 5 gets the top five. Starts as: 5.

Variables it adds

Variable What it holds
%sePointsLeaderCount% How many people were found
%sePointsLeader0User% The name of number 1 (use 1, 2, 3... for the next ones)
%sePointsLeader0Total% Their points (use 1, 2, 3... for the next ones)

Type id: streamelements.getPointsLeaderboard

Get tip leaderboard

Looks up the people who tipped you the most on StreamElements. Handy for a thank-you list.

Setting What to put in
Tippers How many people to fetch, starting from the top. 5 gets the top five. Starts as: 5.

Variables it adds

Variable What it holds
%seTipLeaderCount% How many people were found
%seTipLeader0User% The name of number 1 (use 1, 2, 3... for the next ones)
%seTipLeader0Total% How much they tipped in total (use 1, 2, 3... for the next ones)

Type id: streamelements.getTipLeaderboard

Get user points

Looks up how many StreamElements loyalty points a viewer has. Handy for a "you have X points" chat reply.

Setting What to put in
User The viewer's login name. The default %userName% means the person who ran the action. Make sure it is their name on the streaming site. Starts as: %userName%.

Variables it adds

Variable What it holds
%sePointsUser% The viewer's name
%sePoints% Their points right now
%sePointsAllTime% All the points they ever earned
%sePointsRank% Their place on your points list (1 is the top)

Type id: streamelements.getUserPoints