Role Lists

01What it does

Role Lists is where you decide who gets access to the stuff you don't want open to everyone. Maybe Zorps are a VIP perk, or there's a kit only for your boosters, or the attack heli ride is staff only. You set the item up as list-only in its own system, then add the right players here.

There are nine lists: the Master List, VIP List, Discord Tag List, Zorp List, Auto Kits List, Book A Ride List, Store VIP, Home Teleports List and Recycler List.

02Master List

The Master List sits above the other role lists. Anyone on it counts as being on those lists, so they can claim everything from them without you adding them anywhere else. Adding someone also puts them on the VIP list and sets their in-game auth to VIP, the same way Player List does. They can be on the VIP list by themselves as well.

• It's always on. There's no switch.
• Members can create Zorps while the Zorp List is on, claim every list-only kit, book every list-only ride, open every list-only store category, spawn a recycler while the Recycler List is on, use Home Teleports when it's list only, and they are added to the VIP list.
• Removing someone from the Master List takes them off the VIP list only if the Master List was the reason they were on it. A player you added to the VIP list yourself stays there.
• List-only kits still need the Auto Kits List switched on to be locked. While it's off, everyone can claim them anyway.
• Pick a linked player from the search box or type an in-game name, then click Add to List. Click a member to remove them.

03The overview page

When you open Role Lists you first see an overview, so you can check everything at a glance:

• Totals at the top: how many lists there are, how many are switched on and how many players you've added across all of them.
• How it works in three steps: pick what to lock, switch the list on, add players.
• A card for each list showing what it controls, whether it's On, Off or Always on, how many players are on it, and what that means right now. For example, the Auto Kits card tells you how many list-only kits you have and whether they're locked.

Click a card to manage that list. Inside, you can see exactly which kits or rides are list only, and an Open button takes you straight to the system where you set them up.

04Zorp List

Off by default. When you turn it ON, only players on the list can create new Zorps. Everyone else who tries simply gets ignored, there's no message telling them why.

• Existing Zorps are never touched. Turning the list on doesn't remove anyone's zone.
• The add box and the member list only appear once the list is switched on.
• To remove someone, click their name and hit Delete from list.

05VIP List

The VIP list is always on. In AutoKits, open a kit and choose VIP list. You can do that for every kit you have. Free servers still stop at 3 kit binds, and Premium at 16. Choosing VIP list does not add an extra kit past that limit. If the kit was open to everyone, it stops being free. If it was on the Auto Kits list, that list comes off and the VIP list is its list.

• Add a player with their exact in-game name. Surge sets their in-game auth to VIP the same way Player List does, even if they are offline. If the server is disconnected, it retries.
• Remove them and Surge sets them back to User in game.
• If they are already VIP in game, they can claim VIP kits straight away. When they are not on this list yet, Surge adds them as soon as their Discord is linked to that in-game name.
• If they lose VIP in game, they come off this list. If you take them off this list, they become a User in game.
• Players you add by hand stay until you remove them, unless they lose VIP in game. A store subscription cannot take a hand-added player off by itself.
• Players on the Master List are on this list too, and get VIP in game when they are added there.
• A player can be on this list and on any other role list at the same time.
• VIP kits can be claimed by anyone on this list, and by anyone whose in-game auth is already VIP even if they have not linked yet.

06Discord Tag List

Premium only. This list watches the Discord linked to the server. If that Discord has a Server Tag that people can adopt, the list can turn on by itself. If there is no tag, it stays off and tells you to create one in Discord to unlock it.

If your Discord already has a Server Tag, this list is already on. You only need to bind a kit to it. In AutoKits, open a kit and choose Discord Tag List. That kit is then only for people currently showing this Discord’s tag, plus anyone on the Master List. You can switch the list off even when a tag exists.

• When someone adopts the tag, they join this list. When they remove it, they leave.
• If they have the tag but have not linked their in-game name yet, Surge remembers them and adds them the moment they link.
• The people on the list are filled in for you. You do not add names by hand.
• If the Discord loses its Server Tag, the list turns off until a tag exists again.

07Auto Kits List

This one works together with AutoKits. First, mark a kit as List only in AutoKits. Then come here, turn the Auto Kits List ON and add players.

1. 1Each list-only kit is a card, named like Boom Kit List. The cards sit two across.
2. 2Click a card, type the player's exact in-game name, and add them. They can claim that kit only.
3. 3Open another card if they should have that kit too. Click a player on the open card to take them off it. There is no switch that gives every list kit at once.

• Free kits (ones not marked list-only) stay open to everyone, list or no list.
• If a player who isn't on the list tries to claim a list-only kit, nothing happens.
• Click a player on the open kit card to remove them from that kit.
• If you later switch a kit back from list-only to normal, it's automatically taken off everyone's list access.

08Book A Ride list

Same idea for Book A Ride. Turn on Use list for a transport (Horse, MiniCopter, Bike, Attack helicopter, Transport helicopter, RHIB or Premade Car) in Book A Ride, then add who's allowed to book it here.

1. 1Type the exact in-game name and click Add to List.
2. 2Tick which list-only transports they can book, or tick All transports.
3. 3Click Confirm add.

• Turning on Use list for any transport switches this list on for you automatically.
• A transport with Use list on is always restricted to members who have that transport assigned. Open transports stay available to everyone.
• If you turn Use list off for a transport, it's removed from everyone's assignments.

09Store VIP

Store VIP is one Role List a currency Shop category can lock to. In Economy → Shop, turn on Make this a list only category? and pick Shop VIP, or any other Role List — including a kit list under AutoKits. Everyone still sees that category, but it stays locked unless the player is on the list you picked. Master List still opens every list-only category.

There's no on/off switch for this one. It's always active for any category marked list-only.

1. 1Click the search box. It shows players who've linked their in-game name on Surge for this server.
2. 2Type to filter, then pick a name (or type one in yourself).
3. 3Click Add to List. Players already on the list are tagged On list in the suggestions.

10Home Teleports List

This list decides who can use Home Teleports when you turn on Make it list only in Features > Home Teleports. While list only is off, every linked player can use it and this list does nothing.

• Players not on the list see a locked message on their My Home Teleport page, and the Come In emote tells them it's for list members only.
• Master List members can always use it.
• Taking someone off the list doesn't delete their saved home. They just can't use it until they're added back.

11Recycler List

This list is a free feature. Turn it on, add players, or sell it in the webstore. Players on it (and the Master List) get My Recycler on the player dashboard. They can spawn one recycler at their location with entity.spawn recycler_static. They cannot move or replace it. An admin can Clear Recycle use from Player List. Server Wipe has Reset player recycler uses so everyone can place again after the map wipe.