Skip to content

Roles ​

Utopia Server Panel uses a role-based three-level permission model. Every panel account belongs to a role, while unauthenticated visitors use the built-in guest role for permission checks.

Roles

Permission Levels ​

Every module permission in the system supports the following three levels:

LevelNameMeaning
0denyAccess to the corresponding API endpoints and pages is blocked, and sidebar entries are hidden
1readonlyAllows viewing pages and real-time data without write, edit, or control actions
2fullGrants full view and management access for the module

Permission Modules ​

The system includes 9 built-in permission keys:

KeyModuleRead-Only ScopeFull Scope
dashboardDashboardView live server status, TPS, MSPT, and system resourcesSame as read-only
terminalConsoleStream live server console logs and view command historyExecute commands in the server console
logsMonitoring LogsQuery historical performance logs, player events, and server lifecycle recordsSame as read-only
mapWeb MinimapView enabled map layers and markers allowed for read-only usersCreate or delete personal waypoints and use advanced features such as teleportation
profilerPerformance ProfilerInspect top tick-time chunk and dimension hotspot statisticsTeleport in-game to hotspot coordinates
mods_configMods & Server ConfigBrowse installed mods and view mod configs and server.properties in read-only modeEdit and save mod configs, update server.properties, and trigger server restarts
whitelist_applyWhitelist ApplicationVisit the public whitelist application page and check statusSubmit whitelist applications
whitelist_manageWhitelist ManagementView the application queue and current server whitelist entriesReview applications and manually add or remove whitelist entries
adminAdministrationView users, roles, system settings, and database overviewCreate or edit users and roles, modify system settings, and clear map cache

Built-in System Roles ​

After initialization, the database seeds three built-in roles:

Role IDNameDescriptionDefault Permissions
1adminAdministratorImmutable and cannot be deleted; all permissions are fixed at 2
2guestGuestControls visibility for unauthenticated visitors; defaults to dashboard and map at 1, whitelist_apply at 2, others 0
3userMemberDefault role for newly registered accounts; defaults to dashboard, logs, and map at 1, whitelist_apply at 2, others 0

Administrators can create custom roles tailored to server operations, such as a moderator role with whitelist_manage and terminal access. If any users are still assigned to a custom role, the system prevents deleting that role until those users are reassigned.

  • Under System Settings -> Panel Settings -> Registration & Binding, you can configure defaultRegisterRoleId to control which role newly registered users receive.
  • Under System Settings -> In-Game Integration -> Whitelist, toggling Allow Guest Whitelist Applications automatically updates the whitelist_apply level on the guest role.
  • Fine-grained minimap layer visibility can be configured per capability under System Settings -> Panel Features -> Web Map, as described in Web Minimap.