Modbot Docs
Accounts and permissions

Staff accounts, invites and password resets

How to add your moderators, link their VRChat accounts, disable or delete them, and get them back in when they forget a password.

Modbot has its own accounts, separate from VRChat and Discord. Each person on your team signs in with their own password and either their username or their email address, so everything Modbot records says who did it. This page covers getting people in, keeping their accounts in order, and what each person can do with their own account.

What a person may do once they are in is decided by their roles. See Roles and permissions. To walk a new staff member through a trial with a buddy, see the New staff checklist.

The Users page

Open Settings, then the People and roles tab, then Users. You need the Manage users permission to see it, and that permission alone is enough to open Settings — you do not also need Change settings, and you will see only the tabs you may open.

It used to be in the sidebar

Users and Roles were sidebar pages until September 2026. The old addresses, /users and /roles, still open them, so an old link or bookmark still works.

The table lists every staff account with its Username, the linked VRChat account (or Not linked yet), its Roles, and its Last sign-in. Disabled accounts are greyed out and marked Disabled. Your own row says "you".

Click a row to open that person's panel, where you can change their roles, their contact details, make a password reset link, disable or enable the account, and delete it.

Everything an account did stays in Modbot for good, whether the account is disabled or deleted. Every action Modbot records points at the account that did it, and taking that away would break the record. Deleting an account empties it instead: the username, email, password, Discord account, VRChat link and roles all go, and the case files, notes and actions it is named on stay.

Adding somebody

Press Add someone. There are two ways, shown as two tabs.

  1. Choose Send them a link.
  2. Tick the roles the person should have.
  3. Press Make the link.
  4. Copy the link and send it to them on Discord, or however your team talks.

The person opens the link, sees who invited them and with which roles, and fills in their own Username, Email and Password on the Create your Modbot account page. When they press Create account they are signed in straight away and taken to link their VRChat account (see below).

They type their own email address; the invite does not carry one.

An invite link:

  • works once,
  • expires after 72 hours,
  • stops working if the account that made it is disabled before it is used,
  • is shown only once. Modbot keeps only a fingerprint of it, so it cannot show it to you again. If you lose it, make a new one.

Invite links that have not been used yet are listed under Invite links not used yet on the Users page, with who made each one, its roles and when it expires. Press Take back, then the red Take back that takes its place, to cancel one, or Cancel to back out.

This is the way to add people because nobody but the new moderator ever knows their password.

Set a temporary password

If the person is sitting next to you, choose Set a temporary password, type a Username, an Email and a Temporary password (at least 12 characters) twice, tick their roles and press Create the account. They can sign in right away.

Tell them the password in person and ask them to change it on their account page straight away. Until they do, two people know it, and Modbot cannot tell which of you did something. Modbot does not force the change.

Username, email and password rules

  • A username can only have letters, numbers and underscores in it, and can be up to 64 characters. Two usernames that differ only in upper and lower case count as the same name, so Gunner24 and gunner24 cannot both exist.
  • Accounts made before that rule may have other characters in their names. They keep working and keep signing in; the rule only applies when a username is set or changed.
  • An email address is required on every account. Two accounts cannot share one, and upper and lower case do not make two addresses different.
  • A password must be at least 12 characters.

You can only give what you have

The role list shows every role, but you can only tick roles whose permissions you hold yourself. The others are greyed out. This applies to invite links, temporary-password accounts and changing somebody's roles. It stops a person who manages users from making themselves, or a friend, an administrator. An administrator can give any role.

Linking a VRChat account (required)

Every account has to be linked to the VRChat account of the person behind it before it can use Modbot. This includes the first administrator, who does it during the setup wizard. The link is what lets Modbot connect "Alice in Modbot" with a real VRChat user.

Until the link is done, signing in takes the person to the Link your VRChat account page and nowhere else.

Open your profile

Press Open my VRChat profile. Your VRChat profile opens in a new tab.

Paste your user id or profile address

Copy your user id (it starts with usr_) or the address of the page, paste it into Your VRChat user id or profile address, and press Continue. Either is fine.

Put the code in your bio

Modbot shows a short code like modbot-7F3K9Q. Press Copy, paste it anywhere in your VRChat bio, and save your profile on the VRChat website.

Press Check

Back in Modbot, press Check. Modbot reads your VRChat profile and, if the code is in the bio, the link is confirmed. You can take the code out of your bio afterwards.

Things to know:

  • A code lasts 30 minutes and can be checked 6 times. You have to wait 10 seconds between checks. The page shows how many checks are left. If the code runs out, press Start over.
  • One VRChat account can be linked to only one Modbot account. If it is already linked to somebody else, Check says so.
  • Modbot reads the profile through its own VRChat account. If that account is not set up yet, or VRChat is rate limiting Modbot, Check tells you and nothing is retried. Try again later.
  • You can link a different VRChat account later from your account page. The new link replaces the old one and is recorded.

