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
- 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.
- 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 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.
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.
Add the TikTok account
In Live Announcements, add the streamer with TikTok ticked (see above). The overlay uses that TikTok name.
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.
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.
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 |
- 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.
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.