Setting Up Custom Roles and Permissions on Your Enshrouded Server

Learn how to add custom roles, groups, and permissions such as Admin, VIP, and Friends on your Enshrouded dedicated server.

In this guide, you will learn how to set up custom permissions and groups for your Enshrouded server. This is designed for advanced users who need granular control over their server.

⚠️ Warning: If you only need to add admins to your server, the XGamingServer game panel handles that for you. See our admin guide instead.

Configuring Custom Roles

Open Your Server Files

Log in to the XGamingServer Panel and select your Enshrouded server. Go to Files and open the file enshrouded_server.json.

Edit the User Groups

Under the userGroups section, add the roles you require. There are some groups added already by the panel, such as the Admin and Everyone group.

Save and Restart

Save the file and restart your server.

Example Configuration

Here is an example of how your userGroups section should look with multiple roles:

{
    "name": "Enshrouded Server",
    "ip": "0.0.0.0",
    "userGroups": [
        {
            "name": "Admin",
            "password": "Randomized password 01",
            "canKickBan": true,
            "canAccessInventories": true,
            "canEditBase": true,
            "canExtendBase": true,
            "reservedSlots": 1
        },
        {
            "name": "Friend",
            "password": "Randomized password 02",
            "canKickBan": false,
            "canAccessInventories": true,
            "canEditBase": true,
            "canExtendBase": true,
            "reservedSlots": 3
        },
        {
            "name": "Everyone",
            "password": "Randomized password 03",
            "canKickBan": false,
            "canAccessInventories": false,
            "canEditBase": false,
            "canExtendBase": false,
            "reservedSlots": 0
        }
    ]
}

⚠️ Warning: Passwords must be unique for each group; otherwise, your server will crash when it starts up.

💡 Tip: If you want to delete the Admin group created by the panel, go to Startup and clear the Admin Password field.

Permissions Reference

Permission	Description
`canKickBan`	Allows kicking and banning other players.
`canAccessInventories`	Allows accessing chests and other containers.
`canEditBase`	Allows making changes to player bases.
`canExtendBase`	Allows extending player bases.
`reservedSlots`	Reserves slots for the specified user group, ensuring they can join even if the server is full.