Only three things: see who it is signed in as, finish the link, and sign out. Every other part of Modbot refuses it, whatever roles it holds. The one exception is the first steps of the setup wizard for an account allowed to change settings, because the link cannot be checked until Modbot's own VRChat account is working.

Changing somebody's roles

Open the person on the Users page, tick or untick roles and press Save roles. The change takes effect on their very next click in Modbot, not the next time they sign in.

Disabling and enabling an account

In the person's panel, under Access:

  • Disable this account asks you to confirm, in red, before it acts. It then ends every session they have straight away and stops them signing in. Nothing they did is removed from history. Invite links they made stop working. You cannot disable your own account.
  • Enable this account lets them sign in again. Sessions that were open before they were disabled do not come back; they have to sign in fresh.

A disabled account also cannot use password reset links, and any Discord bot commands it tries are refused.

Deleting an account

Also under Access: Delete this account. Modbot asks you to type the account's username before the button will work.

Deleting cannot be undone. The account keeps its place in history and loses everything else:

  • its username becomes something like deleted_user_9fb1c47a,
  • its email address, password, Discord account, VRChat link and roles are cleared,
  • its availability, the weekly hours and time zone it saved, is deleted,
  • its new staff checklist, with the written answers, is deleted,
  • every session ends straight away and it can never sign in again,
  • the deletion is recorded in the audit log, naming who did it.

Everything the account did stays: its case files, notes, alerts, moderation actions and audit entries all still point at it, and the name it went by at the time still appears on them. Those records say what happened on the day, and Modbot does not rewrite them.

You cannot delete your own account, and you cannot delete the last enabled administrator.

The last administrator

Modbot will not let you disable or delete an account, or change its roles, if that would leave no enabled account that holds Administrator. You see "That would leave nobody who can administer Modbot." A deployment with no administrator has no way back except editing the database, so make sure a second person holds Administrator before you step away.

Anyone with Manage users can change, disable or delete accounts whose highest role is below their own, as long as one enabled administrator is left. An account at their rank or above, such as an administrator, can't be changed by them: they see "You can only change accounts below your highest role." Only an administrator can change an administrator. See the order of roles.

Email and Discord account

Every account has an Email address. You can set it for somebody under Contact details in their panel (then press Save contact details), and each person can set their own on their account page.

The email address is used for three things:

  • signing in — the sign-in box takes the address or the username,
  • sending a password reset link the person asked for (see below),
  • naming the person who runs this Modbot (see below).

A Discord account is optional, and only the person can add one, from their own account page: Connect with a code gives them a code to run as /verifyaccount in the Discord server, or Connect Discord signs them in to Discord. Either way Discord tells Modbot which account it is. It is used for recognising the person when they use the Modbot Discord bot's commands, for notifications by Discord message, and for a password reset link when the account has no email address. See Setting up the bot. Their panel shows it under Contact details, and nobody else can change it.

The email address of the oldest enabled administrator is also the contact address Modbot gives VRChat on every request, and the one shown as this server's owner. See Security and The server page.

If you are upgrading a Modbot from before email was required, accounts without an address keep working. Modbot asks for one on the account page. Where two accounts had the same address, the older one keeps it and the newer one is asked for its own.

Emails from the project

When somebody makes their account — the first administrator during setup, or anybody opening an invite link — the form offers one checkbox: Receive emails from Modbot about new features and updates. It starts unticked, and ticking it sends the address to Modbot Cloud, which is what sends the mail. To stop receiving them, use the unsubscribe link in one of them.

The checkbox is not shown at all on a Modbot that has Modbot Cloud switched off.

When somebody forgets their password

There are two ways. You only need one.

The sign-in page has Forgot password?. The person types their Username and presses Send me a link. Modbot sends a reset link:

  1. by email, if email is set up under Settings, Email and alerts, Email sending, and the account has an email address,
  2. otherwise by Discord direct message, if a Bot token is saved under Settings, Discord, and the account has a Discord account connected (see Email and Discord account).

The message names the account and says nothing has changed if they did not ask. The link lasts 24 hours.

For this to work, an administrator must have saved the Public address of your Modbot under Settings, Server. That is the address people type to reach it, and it is the only thing a sent link is ever built from. If no public address is saved, or neither email nor Discord is set up, the forgot-password page says so and sends nothing. Use the second way instead.

To stop this being used to find out which usernames exist, the page always gives the same answer, whether or not the username is real, disabled, or has no contact details. Behind that answer:

  • nothing is sent to a disabled account or one with no email and no Discord account,
  • a person can get at most one link every 10 minutes,
  • many requests from one address slow down, the same way failed sign-ins do.

Apart from a reset link they asked for, the only mail Modbot sends a person is the health alerts an administrator has ticked them for.

