Introduction
What Modbot is, what it does today, the pieces it is made of, and where to start.
Modbot is moderation, analytics and automation for one VRChat group. You host it yourself. It is open source under the AGPL-3.0 licence.
Modbot keeps a copy of what VRChat's API tells it about your group, records the history VRChat does not keep, and gives your staff tools VRChat does not have: searchable member and ban lists, a full audit log, case files with evidence, analytics, a Discord bot, a companion with a SteamVR overlay, and optional AI features.
One Modbot looks after one group. If you run two groups, you run two Modbots.
What it does today
Each section below has an overview page that lists every feature in it.
Moderation
See who is in your group's instances right now, plan events once and publish them to VRChat, Discord and Google Calendar, sort them with event categories, and write posts and giveaways ahead of time. Search everyone Modbot has seen, members and bans and join requests, keep notes and case files with evidence, take reports from members, let AutoMod flag what breaks your rules, and give moderators roles automatically while they meet your conditions. See the moderation overview.
Discord
A bot that runs inside Modbot. It posts your events and open instances, links members' accounts, lets staff act from Discord, and looks after your server with a join gate, role menus, tickets, role and ban sync and permission watch. See the Discord overview.
The companion
A Windows program for moderators. It reads VRChat's log on your PC and reports who is in your group's instances, shows it in SteamVR, lets you leave heads-ups for other staff, save clips, use your voice with Listening, speak questions to AI Chat with Dictate, tell the admins about a bug or an idea by voice with Feedback and swap your microphone between a Discord call and VRChat with Talk in Discord or VRChat. See the companion overview.
AI (optional)
Connect a provider you choose and nothing AI-related runs before that. Then you get Insights, unusual activity alerts, Chat (also through MCP, and by microphone in Chrome and Edge) and AI rules in AutoMod, with limits and spend to keep the cost under control. See the AI overview.
Accounts and integrations
Staff accounts, roles and permissions and notifications decide who can see, do and hear what; see the accounts overview. Twitch shows when your channel is live; see the integrations overview.
Everything else
Now is the page Modbot opens on. Analytics covers your group, your Discord server, your team, your worlds and your instances, and holds the VRChat page, where staff read and change the group's profile, posts, gallery, invites and roles. Appearance is the themes, Desk and Headset, and the phone layout. The API lets your own tools read Modbot's data, with API keys, live events over WebSocket, long polling and webhooks. Things Modbot does not do are on Not built yet.
The pieces
| Piece | What it is | Do you need it? |
|---|---|---|
| The Modbot server | One program that holds the API, the web app, the VRChat sync and the Discord bot. It runs as one container. | Yes |
| PostgreSQL | The database. Everything Modbot knows and every setting lives here. | Yes |
| The web app | What you and your staff open in a browser. It is served by the Modbot server, so there is nothing extra to install. | Comes with the server |
| The companion | A Windows program each moderator can install to report presence from VRChat and show the overlay. | Optional |
| The Discord bot | Part of the server. It starts when you give Modbot a bot token. | Optional |
| An AI provider | A service you already have an account with, used for AI moderation rules, insights and chat. | Optional |
| A storage bucket | Somewhere to keep evidence files. Modbot can also keep them on disk or in the database. | Optional |
See What you run for more on each one.