Modbot Docs
Discord

Acting from Discord

Look people up, write notes, watch people, see who is live, and kick, ban or answer join requests from Discord, with the same permissions and records as the web app. Includes the /ban and /kick commands.

Moderators can act on what they see in Discord without opening Modbot: right-click a member, or press a button under a card the bot posted. Everything happens as the moderator's own Modbot account, with the same permissions, reasons and records as the web app.

Every reply, form and confirmation is visible only to the person who pressed. The one thing the channel sees is a line above a card once somebody has acted on it, such as Banned by alice.

Who can use it

The same people who can use the slash commands: a moderator who has connected Discord on their Your account page. Each action then needs the permission it needs in the web app:

WhatNeeds
Look up in ModbotSee profiles
Add a note, the Add note button, /noteWrite notes
/watchWrite notes
/liveSee live instances
KickKick
BanBan
/ban, /kickBan or Kick for the VRChat group; Ban on Discord or Remove from Discord for the Discord server. Which one depends on who is named; see Ban and kick
Approve, RejectAnswer join requests

Anything that writes — a note, a watch or an action — also needs a VRChat account linked to the moderator's Modbot account, as the web app does. Without one the bot replies "Link your VRChat account in Modbot first." Without the permission, the reply names it, for example You need the "Ban" permission in Modbot.

Permissions are checked again when a form is sent and when a confirmation is pressed, so a permission taken away in between stops the action.

Right-click menus

Right-click a member, then Apps:

MenuOnWhat it does
Look up in Modbota memberThe same card /lookup shows for that member, with what your permissions let /lookup show: their notes only if you have See the audit log, their join requests only if you have See join requests. For a member who has linked their VRChat account, it is their VRChat profile with Add note, Kick and Ban buttons for the ones you may use (no Kick or Ban for somebody already banned). For a member with no link, it shows VRChat: Not linked, their Discord ban status, timeouts, Discord bans and kicks, and flags, with an Add note button. A member Modbot has no records of gets "Modbot has no records of that Discord member." and the Add note button.
Add a notea memberA form with one box. The note is written about their Discord account and shows on their person view in Modbot.

The menus refuse Modbot's own Discord account.

Who sees the menus

The menus are shown only to members with Discord's Timeout Members permission. To change that, open your server's Server Settings → Integrations, pick the bot, and choose the roles or members for each menu. This only changes who sees them: Modbot still checks the moderator's Modbot permissions on every press.

Typed commands

Five commands do the same jobs without a menu. Each is shown only to members with Timeout Members and answers only you; the full options are in the command list. /ban and /kick have their own section, Ban and kick.

CommandWhat it does
/note text: with member: or vrchat:Writes a note. The reply is "Note saved." with an Open in Modbot button on the person.
/watch reason: for: with member: or vrchat:Starts a watch, for 1 day, 1 week, 30 days or until stopped, with an optional follow-up tomorrow or in a week. Nothing is changed on VRChat or Discord.
/liveThe group's open instances, one card each, with an Open Live button.

Name the person with exactly one of member (picked from Discord's list) and vrchat (a VRChat name or id, with suggestions from Modbot's records). Naming neither or both is refused before anything is written. A VRChat name is a profile's, so it needs See profiles, as in the web app: without it vrchat takes an exact id only, no names are suggested or searched, and replies show the person by id and link, never by name. A note about a member is on their Discord account, and one about a VRChat person is on their VRChat account, as with the menus.

/live shows what the Live page shows, less. Names appear only while a moderator's Companion App is watching that instance, up to 20 and then "and N more". It has no flags and no watched tags.

Ban and kick

