Modbot Docs
Moderation

Bans and case files

Write down why somebody was banned, with reasons, your own words, evidence and a copy of their profile, and keep track of bans nobody has written up.

VRChat's audit log records that somebody was banned, who did it and when. It does not record why: there is nowhere in it for a reason to go.

A case file is your group's own account of a ban: the reasons, what happened in the moderator's own words, the screenshots or video they kept, and a copy of the person's profile as it was at the time. It is what you will want three months later, when the ban is questioned or the moderator who issued it has moved on.

A ban made in Modbot writes its own case file

Banning somebody from Modbot asks for the reasons and a note up front and writes the case file from them. This page is for the other bans: the ones made in VRChat, which arrive with no reason at all. See Kicking, banning and unbanning.

Where to find them

  • Bans page: the VRChat tab has a Case file column. It shows Open the case file when one exists (with a number if the person has more than one) or Write the case file when not. If you cannot write case files, the column says "none" or "withdrawn".
  • A person's popup, on the Cases tab, lists every case file about them, withdrawn ones included.

Writing a case file

Press Write the case file

On the Bans page, beside the ban. You need the Ban permission.

Pick the reasons

Tap every reason that fits. Hover over one to see what it means. You must pick at least one.

The reasons are the part Modbot can count and compare. "Five bans, all Harassment" says something that "five bans, all Other" does not.

Say what happened

Write it in What happened. It says (optional) for most reasons and (required) when you picked a reason that needs a written reason, such as Other. Up to 20,000 characters.

Press Write the case file

The case file opens. If somebody already wrote one for this ban, Modbot says so and offers Open the one that exists. There is one case file per ban.

Writing a case file is recorded in the audit log against your account.

Formatting the written reason

The written reason uses Markdown: **bold**, lists, > quotes, headings, tables and links.

  • Raw HTML is never shown.
  • Links only work for http, https and mailto addresses, and open in a new tab.
  • Images only show if they are evidence attached to this same case file. Copy the sha256 under an attached image and write ![what it shows](evidence:the-sha256-you-copied). An image from any other address is never loaded, because the server it came from would learn the address of every moderator who opened the case file, and when. See Evidence.

The case file page

At the top: the person (click to open their popup), their VRChat id, when they were banned and by whom, and the VRChat audit entry id when there is one. Back to bans returns to the Bans page.

Why they were banned

The reasons picked, then the written reason, then Written by and the date, and who last edited it. A reason that has since been switched off in Settings is still shown, greyed out.

Why the ban was lifted

Shown once the ban has been lifted from Modbot: the reasons picked on the unban, its note, Lifted by and the date, and Audit log entry, which opens the unban in the audit log. See Kicking, banning and unbanning.

Evidence

Screenshots and video, which can be attached, taken off and destroyed here. See Evidence.

The profile at the time

When the case file is written, Modbot copies what it has about the person into it:

  • their VRChat profile: picture, display name, pronouns, 18+ verified if marked, the same badges as the person popup (trust rank, VRC+, the platform they last used, languages and so on), status, bio, Joined VRChat, VRChat showed (what VRChat said about age verification) and the remaining tags behind a more tags control;
  • Membership at the time: whether they were a member, when they joined, their membership status, their role ids and the group's manager notes;
  • their entry on the group's ban list.

This is the part people forget to keep. A banned account often changes its name and clears its bio within the hour.

The copy is taken from what Modbot already has, so the case file never waits on VRChat. A line at the top of the section says when the copy was taken and how old the profile already was then. Profiles are refreshed on a schedule, so the copy might be a few hours old.

Straight after the case file is written, Modbot asks VRChat for a fresher profile. When one has arrived, the section offers Refresh and capture again with Once only. beside it. Pressing it replaces the copy with the newer profile. The copy it replaced is kept in full in the audit log entry for the recapture, so nothing is lost. After that, the copy never changes.

The profile picture is shown from VRChat's own servers and may stop loading if the account is deleted. Modbot does not keep the image.

Editing a case file

Press Edit beside the reasons. You can change the reasons and the written reason, then press Save the case file. The profile copy and the evidence are not changed by editing.

The person who wrote the case file can edit it, and so can anyone with Ban. Every edit is recorded in the audit log with what it said before and after, so the history of a case file can always be read back.

Withdrawing a case file

Case files are never deleted. If one should not have been written, for example it names the wrong person, withdraw it:

  1. Press Withdraw this case file at the bottom of the page.
  2. Write why under Why are you withdrawing it? (required, up to 2,000 characters).
  3. Press Withdraw.

A withdrawn case file:

  • stays readable, with a banner saying This case file has been withdrawn., who withdrew it, when, and the note;
  • can no longer be edited;
  • no longer counts as the write-up of its ban, so the ban shows as having no case file again and a new one can be written.

The author and anyone with Ban can withdraw a case file.

The reason list

The reasons come from Settings, Moderation, Ban reasons. One list serves every action, and each reason is ticked for the actions that offer it: Ban, Kick, Unban and Reject (turning a join request down). A case file only takes reasons ticked for Ban. A new Modbot starts with:

ReasonOffered onNeeds a written reason
HarassmentBan, Kick, RejectNo
Hate speechBan, Kick, RejectNo
Crashing or malicious avatarsBan, Kick, RejectNo
UnderageBan, Kick, RejectNo
Ban evasionBan, Kick, RejectNo
SpamBan, Kick, RejectNo
OtherBan, Kick, RejectYes
MistakeUnbanNo
Appeal upheldUnbanNo
Time servedUnbanNo
OtherUnbanYes

A Modbot that had a reason list before unbans had their own reasons keeps it: its reasons are ticked for Ban, Kick and Reject, and the four unban reasons are added to the end.

With the Edit the reason list permission you can:

  • Add a reason: a name (up to 64 characters), a short description (up to 256 characters), whether it Needs a written reason, and the actions it is offered on (at first Ban, Kick and Reject). Press Add it to the end.
  • Tick or untick the actions a reason is offered on. Every reason keeps at least one.
  • Move a reason up or down with the arrows. The buttons on the case file form follow this order.
  • Switch off a reason, and Switch on again. A switched-off reason disappears from the buttons, but stays on every case file that already picked it.
  • Switch on Require a reason on kicks, unbans and rejected join requests. A ban always needs a reason; with this on, so do the other three. Approving a join request never asks for one.

There is no delete, on purpose. Case files name the reason they were given, so deleting one would quietly change what old case files say. Every change to the list is recorded in the audit log (visible with See the operational log).

The Moderation tab needs its own permission

The Moderation tab only appears for people with Change settings. Someone with Edit the reason list but not Change settings cannot reach the list in the app.

Who can do what

ActionPermission
Read case filesSee profiles
See the Bans pageSee the audit log
Write a case fileBan
Edit, withdraw or capture the profile againBan, or being the person who wrote it
See the evidence on a case fileView evidence
Attach evidence, or take it offUpload evidence, and being able to edit the case file
Destroy evidenceDestroy evidence (on any case file, withdrawn ones too)
Change the reason listEdit the reason list (and Change settings to open Settings)

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