DocumentationManagement
Premium

TikTok Integration

Connect your TikTok live to your server. When the live reaches a like goal, Surge gives a prize in game, either to everyone online or to viewers who type !claim in the TikTok chat.

01Premium

Good to know

TikTok Integration is a Premium system. On Free you can see the page but it stays locked, and Surge does not watch your live until the server has Premium.

02What it does

TikTok Integration links your TikTok live to your Rust server. You set goals for likes, comments, follows and shares, and you can also pay the person who sends a gift. When a goal is reached, Surge hands the prize out in game by itself. You can also post Discord embeds when the live starts and when it ends, under Discord Integration > Server to Discord > TikTok Live — those only send while a TikTok account is switched on.

For each goal you choose who gets it: everyone online on the server, or only the people watching the live. Viewers claim by typing !claim in your TikTok live chat, so it gives people a real reason to tune in and stay.

Good to know

A server can watch two TikTok lives at once. Each live has its own goals, so likes on one never count toward the other. Lives on one server never count toward a different server either.

03Setting it up

  1. 1Open Management > TikTok Integration and stay on the Accounts tab.
  2. 2Type the public TikTok username of the account that goes live, the name after the @. You can paste a profile link too and Surge picks out the name.
  3. 3Click Add. You can save up to 10 accounts, handy if more than one person on your team streams.
  4. 4Flip the switch on the account you're streaming from. Two accounts can be on at once. Turning a third on is blocked until you switch one off.
  5. 5Open the TikTok Prizes tab, pick the account, and click Add Goal. Goals you save there belong only to that account.

While an account is on, Surge checks every minute whether it's live. As soon as it is, Surge joins that live on its own, starts counting likes and reads the chat. If two accounts are on, each one gets its own card at the top, with its own like count and viewers.

Tip

The Open link on each account opens its TikTok live, so you can check you typed the right name.

04Goals

  • Goal type: Likes, Comments, Follows, Shares or Gifts. Likes use TikTok's own total. Comments, follows and shares are counted from the moment Surge joins the live.
  • Like goal: how many likes the live needs, from 10 up to 100,000,000. Comments, follows and shares start at 1. The quick buttons fill in common amounts.
  • Once per live pays out the first time the live gets there. It's ready again on your next live.
  • Every X pays out again each time the count goes up by that amount. A 10,000 like goal pays at 10,000, 20,000, 30,000 and so on. Comments, follows and shares work the same way.
  • Who gets the prize: Everyone on the server or Only those in the live.
  • Claim window (only those in the live): how long viewers have to type !claim after the goal is reached, from 1 to 60 minutes. The default is 5 minutes.
Good to know

Surge uses TikTok's own like total for the live, so likes from before Surge joined still count. Comments, follows and shares only count after Surge joins.

Gifts pay the person who sent the gift, not the whole server. Choose Any gift, or set a minimum in coins or diamonds. A gift streak counts once, when the streak ends, using the full amount.

  • Give it straight away: if that person is online on your server, the prize goes in game. If they’re offline, it goes to their Vault and they claim it when they’re back. If their TikTok isn’t linked on Surge, they miss it.
  • They type !claim: only the sender can claim, and they have to be online. The claim window is the same 1 to 60 minutes as the other goals.

You can have up to 20 goals on each account. Pick the account at the top of TikTok Prizes to see and edit only that live's goals. Each goal card shows a progress bar while that account is live. Use the switch on a goal to pause it without losing the setup, or Edit and Delete to change it.

05The prize

Mix and match any of these in one prize. The summary on the right shows exactly what players will get before you save.

  • Items: search any Rust item. Up to 20 items, up to 100,000 of each.
  • Kits: your server's in-game kits. Up to 5 kits, each given up to 10 times.
  • Entities: vehicles, crates, animals and the custom entities you added in Entity Spawning. Up to 5, up to 5 of each. They spawn right next to the player.
  • Fuel: vehicles that use fuel can come with up to 500 low grade.
Good to know

Things that spawn in the world, like a minicopter, go under Entities, not Items.

06Who gets the prize

Everyone on the server. Every player online in game when the goal is reached gets the prize, linked or not. Surge posts something like this in game chat:

[TikTok] @yourname's live hit 10,000 likes! Everyone online gets: 500x Scrap

Only those in the live. Surge posts in game that the prize is ready and how long viewers have to claim it:

[TikTok] @yourname's live hit 10,000 likes! Watching? Type !claim in the TikTok chat within 5 min to get: Assault Rifle, vip kit.

Viewers then type !claim in your TikTok live chat before the window closes. To get the prize a viewer has to:

  • Have their TikTok linked on the Surge website (see below).
  • Be online on your server when they type it.
  • Not have claimed that goal already. Each player can claim each goal once.

When a claim goes through, Surge posts [TikTok] PlayerName claimed the TikTok prize. in game. Items and kits go straight into their inventory, and entities spawn next to them.

07How players use it

  1. 1Sign in to the Surge website and open your server.
  2. 2Click the Link Your TikTok card.
  3. 3Type their exact TikTok username (the name after the @, not their display name) and click Link.
  4. 4Join your live. When a goal for viewers is reached, type !claim in the TikTok chat while online in game.

The Link Your TikTok page also shows your live, every goal with its progress, and a countdown when there's a prize to claim. Once they've claimed, it tells them the prize is on its way.

  • A player links once and it works on every Surge server they play on.
  • One TikTok name can only be linked to one Surge account. The first person to link it keeps it.
  • If someone links a name that isn't theirs, unlink them from the Linked Players tab.

08Status and troubleshooting

The badge at the top right of the page tells you what Surge is doing:

  • Off: no account is switched on.
  • Checking… or Connecting…: Surge is looking for the live or joining it.
  • Not live: the account isn't streaming. Surge checks again every minute.
  • Live: Surge is in a live and counting likes. 2 live means both accounts are streaming.
  • Can't connect: TikTok didn't answer for that account. Use the name after the @, not the display name. Some public accounts have no live room until they have gone live once — Surge keeps trying.
  • Paused: the server isn't on Premium.

Recent goals under your goal cards shows the last goals your live reached and how many players got the prize. On the way means Surge is still delivering. Missed means a player couldn't get it, usually because they went offline. Surge keeps retrying for up to 30 minutes after the goal before it gives up.

If your Rust server was offline, or nobody was online, when an everyone-online goal was reached, Recent goals says so and nobody gets that prize. For viewer goals, players can still claim if the server is back before the claim window closes.

09Good to know

  • Surge can read your TikTok chat but it can't post in it. Everything players need to know shows up in game chat.
  • If the bot restarts during a live, it joins again and carries on. Goals it already paid out are not paid twice.
  • With Every X likes, if the likes jump past several goals while Surge is reconnecting, it pays out once and carries on from there.
  • Once per live goals start again on your next live, even on the same day.
  • Surge only watches the accounts that are switched on, up to two. Turn one off and Surge leaves that live straight away. The other live keeps going.
Tip

Before you announce it, do a test stream with a low goal like 50 likes, so you can see the whole thing work from start to finish.