The bot works by taking your VRChat User ID (the end bit for your VRChat URL) and linking it to your Discord ID, which is an 18-digit code in our database.
The Process
When you run the /verify command, you are supplying your VRChat URL, and Discord provides us your Discord ID. We then take both of these and ensure that they’re not already in the database. If they are, the user is prevented from verifying. (This ensures that a user cannot double verify or verify multiple Discord accounts with one VRChat ID.) If they aren’t, the user can proceed to the next step.

How to Configure Your Server
If you’ve just added the bot to your server, follow these steps to ensure it works correctly:

Step 1:
Move the VRChat ID Linker role higher in your role hierarchy. Discord requires the bot’s role to be higher than the roles it manages. Ensure the bot's role is above the verified role to function properly. We also recommend you make a seperate role for VRChat ID Verified, in case you still wish to provide manual verification.

Step 2:
Ensure the bot has view/send message permissions in your "Log" channel. Without access, the bot won’t break but will fail to log activities like cross-verification or username updates.

Step 3:
Run the /register command to start your server configuration. This is admin only and can only be seen by admins, the bot will guide you through selecting:

- Your ID Verified role.
- Your Unverified role (if applicable).
- Your Log Channel.
- Options for Cross Verification and Auto Renaming.

Step 4:
Create a "command only" channel. Make sure it has a slow mode to discourage normal messages, as unverified users will have access to it. Also confirm that all users have the ability to send messages, disable emotes/reactions/threads etc, and importantly Use Application Commands near the bottom of the permissions list.

Once completed, run the /verify_channel command. This is admin only and can only be seen by admins, and it'll walk you through selecting which channel is your command only channel. This will then delete every message posted in this channel, so make sure you post a general message there first before enabling this!


Users will be given a 6-character code (which will look like this: {cOdE01}) to place at the start of their VRChat bio on a new line. This ensures the user has control over the requested account they're trying to link. If the user fails this process, they’ll be notified and can retry, in case they typed the code incorrectly or placed it in the wrong spot.

Note: All API calls have a 10-second buffer. In times of heavy use, users may time out. This buffer is necessary for account safety due to the nature of VRChat's API but may be reduced in the future.

Once verified, the bot performs the following actions:

- Assigns the ID Verified role.
- Removes the Unverified role. (if applicable)
- Renames the user to their VRChat display name (if enabled).
- Logs the verification in the Log channel (as defined in the server config).


VRChat ID Linker

VRChat ID Linker bot lets users link their Persona verified VRChat account to their Discord Account.

Voting for VRChat ID Linker