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:
| What | Needs |
|---|---|
| Look up in Modbot | See profiles |
Add a note, the Add note button, /note | Write notes |
/watch | Write notes |
/live | See live instances |
| Kick | Kick |
| Ban | Ban |
/ban, /kick | Ban 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, Reject | Answer 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:
| Menu | On | What it does |
|---|---|---|
| Look up in Modbot | a member | The 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 note | a member | A 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.
| Command | What 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. |
/live | The 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 name | What is banned | Needs |
|---|---|---|
| A VRChat person | They 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 account | The same: the VRChat group, and their Discord account with it. | Ban |
| A Discord member with no VRChat link | They 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:
from | Does | Needs |
|---|---|---|
| left out | Removes a member from the Discord server; kicks a VRChat person from the group | Remove from Discord, or Kick |
| Discord server | Removes them from the Discord server | Remove from Discord |
| VRChat group | Kicks them from the group | Kick |
| Both | Does both, with one confirmation | Kick 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:
| Card | Buttons |
|---|---|
| Something a VRChat person did or had done to them: joined, left, warned, kicked, role changes, profile changes, flags, notes | Add note, Kick, Ban |
| A ban | Add note, and Open case when a case file covers the ban and a public address is set |
| Asked to join the group | Approve, Reject, Add note |
| Something that happened to a Discord account: joined, left, timed out, banned from Discord | Add note |
| Anything else: instances, the group, settings | none |
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.