Modbot Docs
Discord

Account links

See what share of your VRChat group and Discord server has linked a VRChat account to a Discord one, and send members who have not linked a slow, one-time reminder with the link page.

Account linking only helps for the people who have done it. The Discord page's Account links tab shows how many have, and lets staff send the rest one reminder. Discord stays lit in the sidebar while it is open. The command palette finds it as Discord account links. Its address is /discord/account-links.

Seeing the tab needs See analytics. Starting and stopping the reminder needs Change settings. The tab shows counts only; it never names anyone.

The two numbers

NumberCounts
Group members with a linked Discord accountThe people in your VRChat group now, and how many of them have a Discord account linked.
Discord members with a linked VRChat accountThe people in your Discord server now, and how many of them have a VRChat account linked. Bots are not counted.

Each shows a percentage and "N of M". A link that has been ended with Unlink does not count.

The tab says Account linking is not set up. until the OAuth client, its secret and the public address are saved. See Account linking.

The Link reminder panel sends each Discord member who has not linked one direct message with a Link VRChat account button that opens your link page. It reads: "Link your VRChat account to" your server's name "with the button below."

Press Start reminder to begin and Stop reminder to stop it. The panel shows:

RowMeaning
Would be sent / Left to sendHow many members it would reach now, or how many are left of those it began with.
Sent, everMembers it has been sent to.
Not reached, everMembers Discord would not let it reach, because their direct messages are closed or the account is gone.
Not confirmed, everMembers whose message may or may not have arrived: Discord timed out or failed on its side, or Modbot stopped before it heard back.
Last sentWhen the latest message went out.

How it behaves:

  • Slow on purpose. One message goes out every 30 seconds, because a burst of direct messages from a bot is what Discord punishes. A server with 3,000 members to remind takes about a day. The pace is kept from the last reminder, so restarting Modbot does not send one at once.
  • Once per person, ever. Modbot keeps a note for each member it has reminded, or tried to. Stopping and starting again, or starting it again next year, never sends the same person a second reminder. A member whose direct messages are closed is marked Not reached and is not tried again.
  • Only people already in the server when you press Start. Anyone who joins later is asked by the join prompt or the welcome button instead.
  • Not for the linked, bots or people who left. A member who unlinked since is reminded once like anyone else.
  • Never sent again, whatever happened. If Discord times out or fails on its side, the message may already have arrived, so the member is counted under Not confirmed and is not tried again. A missed reminder is better than a second one.
  • It stops by itself when everyone has been dealt with. It also stops, at once, if Discord asks the bot to slow down: the tab says The reminder stopped with Discord's words, the member it was about to message is counted under Not reached and is not tried again, and nothing goes out until you press Start reminder again. After that, nothing goes out until 10 minutes have passed since that message, even if you start it at once, so it does not run into the same wait.
  • Start is refused when linking is not set up, no Discord server is saved, or nobody is waiting.

Each message is recorded as Asked to link on Discord, and starting or stopping the reminder is in the audit log as a settings change.

The bot needs the Server Members Intent to know who is in the server (see Intents the bot asks for).

The welcome button

On Settings → Discord, the Welcome steps card has a switch, Add a Link your VRChat button. It is off until you turn it on. When it is on, the welcome message gets one more button, Link your VRChat, after the step buttons, for a member who has not linked. It goes with the direct message and with the channel post. Nothing is added when linking is not set up or the member has already linked.

What it replaces

If you ran a separate VRChat Linking bot, Modbot covers the same ground: a link page where members sign in with Discord and prove their VRChat account with a code in their bio, a linked role and an 18+ role, the /link command, a join prompt with a backup channel, and the share numbers and one-time reminder on this page.

What Modbot keeps

For each member reminded, one row: their Discord id, whether the message was sent or could not reach them, when, and, if it failed, Discord's reason as a sentence. It is kept so nobody is reminded twice. A purge deletes it, and no retention window touches it. See Privacy. Nothing is sent to Modbot Cloud.

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.

On this page