/ban and /kick name the person the same way as /note and /watch: exactly one of member (picked from Discord's list) and vrchat (a VRChat name or id). Then they work like the buttons under a card: a form, a check of everything the web app checks, and a confirmation that acts once. Seen only by you.

What /ban means

It means what Ban means in the web app.

Who you nameWhat is bannedNeeds
A VRChat personThey are banned from the VRChat group. If they have a linked Discord account, it is banned with them.Ban
A Discord member who has linked their VRChat accountThe same: the VRChat group, and their Discord account with it.Ban
A Discord member with no VRChat linkThey are banned from the Discord server.Ban on Discord

The confirmation says which: "Ban name from the VRChat group and the Discord server?" when a linked Discord account goes too, and "Ban name from the Discord server?" for a member with no link. A group ban's form has the group's reasons and a note. A Discord ban's form has a reason, which it needs, and Delete their messages from: None, 1 day or 7 days.

What /kick means

It goes by who you name. A Discord member is removed from the Discord server, and a VRChat person is kicked from the group. from chooses the other place, or both, for somebody who has both accounts linked:

fromDoesNeeds
left outRemoves a member from the Discord server; kicks a VRChat person from the groupRemove from Discord, or Kick
Discord serverRemoves them from the Discord serverRemove from Discord
VRChat groupKicks them from the groupKick
BothDoes both, with one confirmationKick and Remove from Discord

If the person has no account in the place you asked for, nothing starts: "They are not linked to a VRChat account." or "They have no linked Discord account." With Both, each place answers on its own line, and one saying no does not undo or stop the other.

The same steps as a card button

Send the form, then press the red button on the confirmation. The permission is checked when you run the command, when you send the form and when you confirm. The bot, the server's owner and any Discord account linked to a Modbot staff account are refused for anything on the Discord server, as they are in the API, before a confirmation is shown. One confirmation acts once: a second press, from the same device or another, gets the first answer and sends nothing.

A group action has the same facts, case file and linked Discord ban as one from the web app. A Discord ban or removal is the same action the API's Ban on Discord and Remove from Discord make: Discord's audit log says "Modbot: banned by your name: reason", and Modbot records who asked. VRChat's rate limits are not retried: a refusal because of one is shown, and nothing else is sent.

Names and See profiles

A VRChat name is a profile's, so it needs See profiles, as in the web app. Without it, vrchat takes an exact id only. Nothing is suggested or searched, and a name, a typo and an id Modbot has never seen all get the same sentence, which quotes nothing back. The form and the confirmation show the id you typed, never the person's VRChat name. A Discord member is shown by the name Discord shows for them.

Buttons under cards

When an event channel posts a message with one card in it, the card gets buttons for the person it is about:

CardButtons
Something a VRChat person did or had done to them: joined, left, warned, kicked, role changes, profile changes, flags, notesAdd note, Kick, Ban
A banAdd note, and Open case when a case file covers the ban and a public address is set
Asked to join the groupApprove, Reject, Add note
Something that happened to a Discord account: joined, left, timed out, banned from DiscordAdd note
Anything else: instances, the group, settingsnone

A message that holds several cards, which happens when many events arrive at once, has no buttons: Discord puts buttons under the message, so they could not say which card they are for.

Everybody who can read the channel sees the buttons. Pressing one without the permission is refused.

Kick, ban, approve and reject

None of these happen on one press.

Press the button

Kick, Ban and Reject open a form with the group's reasons for that action and a note. A ban always needs a reason; a kick or a rejection needs one when your group has switched on Require a reason on kicks, unbans and rejected join requests. Discord shows at most 25 reasons, the first 25 in your list's order. Approve has no form.

Send the form

Modbot checks everything it checks in the web app before anything is sent: the reasons are on the list and ticked for this action, a reason that needs a note has one, and the person is not the account Modbot signs in as. Anything wrong is said now.

Confirm

A message asks, for example, "Ban jessie from the group?", with the reasons and the note, a red Ban and a Cancel. Only you can press it, and it runs out after 15 minutes, or if Modbot restarts; press the card's button again to start over.

Once VRChat answers, the confirmation says what happened. Nothing is recorded unless VRChat accepted it, and a refusal says what VRChat said. A ban writes its case file and bans the person's linked Discord account, exactly as a ban in the web app does.

One confirmation acts once. Pressing it twice, or from two devices, sends one action and answers the second press with the first answer.

When the action was started from a card, the card gets a line above it, such as Banned by alice, and loses its Kick, Ban, Approve and Reject buttons. Add note stays.

What is recorded

Notes, watches and actions from Discord are the same records as from the web app: the same note, the same watch, the same kick or ban in the audit log under the moderator's name, the same case file. Every menu, button, form and typed command that finishes or is refused is also recorded as Discord command used, which shows that it came through Discord. For /ban and /kick it names the VRChat person, the Discord account, or both. A ban or removal on the Discord server alone is recorded as Banned on Discord or Removed from Discord with the moderator's name and the reason. The names suggested while you type are not recorded.

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