Killfeed

01What it does

Killfeed watches every death on your server and posts a styled message in game chat. Player kills, scientist kills, vehicle kills, animal kills and fall deaths can each be switched on or off.

Link a Discord server and pick a channel, and the killfeed posts there too, as a styled Discord message you design yourself. Each death type can go in game and in Discord, in game only, or in Discord only.

At the same time it keeps score. Every player-versus-player kill adds a kill to the killer and a death to the victim, and that's what drives the K/D numbers in the feed and the whole Leaderboard. Stats are kept separately for each of your servers. Drowning, falling, vehicles and other entities never count as a player kill or death.

Killfeed is on by default for new servers, with every death type showing.

02What players see

Out of the box, a PvP kill shows big coloured text like Zander KILLED Bob, followed by the killer's total kills, total deaths and K/D on the lines below. The other death types look like this by default:

• Player vs Scientist: "Zander DROPPED A SCIENTIST"
• Scientist vs Player: "Scientist DROPPED Bob"
• Entity vs Player: "Minicopter DROPPED Bob", "Drowned DROPPED Bob", "Bleeding DROPPED Bob" or "Suicide DROPPED Bob"
• Animal vs Player: "Bear ATE Bob"
• Fall death: "Bob Fell to death"

Some deaths are never shown, no matter what: a player killing an animal, and a player destroying a vehicle or other entity. Those are just noise in a busy chat.

03Setting it up

1. 1Open Features > Killfeed. The top line tells you whether the bot is connected to your server.
2. 2On the Killfeed Settings tab, make sure Killfeed system is ON.
3. 3Switch off any death types you don't want in chat. Each toggle saves straight away.
4. 4Head to Killfeed Personalize if you want to change the wording or colours, then press Save personalize messages.
5. 5Want it in Discord too? Pick a channel in Select a Discord channel at the top of Killfeed Settings, then design the messages on the Discord Messages tab. See Posting in Discord below.

04Every setting explained

• Select a Discord channel: the channel the killfeed posts in. Needs a linked Discord server. Pick Don't post in Discord to stop posting.
• Killfeed system: the master switch. Off means no death messages, in game or in Discord, and no new K/D tracking.
• Player kills: player vs player kills. Kills, deaths and K/D are still counted when this is off, so the Leaderboard keeps working.
• Scientist kills: shows both players dropping scientists and scientists dropping players. Killing a scientist never counts as a PvP kill.
• Entity kills: when a vehicle, trap, drowned, bleeding or suicide kills a player, for example getting hit by a minicopter. These never add kills, deaths or K/D.
• Animal kills: when an animal kills a player. Players killing animals are never shown.
• Fall deaths: when a player dies from falling.

Each death type has a badge showing where it goes right now: In game + Discord, In game only, Discord only or Off.

05Posting in Discord

The killfeed can post every kill in a channel in your Discord. This needs a linked Discord server with the Surge bot in it. Without one the channel dropdown stays locked and nothing is posted.

1. 1Link this server from Discord Integration > Overview if you haven't yet, and add the bot.
2. 2Open Features > Killfeed. At the top of Killfeed Settings, choose a channel in Select a Discord channel. It saves straight away.
3. 3Under each death type, pick what goes to Discord (see below).
4. 4Open the Discord Messages tab, pick a message, and design it. The live preview shows exactly how it will look.
5. 5Press Send test to post it once in your channel, then Save Discord messages.

Every death type gets one Discord switch, and it changes depending on its in-game toggle:

• In game ON → Also post in Discord: on by default. The kill shows in game and in your Discord channel. Turn it off to keep that type in game only.
• In game OFF → Display in Discord only: off by default. Turn it on to hide that type in game but still post it in Discord. Handy for spammy types like fall deaths.

Each of the six messages (Player vs Player, Player vs Scientist, Scientist vs Player, Entity vs Player, Animal vs Player and Fall death) has its own Discord message. You can write text above it and build a full embed with a colour, author, title, main text, fields, images and a footer with the time. Use default design brings back our starter look.

Each message shows the variables it can use, and clicking one adds it where your cursor is:

• Player vs Player: {killer}, {victim}, {totalkills}, {totaldeaths}, {kd}, {streak}, {distance} and {server}.
• Player vs Scientist: {killer} and {server}.
• Scientist vs Player and Fall death: {victim} and {server}.
• Entity vs Player: {entityname}, {victim} and {server}.
• Animal vs Player: {animalname}, {victim} and {server}.
• {playername} also works everywhere, just like the in-game messages.

Grouped posts. Every kill waits 20 seconds. Everything that happens in that window is posted together as one message, so the channel does not fill up one kill at a time. If a busy window is too big for a single Discord message, it is split over as few messages as possible, in the order the kills happened.

06Personalizing messages

Each death type has its own message box with a live preview underneath, so you can see roughly how it'll look in chat before saving. You can use Rust rich text like <b>, <size=35>, <color=#39FF14> and <br> for a new line.

These placeholders get swapped for real values when the message is sent:

• {playername}: the player involved. In the PvP message the first {playername} is the killer and the second is the victim.
• {killer} and {victim}: named versions, handy if you want the victim first.
• {entityname}: the vehicle or entity that did the killing, cleaned up (for example Minicopter).
• {animalname}: the animal that did the killing (for example Bear).
• {Totalkills} (or {totalkills}), {totaldeaths} and {kd}: the killer's PvP stats after this kill.
• {streak}: the killer's current streak, kills in a row without dying.
• {distance}: how far apart the two players were, in metres, like 250m.

07How kills and K/D are counted

• Only player kills a player changes stats: +1 kill for the killer, +1 death for the victim.
• Dying to a scientist, an animal, a vehicle or a fall doesn't add a death. K/D is purely PvP.
• K/D is kills divided by deaths, shown with two decimals. A player with no deaths yet shows their kill count as their K/D.
• A streak resets to 0 on any death, including falls, NPCs and suicides.
• Distance is worked out for every player versus player kill, whether or not that player has linked their Surge account. It only exists on PvP kills. Scientists, animals, vehicles and falls have no distance.
• If Surge does not have a position for both players, {distance} shows ?m instead of a number.

08Good to know

• Turning Killfeed off also stops K/D tracking, so the Leaderboard won't grow while it's off. Economy kill rewards and Challenges keep working either way.
• A player whose name is only numbers can be mistaken for a scientist and won't collect stats.
• If your Dynamic Map is on, the deaths Killfeed picks up are also marked on the map, even the types you've hidden from chat.
• On a very busy server, a message can land a second or two after the kill. Discord posts can lag a little more during big fights, because Discord limits how fast a bot can post.