Custom Auth Roles

Sync linked players' VIP, Moderator, Admin, or Owner access. Each group can use game auth to assign Discord roles, or use independently assigned Discord roles to grant game access.

Open your game server in the dashboard, then choose Overview → Custom Auth Roles → Configure.

Requirements

• You are the Discord server owner or have Administrator. Manage Server alone is not enough.
• The selected game server has Premium.
• Players have linked their accounts in this Discord community.
• Helios has Manage Roles, with its highest role above the roles it will assign.

Choose ordinary, dedicated roles. Roles managed by Discord or an integration, roles at or above Helios, and roles with Administrator, Manage Server, Manage Roles, or Manage Webhooks cannot be selected.

An in-game Admin or Owner label must not automatically grant control over your Discord server.

Set the matching roles

1. Open Configure and review Enable automatic role syncing.
2. Choose Choose Roles beside the auth level you want to configure.
3. Search for and select up to 10 roles for that level.
4. Choose Back to review another level.
5. Check the overall choices and choose Save Settings.

Existing Helios Bot Testing settings, closed without saving. No role or in-game auth level was changed.

Selections are for the player's exact auth level. An in-game Admin uses the Admin mapping; they do not automatically receive every role selected under VIP and Moderator.

The mappings belong to the selected game server. If multiple connected servers require the same Discord role, Helios considers those requirements together before removing a role it added.

Grant in-game access from Discord

Inside VIP → Choose Roles, there is a separate switch:

Grant in-game VIP from these Discord roles

Newly selecting the first VIP role enables this by default. Existing saved one-way mappings keep their direction: enable this switch explicitly if you want them to grant game VIP.

Linked players with an independently assigned matching role receive VIP through background checks, without needing to rejoin. Removing that role removes VIP granted and verified by this sync. In this direction, game auth does not recreate a removed Discord role. Roles this auth-sync feature assigned cannot promote themselves.

Moderator, Admin, and Owner promotion are off by default. Each has a separate Grant in-game… switch inside its role picker. If multiple opted-in groups match, the highest tier wins. Use dedicated access roles, never a general linked-player role.

Existing manual/store ranks are not adopted or overwritten. Only a tier this sync granted and verified may be removed. Previously granted VIP from the old join-only restoration feature remains unmanaged. Turning a direction off stops game changes rather than removing existing ranks.

Your store must remove its Discord entitlement when access expires. For immediate revocation, also use the game's admin controls. Removing a link or losing Premium is not automatic game-rank revocation.

Saving and timing

Changes are saved with Save Settings and applied by background checks. Discord role events, new links and settings changes queue checks. Allow several minutes; queues and connection problems can add delay. A saved message is not proof that game access changed immediately. Commands are verified with a fresh game-server read.

A failed or unavailable game-server check is not treated as proof that a player lost auth. Do not promise instant role removal during an outage.

For matching-role cleanup, Helios removes roles it added itself. It does not take ownership of every role already assigned by an admin or another system. Use dedicated roles to make the behavior easier to follow.

Turning syncing off stops the mapping being used and can lead to removal of roles Helios owns. Do not use it as a promise to freeze all existing role assignments.

If settings or roles do not update

• Administrator required: ask the Discord owner or an Administrator to configure it.
• Role not listed: check its position, integration-managed status, and permissions.
• Missing player role: confirm the player's link, actual in-game auth level, and selected game server.
• Settings changed elsewhere: close and reopen the panel before saving again.
• Roles syncing: wait, reopen if needed, and retry the save.
• Connection unavailable: restore the game-server connection, then allow background checks to run.

Check the actual member and game auth before repeating actions. See Link Roles, Staff Permissions, and Premium Battle Pass Role for the other role systems.