AutoKits

01What it does

AutoKits connects the kits that already exist on your server to the quick chat wheel. Each connection is called a bind: one kit, one emote, one cooldown. When a player uses that emote, the kit goes straight into their inventory and the timer starts.

It doesn't create kits by itself. Your server needs a kit plugin with kits on it. You can make those with Kit Builder (it's on the Kit Builder tab here) or use kits you already have.

02How players use it

1. 1Open the quick chat wheel in game.
2. 2Pick the emote that's bound to the kit, for example I need Wood. Local, team and global chat all work.
3. 3The kit lands in their inventory and the Kit Claimed message is posted in chat.

If the kit is still on cooldown, they get the Kit Timer message telling them how long is left. To stop chat spam, a player only gets that reminder once a minute per kit, so mashing the emote won't flood chat.

Linked players can also claim kits from the player dashboard on the website, where they can see their timers counting down. They still need to be online in game for the kit to be given. My Info on that same dashboard lists every kit they currently have on that server, and whether they are an active player there from the playtime stored for that server.

03Setting it up

1. 1Open Features > AutoKits and switch Auto Kits ON. Surge then loads your server's kit list and keeps it up to date. Use Refresh Kits if you've just added one and want it to show up straight away.
2. 2Click Add Kit to open the wizard.
3. 3Kit: pick a kit from your server's list.
4. 4Nickname: the friendly name players see in messages and on the dashboard, up to 120 characters (for example "Vip Kit").
5. 5Timer: how long before the same player can claim it again, in minutes, hours or days. Default is 60 minutes. 0 means no cooldown.
6. 6Emote: which quick chat emote claims it. Each emote can only be used by one bind.
7. 7Who can claim it: Everyone, List only, VIP list, or Discord Tag List. Discord Tag List is Premium and is for people showing this Discord’s Server Tag. You can put every kit you have on the VIP list. Free servers still stop at 3 binds, Premium at 16. A kit on the VIP list or Discord Tag List is no longer open to everyone, and its old Auto Kits list comes off.

Every bind shows up as a card. Click it to Turn On/Off, Edit or Delete it. Switching a bind off is a nice way to pause a kit without losing its setup. You can also post those installed kits into Discord from Discord Integration > Server to Discord > Kit Claims.

04Default Spawn Kit

Open AutoKits and choose the Default Spawn Kit tab. This gives a kit to players when they spawn, based on their auth group. It is separate from emote binds, so it does not use one of your Free or Premium bind slots.

• Kit: pick one from the kits already on your server. If a new kit is missing, press Refresh kits.
• Auth group: User, VIP, Moderator, Admin or Owner. A kit can be set for more than one group.
• Add spawn kit sends it to the server. It only counts once your server confirms the group was added.
• Remove takes that group off the kit. It only counts once your server confirms the group was removed. The list under the form shows the spawn kits Surge has set.
• If the server is offline, try again once it is back.

05Free and Premium

• Free: up to 3 binds, using I need Wood, I need Stone and I need water.
• Premium: up to 16 binds and every emote. That adds I need Metal Fragments, High Quality Metal, Scrap, Low Grade Fuel and Food, plus I have Hunting Bow, Pickaxe, Hatchet, High Quality Metal, Scrap, Low Grade Fuel, Food and Water. It also adds the I'm going for wheel: Water, Scrap, Metal Fragments, Medicine, Stone, Wood, Metal and Food. These are separate from I need and I have, so I'm going for Wood can be bound to a different kit than I need Wood.

06List-only kits

List-only kits are how you lock a kit to chosen players. Turn List only on for the bind, then go to Management > Role Lists and switch on the Auto Kits List. Each kit has its own list. Adding a player to one kit does not give them the others. Players on the Master List can claim every list-only kit. The VIP list can hold every kit you have, up to your AutoKit limit. Those kits are no longer open to everyone. Players on the VIP list are set to VIP in game the same way Player List does. Anyone who is already VIP in game can claim those kits, and once they link their Discord they are added to the list. If they lose VIP in game they come off the list. A player can be on the VIP list and any other list at the same time. Adding someone to the Master List puts them on the VIP list too. Buying a VIP kit in the real-money store adds the buyer to the VIP list. Buying a list-only kit adds them only to that kit's list.

• List-only only does anything while the Auto Kits List is switched on. If the list is off, list-only kits are open to everyone.
• Players who aren't allowed get nothing in game (no message), and the kit doesn't show for them on the dashboard.
• Kits without List only stay open to everyone either way.

07Messages

Change these on the Auto Kits Personalize tab. They're posted in server chat and support rich text.

• Kit Claimed: default is {playername} Redeemed {kitnickname}.
• Kit Timer: default is {playername} Please wait {cooldown} before claiming {kitnickname}.

Variables: {playername} is the player, {kitnickname} is the nickname you gave the bind, and {cooldown} is the time left, written like "10 min", "10 hrs" or "10 days".

08Timers and clean-up

The Autokit Timers tab is for when someone needs a do-over.

• Reset a player's timer: pick a linked player and one kit, or All Kits. All Kits only resets the kits that player is allowed to claim.
• Clear timers for everyone: wipes the timer on one kit, or on every kit, for every player (linked or not). Good after a wipe.

The Delete all In game kits button in the danger zone removes every kit from your game server and makes sure they're really gone. Any bind using a deleted kit is switched off. The bot has to be connected, and there's no undo.

09Good to know

• Cooldowns are per player and per bind. Two binds on the same kit have separate timers.
• A bind only works if its kit is still on the server's kit list. If you built the kit with Kit Builder, Install from My kits puts it back.
• Kit Builder's Install button drops you straight into this wizard with the kit and nickname already filled in.