Social Stream Ninja

Loyalty points and rewards

Giveaways, paid tickets, game prizes and recovery guide

Award points for participation, let viewers redeem approved rewards, and back up their balances.

1. Enable participation points

  1. Open SSN’s Global settings and tools → Points System. Turn on Enable loyalty points system.
  2. Start with Points per engagement: 1 and Engagement window (minutes): 15, then adjust to suit your stream.
  3. Enable !points, !leaderboard, and !rewards commands if you want those chat replies.
  4. Keep SSN and the source chats capturing. Ask a test viewer to send a normal message, then inspect Manage User Points.

Points reward captured participation, not silent viewing time or every message. After an award, the viewer needs a later qualifying message outside the engagement window to earn again. Participation streaks can add bonuses. Repeated messages inside the same window do not repeatedly award points.

  1. Participate Captured chat activity
  2. Earn Eligible engagement window
  3. Redeem Balance and cooldown checks
  4. Display Connected reward overlay
The engagement window limits earning; a reward separately checks price and cooldown.

2. Check and manage balances

Viewers use !points for their balance and !leaderboard for rankings when enabled. Replies require a source that can post back to chat; if no reply arrives, check the balance through Manage User Points before assuming no points were earned.

Use Manage User Points for a specific viewer and platform, or View Leaderboard for an overview. Accounts are keyed by username and source type: matching names on Twitch and YouTube have separate balances. Do not assume a viewer’s accounts are automatically linked.

3. Offer a sticker reward

  1. In Points System → Sticker rewards, enable sticker rewards and choose the packs you want available. Set a point price suited to your earning rate.
  2. Copy the OBS browser source link into OBS and keep the sticker source loaded.
  3. In Timing & chat replies, set the display time, per-viewer cooldown, per-sticker cooldown, and quiet gap. Enable command replies if desired.
  4. Have a test viewer type !stickers to list enabled sticker codes and prices, then !sticker rocket if that code is enabled and affordable.
  5. Check the displayed sticker and remaining balance before announcing the reward.

Approval happens when you choose the catalog. Enabled stickers redeem automatically; there is no per-redemption approval queue. For custom images or GIFs, you supply and approve the direct HTTPS asset URL. Viewers cannot submit arbitrary artwork through the sticker command.

A cooldown or offline overlay rejects the request without spending points. If display delivery fails after spending, SSN attempts a refund and reports failures that need a host correction. A connected overlay does not prove that OBS currently shows its scene.

See Sticker packs and setup for previews, custom artwork, and GIF choices. !stickers is the sticker catalog command; !rewards lists the general points reward commands.

4. Add optional Event Flow rewards

For custom actions, use the existing Event Flow editor and its Spend Points action. Put your exact command condition before spending, set Amount to Spend, and connect the paid action after a successful spend. Include a cooldown in the flow.

Test both an insufficient balance and a sufficient balance before enabling a reward. A custom action that fails after charging does not automatically inherit the sticker system’s delivery/refund behavior. Review failure handling before attaching paid commands to media or external actions. See Event Flow.

5. Preserve points across moves

Points live in local browser/app storage. Sharing a session ID with another computer or installation does not synchronize balances.

  1. Use Points System → Backup & Restore → Export Points and retain the JSON file.
  2. On the destination installation, export any existing points first, then use Import Points and select the intended import mode.
  3. Choose carefully: Merge keeps higher point values; Replace overwrites the existing points data. Review the import result, spot-check viewers and platforms in Manage User Points, and confirm balances before resuming rewards.

Keep a dedicated points export alongside your settings backup. Reset All Points clears the points ledger; use it only for an intentional reset after exporting.

Troubleshooting

  • Balance stays unchanged: check capture, the master switch, the engagement window, and the viewer’s platform account.
  • Sticker says unavailable: check pack/code selection, sufficient funds, cooldowns, and the loaded OBS sticker source.
  • Points missing after a move: import the points export into the installation doing the capture; a session link alone is not a backup.