Runs on your own server.
One container and one PostgreSQL database. Your group’s records are stored there.
Where your data goes.
- Every record the server keeps is in your database. Evidence files go to S3-compatible storage, a mounted folder or that same database.
- The server talks to VRChat, Discord, your mail server and an AI provider when you set each one up.
- It also sends Modbot Cloud, by default, a list of your open instances, a usage report that names your server and your group, and its own log, which can name members. Each has its own switch, and one environment variable turns all three off.
- The companion also sends events to Modbot Cloud as a backup. This is on by default, and it has a switch for it.
One command
$ curl -fsSL https://modbot.co/get.sh | shThe one setting
DATABASE_URL=postgres://user:password@host:5432/modbot
# PORT is optional and defaults to 8080Everything else is set up in your browser.
- 1Create your administrator account
- 2Connect a VRChat account
- 3Check the connection
- 4Link your VRChat account
- 5Choose the group to manage
- 6Public address, Discord and email
Runs anywhere Docker does. On Railway it reads the platform’s own settings, including a storage bucket for evidence. Read the self-hosting guide
Modbot and VRChat’s rules.
- The VRChat client
- Modbot does not modify the game. The server reads VRChat’s API and the companion reads the log file VRChat writes.
- The VRChat account
- Modbot signs in as one account you give it, which must be a moderator of the group. Its password and two-factor secret are stored encrypted in your database.
- VRChat’s API
- VRChat offers no support for third-party use of its API. Modbot is independent and not affiliated with VRChat Inc.
- The Discord bot’s permissions
- View Channels, Send Messages, Embed Links, Attach Files, Read Message History and View Audit Log. It does not ask for Administrator.
Not built yet
Designed and planned, but not in Modbot today.
- Actions from Modbot
- Kick, ban and warn without switching to VRChat.
- Discord sync
- Linked accounts, roles and bans kept in step with the group.
- Segments and giveaways
- Find “regulars with 10+ hours this month and no bans”, then draw fairly.
- Shared warnings
- Flags from the groups someone belongs to, shared between groups.