Configuration guide

Live Announcements

Post a card when a member goes live on YouTube, Twitch, Kick or TikTok, then turn it into a Stream Ended summary. TikTok streamers can also get a LIVE overlay for OBS. This page covers every field and limit.

Time
10 minutes
You need
Owner, Co-Owner or Head Admin (Discord), or Manage Server (website)
Applies to
Per Discord server

Overview

Live Announcements post a card in a channel when a member you list goes live. When they stop, the same card changes to Stream Ended with their peak viewers and stream length.

You can add up to 10 members per Discord server.

Setup & Configuration

On the website
  • Log in to the RustyWorks website, open Servers Configure, pick your server and select Live Announcements.
  • Press Add Your First Streamer (or Add Streamer), work through the four steps and press Save. The bot picks it up within a minute.
In Discord
  • Run /live config. Press Setup Live, View Live or Remove Live.
Step What you set
1. Who goes live? The Discord member
2. Which platforms? Tick YouTube, Twitch, Kick or TikTok, and enter their username or channel link for each ticked platform
3. Announcement channel Where the card is posted
4. Role to ping Optional. Choose No role ping to skip
The ping role must be mentionable

The role needs Allow anyone to @mention this role turned on, or the bot needs the Mention All Roles permission, for the ping to notify people.

TikTok LIVE Overlay

A streamer with a TikTok account set up above can have a LIVE overlay: a transparent web page you add to OBS, Game Capture or TikTok LIVE Studio. It shows a Gift Goal bar, a Top Gifter board, a Top Liker board, the next milestone, a scrolling live feed and a red milestone pop-up when a target is reached.

The overlay is on the website only. It reads the stream, shows text and never gives anything in game. A milestone reward is the text you write for the pop-up, plus an optional Discord message.

TikTok has no official LIVE data feed

The bot reads TikTok the same way other open-source tools do, so it can lag, or stop updating if TikTok changes something. The stream itself is never affected. If TikTok blocks the bot, the overlay simply stops updating.

  1. Add the TikTok account

    In Live Announcements, add the streamer with TikTok ticked (see above). The overlay uses that TikTok name.

  2. Open the overlay page

    • Log in to the RustyWorks website, open Servers Configure, pick your server and select Live Announcements.
    • Press TikTok Overlay. If you have several streamers with TikTok, pick one at the top.
    • Tick Overlay on and press Save after any change.
  3. Add it to your streaming software

    Press Copy next to the overlay link. In OBS add a Browser source, paste the link, and set Width 1920 and Height 1080. In TikTok LIVE Studio or Game Capture setups add it as a Web / Browser source at the same size. It scales to other sizes by itself.

Keep the link private

Anyone with the link can see your overlay. New link makes a fresh one and the old link stops working straight away, so paste the new one into your streaming software.

Status

The box at the top shows what the bot is doing:

Status What it means
Overlay is off The switch is off. Nothing is drawn on stream
Waiting for the bot The bot has not reported yet. It checks every 15 seconds
Not connected yet The bot connects when the streamer goes live on TikTok. It tries every couple of minutes, and sooner once the live announcement appears
Connected, waiting for the stream Connected, but the stream is not live right now or has just ended
Connected, reading the live stream Live. Shows viewers, likes, diamonds and new followers

Preview

The Preview shows the overlay with fake data. Drag the panels to place them, and the Layout numbers update as you go. The preview does not use your real stream.

Button What it does
Preview milestone pop-up Plays the pop-up in the preview only
Send test pop-up to my stream Shows a test pop-up on the real overlay for a few seconds. Save first so it uses your latest first milestone
Reset stats Sets the boards, Gift Goal and milestones back to zero. The bot applies it within 15 seconds

Look

Setting What it does Limits and default
Accent colour The colour of the panels and text Default amber #ffb000
Pop-up colour The colour of the milestone pop-up Default red #ff4a2b
Font JetBrains Mono, Share Tech Mono, VT323 (retro) or Courier New JetBrains Mono
Overall size Scales every panel together 0.5 to 1.5. Default 1
Pop-up stays for (seconds) How long each pop-up shows 3 to 20. Default 8
Rows per leaderboard How many names each board lists 1 to 5. Default 3
Gift value is called The label on the gifter board Diamonds or Coins. Default Diamonds

Layout

Positions are pixels on a 1920 × 1080 screen: Left (-400 to 2400), Top (-300 to 1400) and Size (0.4 to 2.5). Gift goal, Leaderboards and Next milestone can each be hidden with Show. The pop-up has its own position and size. The Live feed bar can be hidden or put at the top or bottom of the screen.

Gift goal

Setting What it does Limits and default
Title The name on the bar Up to 30 characters. Shown in capitals. Default GIFT GOAL
Goal (diamonds) The total gift value to reach 1 or more. Default 2,000
Subtitle Shown under the bar Up to 80 characters
Reward text Shown in the pop-up when the goal is reached Up to 80 characters

Viewer milestones

Press Add milestone. You can have up to 12. Each one has:

Field What it does
Type Likes, Gift value (diamonds), Peak viewers or New followers
Target The number that triggers it. Must be 1 or more
Reward text Up to 80 characters. Shown in the pop-up

The Next milestone panel shows whichever milestone is closest to done. When one is reached the pop-up plays once. A milestone that is already reached when you add it (or when the bot restarts) is marked done quietly. Changing a target makes it a new milestone. Peak viewers never go back down, so that milestone cannot trigger twice.

Options

Setting What it does Default
Stats start fresh Every new stream zeroes the boards and totals for each new TikTok LIVE. Never keeps running totals across streams Every new stream
Also post milestones in Discord Posts a short message in the channel you pick when a milestone is reached Off
Counting rules
  • Gift value counts diamonds. A gift sent in a combo is counted once, when the combo ends.
  • Likes use TikTok's running total for the stream. The Top Liker board adds up each person's likes.
  • The overlay refreshes every few seconds, so numbers can trail the stream slightly.

Commands & Usage

Command What it does Who can use it
/live config Opens the Live Announcements hub Owner, Co-Owner, Head Admin

Troubleshooting

Problem Cause Fix
"Limit of 10 reached" The server already has 10 streamers Remove someone first
"Tick at least one platform" or "Enter the username" A platform is ticked without a name Enter the name, or untick the platform
The ping did not notify anyone The role is not mentionable Allow the role to be mentioned, or give the bot Mention All Roles
Nothing was posted The bot cannot post in the channel Check its channel permissions
The TikTok Overlay page says nobody has a TikTok account No streamer has TikTok ticked Add a streamer with TikTok in Live Announcements first
The overlay is blank in OBS The overlay is off, or the link is wrong Tick Overlay on and press Save. Copy the link again
The overlay says the link was not found The link was replaced with New link Copy the current link from the page
Status stays on "Waiting for the bot" The bot does not have the overlay update yet Ask the bot owner to update the bot
The numbers never move The stream is not live, or TikTok is blocking the bot Check the status box. This can happen because TikTok has no official feed
The test pop-up does not show The overlay is off, or you have not saved Switch it on and Save, then try again
The pop-up covers a board It sits in the middle by default Change the pop-up's Left and Top, or drag the panels in the preview

Checked against RustyWorks on 1 Nov 2026.

Stuck on this step?

Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.