Open the person on the Users page and press Make a reset link under Password. Copy the link and send it to them yourself. It is shown once. This works even when email, Discord and the public address are not set up, but not for a disabled account (enable it first).

Either kind of link opens the Choose a new password page. The person types a New password twice. Using the link:

  • sets the new password,
  • ends every session the account had, everywhere,
  • uses the link up.

They then sign in with the new password. Making a new reset link for an account cancels any older unused ones.

The email limit

Modbot sends at most 100 emails per 24 hours. That is a rolling 24 hours, not a calendar day: each email frees its place again exactly 24 hours after it went, rather than the whole count resetting at midnight.

The last 20 places are reserved for email about an account, which today means reset links. Everything else, health alerts and the test email included, stops at 80. So a Modbot that has spent its whole allowance on alerts can still send a reset link to somebody locked out.

Nothing is ever thrown away when the limit is reached. The email is queued instead, and Modbot sends it when there is room again, checking every 30 seconds and putting account email first. A reset link that waits past its 24 hours is marked expired rather than sent dead, and an email the mail server refuses is retried 5 times with a growing wait before it is marked failed.

Where to see it and change it

Settings, Email and alerts, Email sending shows Sent in the last 24 hours against the limit, how many are Queued and Failed, when the next queued email goes, and a table of everything still waiting with its address, kind, state and, for a failure, what the mail server said.

Email limit per 24 hours on the same card changes the number. The lowest you can set is 20, and changing it is recorded in the audit log. Queued and failed email also raises the Email card on Health and can be alerted on.

Your own account

Press the button with your name at the top right of any page to open Your account. Anyone who is signed in can use it. It has these parts:

  • You: who you are signed in as and your roles.
  • Automatic roles: the automatic role rules that are for you, with a tick or a cross for each condition. It is there only when a rule is for you.
  • Change your username: type a New username and Your current password, then press Change username. The change is recorded with the old and new names.
  • Change your password: type your Current password and a New password twice, then press Change password. Every other session you have is signed out. The browser you did it in stays signed in.
  • How you can be reached: your Email, which you can sign in with and which a reset link is sent to. Press Save.
  • Your VRChat account: which VRChat account you are linked to, and Link a different account.
  • Your Discord account: Connect with a code shows a Code with Copy and the command to run in your Discord server, such as /verifyaccount K7P-42Q; New code replaces it. Connect Discord signs you in to Discord instead. Each is there when your server has it set up. Once connected, the card shows Connected as and your Discord name, with Disconnect to take it off. See Letting moderators use the commands.
  • Event invites: Get event invites, on for every account. While it is on, an event that names you as its host or staff sends you a VRChat invite or a Discord message when its instance opens; untick it and none are sent. See Inviting people.
  • my.modbot.co: Add to my.modbot.co.
  • Sign out everywhere: ends every session you have on every browser and machine, including this one.

The Sign out button at the top right ends only the session in the browser you are using.

Sessions

The sign-in page has a Keep me signed in box. It starts unticked, and what you get depends on it:

  • Left unticked, closing the browser signs you out. While the browser stays open, using Modbot keeps the session going; two weeks without using it ends it.
  • Ticked, you stay signed in after closing the browser, for 30 days from when you signed in. Those 30 days do not stretch, however much you use Modbot: after 30 days you sign in again. Leave it unticked on a machine that is not yours.

Whichever you choose:

  • Modbot checks the account on every request. Disabling an account, using a reset link, changing your password (for your other sessions) and Sign out everywhere all take effect on the next click, not at the next sign-in. Sign out everywhere ends kept sessions too.
  • Changing your password or your username keeps the browser you did it in signed in, and keeps it the same kind: if you had ticked the box, you still have.
  • Restarting or updating Modbot does not sign anybody out.

Failed sign-ins

A wrong password never locks anybody out. Instead each failed attempt makes the next one wait longer: 1 second, then 2, 4, 8, 16, and at most 20 seconds, counted per sign-in typed and per address over 15 minutes. A correct password always works after the wait, so nobody can keep you out of your own Modbot by hammering your username. The sign-in page gives the same answer for a wrong password, an unknown username, an unknown email address and a disabled account, so it cannot be used to find out who has an account here.

What Modbot writes down

Every account event is recorded in Modbot's own log, which people with See the operational log can read on the Audit log page:

  • accounts created (and whether by invite or temporary password), invite links made, used and taken back,
  • roles changed, and roles created, changed or deleted,
  • accounts disabled, enabled and deleted,
  • usernames changed (old and new name), passwords changed, contact details changed (which fields, not the values),
  • reset links made (whether you or the person asked, and how it was sent) and used,
  • VRChat accounts linked,
  • new staff checklists started, their buddy changed, lines signed off and checklists removed,
  • every sign-in, every failed sign-in, and every Sign out everywhere,
  • who asked for the project's emails when they made their account.

A failed sign-in records what was typed in the sign-in box and the address it came from, never the password.

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