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
| Number | Counts |
|---|---|
| Group members with a linked Discord account | The people in your VRChat group now, and how many of them have a Discord account linked. |
| Discord members with a linked VRChat account | The 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
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:
| Row | Meaning |
|---|---|
| Would be sent / Left to send | How many members it would reach now, or how many are left of those it began with. |
| Sent, ever | Members it has been sent to. |
| Not reached, ever | Members Discord would not let it reach, because their direct messages are closed or the account is gone. |
| Not confirmed, ever | Members whose message may or may not have arrived: Discord timed out or failed on its side, or Modbot stopped before it heard back. |
| Last sent | When 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.
Invites
See which invite each new Discord member used, name your invites (Linktree, a partner's link), see joins per source over time, and have Modbot make an invite for each name on a list.
Server snapshots
Save your Discord server's roles, channels and permissions on a schedule or by hand, see what changed between two snapshots, download one as a file, and put one role's or one channel's permissions back.