Auto Role
Automatically add Roles in Discord based on the in-game Roles, Leagues, Town Halls, etc.
Clan Roles
Roles will be given based on the in-game clan role. /autorole clan-roles is a single command with a named option for each role:
/autorole clan-roles clans: #CLAN_TAG leader_role: @role co_leader_role: @role elder_role: @role member_role: @role everyone_role: @role only_verified: True/False
Town Hall Roles
Roles will be given based on Town Hall levels.
/autorole town-hall [TH8_ROLE] [TH10_ROLE] [MORE...]
Builder Hall Roles
Roles will be given based on Builder Hall levels (BH1–BH10).
/autorole builder-hall [BH5_ROLE] [BH8_ROLE] [MORE...]
League Roles
Roles will be given based on the player's Home Village league.
/autorole leagues [CHAMPION_ROLE] [TITAN_ROLE] [LEGEND_ROLE]
Builder Base League Roles
Roles will be given based on the player's Builder Base league (Wood, Clay, Stone, Copper, Brass, Iron, Steel, Titanium, Platinum, Emerald, Ruby, Diamond).
/autorole builder-leagues [WOOD_ROLE] [IRON_ROLE] [DIAMOND_ROLE] [MORE...]
War Role
A role given to members who are currently in the war lineup for a specific clan.
/autorole wars clan: #CLAN_TAG role: [WAR_ROLE]
Each clan can have its own war role. The role is assigned when war starts and removed when it ends.
EOS Push Role
A role given to members who are participating in an End-of-Season push for selected clans.
/autorole eos-push role: [EOS_PUSH_ROLE] clans: #CLAN_TAG
Family Roles
/autorole family is a single command — set any combination of the named options below in one call.
/autorole family family_role: @role exclusive_family_role: @role guest_role: @role verified_role: @role account_linked_role: @role family_leaders_role: @role
family_role
Any of their linked accounts is in the family
exclusive_family_role
All of their linked accounts are in the family
guest_role
None of their accounts are in the family
verified_role
They verified an account with the /verify command
account_linked_role
They have at least one linked account
family_leaders_role
They are a Leader or Co-Leader of a family clan (supports selecting multiple roles)
List Configured Roles
View all roles currently configured in the server.
/autorole list
Refresh Roles
Manually trigger a role refresh for all members.
/autorole refresh
Disable a Role Type
Remove the configuration for a specific role type without affecting other settings.
/autorole disable type: town-hall
Additional Settings
If people temporarily leave their home clans for any reason, they lose their roles. To address this issue, a role removal delay can be enabled.\ Their roles will not be removed immediately but will remain for a specified period.\ However, if they do not return within this time frame, their roles will be removed.
/autorole config role_removal_delays: Off/Duration
A delay can be set before roles are added to new members. Useful if you want to verify a member has settled in before granting roles.
/autorole config role_addition_delays: Off/Duration
Certain role types can be excluded from the removal delay — for example, guest roles or league roles can still be removed instantly even when a global delay is active.
/autorole config delay_exclusion_roles: town-hall-roles / league-roles / guest-role / ...
Token verification can be enabled to ensure that only legitimate users receive Clan Roles\ Verification is performed using the /verify command with an in-game API token.
/autorole config verified_only_clan_roles: Yes/No
By default, members without a linked account are skipped. Enable this to still assign applicable roles to unlinked members.
/autorole config allow_not_linked: Yes/No
Auto Role updates roles whenever changes are detected in the game. This behavior can be disabled for manual control using the /autorole refresh command.
/autorole config auto_update_roles: Yes/No
When enabled, every role refresh cycle re-evaluates all members regardless of whether changes were detected. Useful for servers where role drift occurs.
/autorole config always_force_refresh_roles: Yes/No
Last updated
Was this helpful?