Save precious time by letting WoT Connect manage member nicknames and roles on your server!

1. Invite the bot to your server with the necessary permissions by moving its role to the top
2. Link a role by clicking on Links in that role’s settings
3. Allow your members to authenticate using the /connect command
4. Manage nicknames using the /manage_nicknames command
5. Manage roles using the /link_role command
6. Let the bot handle member updates automatically

Check out the guide below or join our server to learn more!

Invite the Bot

Click on Add App, select your server, and add the bot with the Manage Roles and Manage Nicknames permissions.

To be able to change a member’s nickname or role, the bot must have a higher role. Move the WoT Connect role above others to ensure this.

Linked Roles

Linked roles are a Discord feature that allows server members to obtain roles and showcase their stats.

Creation

In a role’s settings, go to Links, click on Add a requirement, and select "WoT Connect".

Then, specify the requirements that members must meet to obtain the role.

You can then add this role to a channel’s permission list so that it appears next to the nicknames of members who have it.

Obtaining

A member can access linked roles from the server banner.

They can also access it by clicking on the linked role displayed next to a member’s nickname in a text channel.

Once a member has obtained a linked role on your server, their stats will be displayed on their member profile.

Connection

There are several ways to connect a server member to their in-game account.

Button Authentication (Recommended)

Use the /connect command in a welcome channel to generate buttons that allow users to authenticate or disconnect.

Command Authentication

Members can use the /authentify command to authenticate and the /disconnect command to disconnect.

Manual Connection

You can connect a member using the /connect_member command or disconnect them using the /disconnect_member command.

Automatic Connection

If server members' nicknames exactly match their in-game nickname (with their clan tag in brackets, if applicable), you can use the /auto_connect_members command to automatically connect all unconnected members.

Nicknames

Use the /manage_nicknames command to choose how a member's nickname is displayed based on their connection and clan membership status. Each option is optional—the bot will only change members' nicknames for the specified options. If an option is set but left empty, the nickname will be removed when that condition applies. You can include dynamic properties in the options.

Not Connected

Nickname of a member who has not connected their account.

Property	Description	Key
Username	The member's username	username

For example, if the format entered is username *, then the nickname of the unconnected member "Username" will be "Username *".

Not in a Clan

Nickname of a connected member who is not part of any clan.

Property	Description	Key
Username	The member's username	username
Region	The region the member is connected to	region
Nickname	The player's in-game nickname	nickname

For example, if the format entered is nickname REGION, then the nickname of the player "Player" in the European region will be "Player EU".

Clan Member

Nickname of a connected member who is part of a clan.

Property	Description	Key
Username	The member's username	username
Region	The region the member is connected to	region
Nickname	The player's in-game nickname	nickname
Tag	The member's clan tag	tag

For example, if the format entered is nickname [TAG] REGION, then the nickname of the player "Player" in the European region belonging to the clan "CLAN" will be "Player [CLAN] EU".

Clan Roles

Use the /link_role command and select the necessary requirements that members must meet to link a role.

Role	Description	Requirements
Connected	Connected members
Connected in {region}	Members connected in this region	region
Member of {clan}	Members of this clan	region + clan
{Position} in {clan}	Members of this clan with this position	region + clan + position
{Position}	Players with this position, regardless of clan or region	position
{Position} in {region}	Players with this position in this region, regardless of clan	region + position

For example, to grant a role to all members of the "CLAN" clan in the EU region, select the "Europe" region, search for and select the "CLAN" clan, but do not select a position.

To list all linked roles, use the /linked_roles command, and to unlink a role, use the /unlink_role command.

Member Updates

The bot regularly updates server members’ roles and nicknames. You can update a member using the Update command directly on their profile, or update all members using the /update_members command.