On an Enshrouded server, players belong to groups. Each group has its own password and its own rights, like opening chests or banning players. The password a player types when they join decides their group, so you control who can do what by who gets which password.
The groups live in enshrouded_server.json under userGroups. You can change passwords in Settings, and edit groups in Files.
The default groups
A new server starts with four groups. Every group can explore, fight, loot, gather and do quests. The differences are about bases, chests and the world.
| Right | Admin | Friend | Guest | Visitor |
|---|---|---|---|---|
| Kick and ban players | Yes | No | No | No |
| Open chests and other containers | Yes | Yes | No | No |
| Change the world outside bases | Yes | Yes | Yes | No |
| Build and dig inside bases | Yes | Yes | No | No |
| Place, upgrade and remove Flame Altars | Yes | No | No | No |
Each group starts with a random password, so nobody gets in until you share one. On Wilderack you see and change them in Settings.
What each permission means
Every group in userGroups has these keys:
| Key | What it allows |
|---|---|
name |
The group’s name. When someone joins, admins see it in chat next to their name. |
password |
The password that puts a player in this group. Every group needs its own. |
canKickBan |
Kick players, and ban them so they can’t come back. |
canAccessInventories |
Use chests and other containers. |
canEditWorld |
Dig, build and change things in the open world outside bases. This includes moving water outside bases. |
canEditBase |
Add and remove blocks and props, and dig, inside bases. |
canExtendBase |
Place, upgrade and remove Flame Altars. |
reservedSlots |
How many player slots are kept free for this group. See below. |
All the can... keys take true or false.
What the file looks like
This is the Friend group from a new server, with its own password:
{
"name": "Friend",
"password": "pick-a-strong-one",
"canKickBan": false,
"canAccessInventories": true,
"canEditWorld": true,
"canEditBase": true,
"canExtendBase": false,
"reservedSlots": 0
}The groups sit together inside "userGroups": [ ... ], separated by commas.
Make your own group
Say you want builders who can work on bases, but can’t take things from chests:
- Stop the server.
- In Files, open
enshrouded_server.json. - Inside
"userGroups", copy the Friend group and paste it after the last group. Put a comma between the two. - Change the copy’s
nameto"Builder"and give it a newpassword. - Set
canAccessInventoriestofalse. - Save. The editor checks the JSON and warns you if a comma or bracket is missing.
- Start the server, and give your builders the new password.
You can delete groups you don’t use, like Visitor. Keep at least one group with canKickBan set to true, so somebody can deal with trouble.
Reserved slots
reservedSlots keeps slots free for a group. Your server has up to 16 slots in total (slotCount).
For example, with "reservedSlots": 2 on Admin, the server counts as full for everyone else when only 2 slots are left. Admins can still get in when guests have filled it up.
Keep the total of all reserved slots below your slotCount, or other groups may never find a free slot.
Changing someone’s group
On a dedicated server, a player’s rights come from the password they joined with. You can’t promote or demote them while they play.
To move a player to another group, give them that group’s password. They leave and join again with it. To take rights away from a whole group, change its password in Settings and restart, then share the new one only with the players who should keep those rights.
Kick and ban
Players in a group with canKickBan can remove players in game, from the social menu:
- Kick removes a player. They can join again.
- Ban removes them and adds them to the ban list, so the server turns them away from then on. Admins can view the ban list and unban players in the same place.
The ban list is saved in enshrouded_server.json. If you ever edit it by hand, stop the server first.
The old single password
Before Keen Games added groups, a server had one password at the top of the file. That line isn’t used for joining any more. If an old file still has it, Enshrouded makes a group called default with that password and the same rights as Friend. Move to proper groups when you can, so you can give guests fewer rights.
A group with an empty password lets anyone who finds your server join with that group’s rights. Always set a password for every group you keep.
Wilderack roles are different
The Friends tab in the panel has its own roles: Co-owner, Admin, Moderator, Builder and Viewer. Those decide who can start the server, change settings or restore backups in the panel. They don’t change anything inside the game. A friend can be a panel Admin and still join the game as a Guest.
Questions
How do roles work on an Enshrouded server?
Each group in enshrouded_server.json has a name, a password and a set of rights. The password a player types when they join puts them in that group. Give each friend the password for the group they should be in.
Can I promote a player while they're on my Enshrouded server?
Not on a dedicated server. A player's group comes from the password they joined with. To move someone, give them another group's password and have them rejoin. Promoting in game only works when a player hosts from their own PC.
How do I stop people from opening chests on my Enshrouded server?
Give them the password of a group where canAccessInventories is false, such as Guest or Visitor. Only groups with that right can use chests and other containers.
What does canExtendBase do in Enshrouded?
It decides who can place, upgrade and remove Flame Altars, which set where bases are. In the default groups only Admin has it, so friends can build but can't move or remove your altars.
Sources we checked
- Server Roles ConfigurationKeen Games
- Server Gameplay Settings (default config)Keen Games
- Enshrouded 1.0 changelogKeen Games on Steam
