Roles and permissions
What a role is, the three built-in roles, and every permission in Modbot with what it lets a person do.
A role is a name for a set of permissions. Every staff account holds one or more roles, and what a person may do is everything their roles allow, added together. There are no extra permissions set on one person alone: if you want to know why somebody can do something, the answer is always on the Roles page.
To give people roles, see Staff accounts.
The Roles page
Open Settings, then the People and roles tab, then Roles. You need Manage roles to see it, and that permission alone is enough to open Settings — you do not also need Change settings, and you will see only the tabs you may open.
It used to be in the sidebar
Roles and Users were sidebar pages until September 2026. The old addresses, /roles and /users,
still open them, so an old link or bookmark still works.
Each role is a card showing its name, its one-line description, how many permissions it holds and how many people hold it. Click a card to open it:
- Name and One line about it (the description).
- A checklist of every permission, grouped under Reading, Evidence, Moderation, Availability and Administration. Each has a short label and a line saying what it covers.
- Save changes, and for roles you made yourself, Delete role — press it again, in red, to confirm, or Cancel to back out.
Press New role to make one. Give it a name, tick its permissions and press Create role.
Rules:
- A role name can be up to 64 characters and must be unique (upper and lower case count as the same). A description can be up to 256 characters.
- You can only put permissions into a role that you have yourself. Boxes for permissions you do not hold are greyed out, and saving a role that contains one is refused, even if the role had it before. An administrator can tick anything.
- A role somebody holds cannot be deleted. Move those people to another role first. The button stays greyed out until nobody holds it.
- A change to a role takes effect for everyone holding it on their next click, not their next sign-in.
- Creating, changing and deleting roles are all recorded in the operational log, with the permissions before and after.
Built-in roles
Three roles exist on every Modbot from the start. They cannot be deleted or renamed.
| Role | Holds | Can be changed |
|---|---|---|
| Administrator | Administrator: everything, including permissions added in future versions. | No. It always means everything. |
| Moderator | See members, See profiles, See analytics, See the audit log, Kick, Ban, Unban, Warn, View evidence, Upload evidence, Pair a companion, See reports, Handle reports, Send feedback. | Yes: its description and permissions. |
| Viewer | See members, See profiles, See analytics, See the audit log. | Yes: its description and permissions. |
Some permissions are deliberately not in Moderator or Viewer, because they reach further than day-to-day moderation: See live instances, See calendar, See giveaways, See availability, Enter availability, Use AI chat, Read Discord messages, Manage Discord links, Write notes, and the evidence and administration permissions not listed above. Grant them on purpose, to a role of your own or by editing a built-in one.
The order of roles
Roles are in a line, highest first, like roles in Discord. Administrator is always first. The Roles page lists them in that order, and each card has Move up and Move down buttons (the arrows at its right end, which work on a phone too). A role you make yourself starts at the bottom.
A person's rank is their highest role. Somebody with no role is at the bottom. Rank follows the order of the list, not what a role allows, so a role placed low can still hold permissions that people ranked above it lack. Any role that includes Administrator counts as first, wherever it is in the list.
Manage users and Manage roles only reach what is below your own highest role. The same rank doesn't count as below. That is what stops somebody with Manage users from making a reset link for an administrator and signing in as them, and it holds for API keys too: a key has its owner's rank. Buttons for anything you can't change are greyed out. Administrator is above the rule.
When Modbot was updated to have this order, it put the roles in a first one: Administrator, then Moderator and every custom role, the one that allows the most permissions first, and Viewer last. Change it on the Roles page if that isn't the order you want.
Roles from Discord
A Discord role can give a Modbot role, so somebody given a staff role in Discord gets the Modbot role too, and loses it when the Discord role goes. Open a role and its Discord roles are listed under its permissions, with a way to add one; the same list is on Settings → Discord → Modbot roles from Discord, with the switch that turns it on. It reaches only accounts that proved their Discord account, never administrators, and never makes accounts. A Discord role can't give Administrator. See Modbot roles from Discord.
On the Users page, a role that follows a Discord role is greyed out for the people it reaches.
Administrator covers everything
A person holding Administrator passes every permission check in Modbot, including checks for permissions that are added in later versions of Modbot. You never need to tick anything else for an administrator, and updating Modbot never leaves an administrator missing something new.
Modbot always keeps at least one enabled account holding Administrator. See the last administrator.
Who can give what
The same rule applies everywhere a permission can be handed out:
- On the Roles page you can only put permissions you hold into a role.
- On the Users page you can only give people roles whose permissions you all hold, whether by invite link, temporary password or changing their roles. You can also only give or take roles that sit below your own highest role.
- An API key can only be given permissions you hold, and it can never do more than the account that made it can do right now. If you lose a permission, your keys lose it too. See API keys.
So Manage users and Manage roles are never a way to become an administrator.
Permissions are enforced by the server
The sidebar hides pages a person cannot open, but that is only for tidiness. Every request is checked on the server, so hiding a link is never what keeps data safe. The same checks apply to the API, to live events over WebSocket and long polling, to webhooks, to the tools Chat uses to answer questions, and to the Discord bot's commands.
The API refers to each permission by its name, shown below after the label (for example
ViewAuditLog).
Reading
See members
Name: ViewMembers
- Opens the Members view of the People page (the group's member list) and the Discord members page. Without See profiles, that view is all of People it opens.
- Shows whether somebody is a member now, and with which roles, in the person popup.
- Lets Chat look up group membership.
- Opens the Lists page, with See profiles as well: every saved list, who is in each, and Export.
Seeing which Discord and VRChat accounts are linked, and filtering the member lists by link, also needs See profiles.
See profiles
Name: ViewProfile
- A VRChat user's profile, history and metrics in the person popup, and refreshing that profile from VRChat. See Profiles.
- The People page, which lists everyone Modbot has ever seen, members or not. See People.
- Reading case files: the Cases tab in the person popup and the case files shown on the Bans page.
- The Flags page, which lists what AutoMod rules flagged. See Flags.
- Repeat offenders.
- Seeing a member's linked Discord or VRChat account, and their time in world and Discord activity in a person's popup.
- The Discord bot's
/lookupcommand. - The Lists page, with See members as well. A list's rules can ask about bans, flags and 18+ verification, so who is in one is part of people's history.
See analytics
Name: ViewAnalytics
- The Stats, VRChat, Discord and Bluesky pages, and the VRChat page's Instances tab. See Analytics. Changing the Bluesky profile with Edit profile needs Change settings.
- The Discord page's Roles and Channels tabs. See Roles and channels.
- The Discord page's Invites tab. See Invites. Turning invite tracking on, naming invites and making them needs Change settings.
- The Discord page's Account links tab. See Account links. Starting and stopping the link reminder needs Change settings.
- The Discord page's Snapshots tab. See Server snapshots. Taking, deleting and restoring a snapshot, and the schedule, need Change settings.
- The group's posts, on the VRChat page's Posts tab.
- The world and instance popups.
- Insights on the Stats page.
Seeing who was in a past instance also needs See the audit log, and so do each moderator's numbers on the Stats page's Moderation tab and who left an instance last. Without it the tab shows the team's numbers and your own.
See live instances
Name: ViewLiveInstances (ViewLiveRooms, its name before 2026-09-17, is still accepted by the API)
- The Live page: the group's open instances right now, how many people are in each, and who. See Live.
- Live join, leave and avatar events (where somebody is right now) in the event stream and webhooks. Those events also need See the audit log.
Not in the built-in Moderator or Viewer roles.
See calendar
Name: ViewCalendar
- The Calendar page: planned events, each place an event is published (VRChat's calendar, a Discord event, a channel post), and whether that worked. See Calendar.
- With See analytics as well: what each event did, and Past events. See What an event did.
- The World lists page, and the next game during an event. See World lists.
- The Event categories page. See Event categories.
Not in the built-in Moderator or Viewer roles.
See giveaways
Name: ViewGiveaways
- The Giveaways page: every giveaway, its rules, who entered, each draw, the seed, and the entrant list with every weight. See Giveaways.
Separate from See members and See analytics: an entrant list is a list of named people with a number beside each saying how much time they spend in your worlds.
Not in the built-in Moderator or Viewer roles.
See the audit log
Name: ViewAuditLog
- The moderation half of the Audit log page: bans, kicks, role changes, joins and leaves, Discord moderation, case file changes and other moderation history. See Audit log.
- The Bans page and the group's ban list. See Members and bans.
- With See analytics as well: the Bluesky page's Replies tab, the replies, mentions and quotes kept in the log.
- Who was in a past instance, in the instance popup.
- With See analytics as well: Actions per moderator and Last moderator out on the Stats page's Moderation tab. See Analytics.
- Moderation events in the event stream, long polling and webhooks.
- The Discord bot's
/recentcommand.
Use AI chat
Name: UseAiChat
- Opens the Chat page and lets the person ask questions. See Chat.
Chat can only use what the person asking can already see: every tool it uses runs with that person's own permissions, and a tool they lack the permission for is never offered to the model. Chat lists every lookup and the permission it needs. It adds a way of asking, not anything more to see. Using Chat sends group data to the AI provider set up in Settings, which is why it is not in the built-in Moderator or Viewer roles.
Asking about a person through Chat is recorded in the audit log and in that person's own history, the same as any other lookup.
Use AI in excess of usage limits
Name: UseAiPastLimits
- Chat is not stopped by spend limits set on this person or on any of their roles.
- No AI feature is stopped by this person's monthly allowance.
The limit for everyone together, and each feature's own limit, still apply. See Limits and spend.
Read Discord messages
Name: ReadDiscordMessages
- The Messages tab in a person's popup: the messages Modbot has stored from that member, deleted ones included. See Discord messages and analytics.
Not in the built-in roles. Analytics only count messages; this is everything the person wrote.
See the operational log
Name: ViewOperationalLog
- The Modbot half of the Audit log page: sign-ins and failed sign-ins, account and role changes, settings changes, sync problems and similar. See Audit log.
- The Health page, and the status rows at the bottom of the sidebar that open it. See Checking a deployment.
- The Modbot's log page: Modbot's own log lines, with their properties and exceptions. See Logs.
- Reading the Health alerts card under Settings, Email and alerts. Changing it needs Change settings. See Alerts by email.
- Those Modbot events in the event stream, long polling and webhooks.
The Audit log page appears in the sidebar for anyone holding See the audit log or See the operational log, and shows only the half each person may see.
Evidence
See Evidence for how evidence works.
View evidence
Name: ViewEvidence
- Opens the screenshots and video attached to a case file, and lists them on the case file.
Without it, a person who can read a case file sees the case file but not its evidence. It is also needed to read the audit log's entries about evidence, which name the files.
Upload evidence
Name: UploadEvidence
- Attaches screenshots and video to a case file, and takes them off it. In the web app both show on case files the person may also edit: ones they wrote, or any case file if they hold Ban.
Choosing where evidence is stored is a setting and needs Change settings, not this.
Destroy evidence
Name: DestroyEvidence
- Permanently deletes the file behind a piece of evidence. The record that it existed stays: its size, type, who destroyed it, when and why. A reason is required, and there is no undo.
- Works from any case file, including a withdrawn one. A file that is still on another case file is not destroyed until it has been taken off there.
In the web app this is the Destroy button on a file in the case file's Evidence section.
Moderation
Kick
Name: Kick
Remove a person from the VRChat group, from the person's page or the Members list. Modbot asks you to confirm, offers the group's reasons ticked for Kick and a note, and records the kick only once VRChat has accepted it.
Warn
Name: Warn
Reserved: nothing in Modbot uses this yet. It is in the built-in Moderator role.
Ban
Name: Ban
- Banning a person from the VRChat group, from the person's page or the Members list. A reason is required, and the ban's case file is written from the reason and the note.
- Writing a case file for a ban (the Bans page offers this for bans with no case file).
- Changing or withdrawing any case file. Without Ban, a person can only change or withdraw case files they wrote themselves.
Unban
Name: Unban
Lift a person's ban, from the Bans page or the person's page. Separate from Ban, because letting somebody back in is a different decision from keeping them out. The confirmation asks Why lift the ban? with the reasons ticked for Unban, and the ban's case file records that it was lifted and why.
Remove from Discord
Name: DiscordKick
Remove a person from the Discord server without banning them, through the
API (POST /api/discord/members/{id}/kick). Kick is for the VRChat group
only: acting on one platform is not permission to act on the other. The bot needs Discord's Kick
Members. A removal that took someone out of the server is written to the audit log with who
asked; when they were not in the server there was nothing to remove, and nothing is written.
The bot's own account, the server's owner and any Discord account linked to a Modbot staff account
are turned down.
Ban on Discord
Name: DiscordBan
Ban a person from the Discord server through the API (POST /api/discord/bans). Separate from
Ban, for the reason above. The bot needs Discord's Ban Members and a role above the
person's. A ban made this way is a ban by Modbot's bot, so ban sync does not copy it to VRChat
unless it is set to copy bots' bans.
Unban on Discord
Name: DiscordUnban
Lift a Discord ban through the API (DELETE /api/discord/bans/{id}). Separate from Ban on
Discord, as Unban is from Ban.
Time out on Discord
Name: DiscordTimeOut
Time a member of the Discord server out for up to 28 days through the API
(POST /api/discord/members/{id}/timeout). The bot needs Discord's Timeout Members and a role
above the person's.
See reports
Name: ViewReports
Open the Reports page: what members told the mods with /report or
Report to mods in Discord, including who reported, the message they quoted, and the count in
the sidebar. Staff with it are also told when a report comes in. A report about a staff account is
shown only to people who hold Review tickets as well. In the built-in Moderator role.
Handle reports
Name: HandleReports
Close a report on the Reports page, with a note that is required. Needs See reports as well, to open the page. In the built-in Moderator role.
Manage the join gate
Name: ManageJoinGate
At the join gate: Let in and Remove on the At the gate card, Hold new joiners, Lift hold and Pause invites, there and on the buttons under a join spike alert in Discord. Each is written to the audit log with who did it. Not in the built-in Moderator or Viewer roles.
Act on many at once
Name: BulkAction
Reserved: nothing in Modbot uses this yet.
Review tickets
Name: ReviewTickets
- Opens the Reviews page and closes the reviews that open when a moderator's pattern looks unusual. See Reviews and repeat offenders.
- Dismisses flags on the Flags page.
Kept separate from the action permissions on purpose: the people being reviewed should not be the people closing their reviews.
Edit the reason list
Name: EditClassifications
- Adds, changes, reorders and turns off the reasons moderators pick from when they write a case file, kick, unban or reject a join request, and chooses which of those actions offer each one.
- Switches Require a reason on kicks, unbans and rejected join requests on and off.
In the web app the reason list is under Settings, Moderation, and that tab needs Change settings. A person with only this permission can use it through the API.
Write notes
Name: WriteNotes
- Writes a note about a person, on their popup's Notes tab, and takes one back. See Notes.
- Starts watching a person, stops anybody's watch and follows up on one. Whoever started a watch can stop it or follow up without this.
Reading notes is See the audit log, not this: a note is an entry in that log. Somebody can take back a note they wrote themselves without holding this. Not in the built-in roles.
Manage Discord links
Name: ManageDiscordLinks
- Unlinks a member's Discord and VRChat accounts. This also removes the Discord roles Modbot gave them. See Account linking.
Seeing a link needs only See profiles. Not in the built-in roles.
Edit 18+ verified
Name: EditAgeVerification
- Sets or clears the 18+ verified mark on a VRChat user's profile by hand.
- Runs the 18+ check:
/ageverifiedin Discord, and Mark 18+ verified on a profile.
A sync can set the mark but never clears it, so clearing it is always a person's decision, and it is recorded with their name.
Pair a companion
Name: PairCompanion
- Opens the pairing page,
/pair, and pairs the companion to this account. Without it the page says Your account does not have "Pair a companion". - Opens Settings, Paired companions, with this person's own companions and a Remove button on each. Somebody holding Manage users sees everybody's there, with whose each one is, and can remove the companions of people whose highest role is below theirs.
- Keeps this person's companions working. It is checked on every request a companion makes, so taking it away from a person's roles stops their companions straight away, and giving it back starts them again.
In the built-in Moderator role. When it was added, it was also given to every role held by somebody whose companion was working at the time, so no companion stopped on the update. Take it off a role you do not want pairing.
Send feedback
Name: SendFeedback
- Shows the Feedback button on the companion and in the headset, and lets the person send a bug, an idea or a change to the admins, by voice or through AI chat. See Feedback.
- Needs nothing else: not AI chat, and not a linked VRChat account.
In the built-in Moderator role, including on a Modbot that had it before this permission existed. Take it off a role you do not want sending.
Administration
Edit the group's profile
Name: EditGroupProfile
- Changes the group's Languages, Links and About this group in place on the VRChat page's Overview.
- Opens the VRChat page's Settings tab and changes everything on it: the group's name, description, rules, languages, links and who can join. See The VRChat group page.
Each change goes to VRChat as Modbot's VRChat account, which needs the matching group permission in the group's roles on VRChat. Every change is written to the audit log with who made it.
Needs See analytics as well, to open the page.
Not in the built-in Moderator or Viewer roles.
Manage group posts
Name: ManageGroupPosts
- Posts in the group on VRChat, changes a post and deletes one, from the VRChat page's Posts tab. See The VRChat group page.
Reading the posts needs only See analytics. Not in the built-in Moderator or Viewer roles.
Manage group roles
Name: ManageGroupRoles
- Opens Roles under the VRChat page's Settings tab, and creates, changes and deletes the group's roles on VRChat: their names, descriptions and permissions. See The VRChat group page.
- Gives a member one of the group's roles, or takes one away, through the API
(
PUTandDELETE /api/group/members/{userId}/roles/{roleId}).
These are the group's roles on VRChat, not Modbot's own roles on this page. Modbot's VRChat account needs Manage Group Roles in the group's roles on VRChat, and Assign Group Roles to give members roles. Every change is written to the audit log with who made it.
Not in the built-in Moderator or Viewer roles.
Manage group invites
Name: ManageGroupInvites
- Opens the VRChat page's Invites tab, which lists the people the group has invited who have not answered yet, and cancels an invite. See The VRChat group page.
- Invites a person to the group through the API (
POST /api/group/invites), at most one invite every thirty seconds across the whole Modbot, auto-invites included.
Modbot's VRChat account needs Manage Group Invites in the group's roles on VRChat. Not in the built-in Moderator or Viewer roles.
Manage the group gallery
Name: ManageGroupGallery
- Removes an image from one of the group's galleries on VRChat, from the VRChat page's Gallery tab. See The VRChat group page.
- Adds a picture members posted in Discord to a gallery, or declines it. See Gallery pictures.
Looking at the gallery needs only See analytics. Modbot's VRChat account needs Manage Group Galleries in the group's roles on VRChat. Not in the built-in Moderator or Viewer roles.
Manage calendar
Name: ManageCalendar
- Plan, change, cancel and delete events on the Calendar page. An event can publish to VRChat's calendar and Discord in the group's name and open a group instance by itself.
- See and replace the calendar feed link. See Calendar.
- Make, rename and delete event categories. See Event categories.
- Make, change and delete world lists; Pick again on an event's date; Next game and Pick another during an event. See World lists.
Needs See calendar as well, to open the page.
Not in the built-in Moderator or Viewer roles.
Manage templates
Name: ManageTemplates
- Make, change and delete event templates on the Calendar page. See Templates.
- Use every part of the template form without Manage calendar: add its pictures, pick a world, a Discord channel and role, who to invite and an invite list. Picking an invite list on a template does not need See members and See profiles; picking one on an event still does. Making and changing events still needs Manage calendar.
- Without it, Manage calendar still shows the templates, but cannot change them.
Needs See calendar as well, to open the page. Not in the built-in Moderator or Viewer roles.
See posts
Name: ViewPosts
Open the Marketing page: every post, where each one goes and how it went, the Posts card on Health, and the Posts tab of the Bluesky page. Not in the built-in Moderator or Viewer roles.
Manage posts
Name: ManagePosts
On the Marketing page: write, schedule, change and cancel posts, Post now, Try again, delete a draft, send a post's picture to VRChat while VRChat picture uploads are on, and Edit or Delete a post on Discord or VRChat after it went out. A post goes out in your group's name, in public. Needs See posts as well, to open the page. Not Manage group posts, which is the VRChat page's own Posts tab. Not in the built-in Moderator or Viewer roles.
Announce in instances
Name: AnnounceInInstances
On the Live page: Announce on an instance's card sends a message that pops up for everyone in that instance, now or at a time, and Cancel calls off one not sent yet. See Instance announcements. Needs See live instances as well. Modbot's VRChat account needs Create Instance Announcement in the group's roles on VRChat. Not in the built-in Moderator or Viewer roles.
See availability
Name: ViewAvailability
Open the Availability page's Team tab: the heatmap of when the team is free, who is free in each hour, and the best times. Shows everyone who holds Enter availability, by name, with their roles. Not in the built-in Moderator or Viewer roles.
Enter availability
Name: EnterAvailability
Open the Availability page's Mine tab and fill in your own week of free hours, in your own time zone. Holding it also puts you on the team's list for anybody with See availability. It reaches your own times only, never anyone else's. Not in the built-in Moderator or Viewer roles.
Run giveaways
Name: RunGiveaways
- Create, change, open, close, draw and cancel giveaways on the Giveaways page. A giveaway posts in your group's name and a draw decides who gets something. See Giveaways.
Needs See giveaways as well, to open the page.
Not in the built-in Moderator or Viewer roles.
Manage lists
Name: ManageLists
- Make, change and delete lists on the Lists page.
- Changing a list a giveaway still being run uses needs Run giveaways as well; changing one auto-invites uses needs Set up auto-invites as well. A list in use cannot be deleted.
Needs See members and See profiles as well, to open the page.
Not in the built-in Moderator or Viewer roles.
Manage partners
Name: ManagePartners
- Open the Partners page: the groups you work with, their contacts, the last collab, the envoy and notes.
- Add a partner, change one and delete one. There is no separate permission for looking.
Not in the built-in Moderator or Viewer roles.
Review feedback
Name: ReviewFeedback
- Opens the Feedback page under System: what staff sent, who sent it, its kind and title, and the full words of each item.
- Sets an item's status to New, Reviewed, Done or Dropped.
Not in the built-in Moderator or Viewer roles. Administrator holds it. Give it to a role of your own to let more people read feedback.
Manage users
Name: ManageUsers
- Opens Settings, People and roles, Users: add people by invite link or temporary password, take back invite links, change people's roles and contact details, make password reset links, and disable or enable accounts. See Staff accounts.
- Opens Settings, People and roles, New staff: set the checklist lines for new staff members and the channel for their reminders.
- On a person's popup, Account tab, starts their new staff checklist, changes its buddy, closes it or removes it. It also signs lines off and writes the buddy note in the buddy's place.
A person with this only reaches accounts below their own highest role (see The order of roles). They can't change, make a reset link for, disable, enable or delete an account whose highest role is the same as theirs or higher, start, change the buddy of, close or remove that account's new staff checklist, or remove its companions, and they can only give or take roles that sit below their own highest role. They see "You can only change accounts below your highest role." or "You can only change roles below your highest role." An administrator can change anyone, including other administrators. You can still change your own contact details, but you can't take your own highest role off yourself.
Manage roles
Name: ManageRoles
- Opens Settings, People and roles, Roles: create roles, change what each allows, move roles up and down, and delete roles nobody holds.
A person with this only reaches roles below their own highest role: they can't edit, delete or move a role that sits at their own place or above it. A role they make starts at the bottom.
With Manage users as well, they can let a Discord role give a role below their own highest role (see Modbot roles from Discord).
Separate from Manage users: handing somebody a role is a smaller decision than deciding what a role means.
Change settings
Name: ManageSettings
- Opens the Settings page and changes everything on it: Server (how long records are kept and the public address), Modbot's VRChat login, Email and alerts, Discord (including event channels and instance announcements), Posts (Pause all posting and Discord posts), Moderation, AutoMod, Automatic roles, Evidence, AI (including insights and limits) and API.
- Adds, changes, moves and deletes the terms and rules on the Terms and rules page. Seeing the page needs no permission.
- Runs the setup wizard again once it has been completed.
- Opens the Integrations page, from the sidebar's Integrations heading: the status of VRChat, Discord, Email, Google Calendar, Bluesky and Twitch, and where in Settings each is set up. See Analytics.
- Saves the people buttons on the Stats page's Moderation tab (Left without a moderator) for everybody. See Analytics.
- Allows webhooks to be sent to private network addresses.
The API tab's keys and webhooks also need Manage API keys and webhooks, and the reason list under Moderation needs Edit the reason list.
It does not open the People and roles tab, which is Manage users and Manage roles. Each of those two opens Settings by itself, and everyone sees only the tabs they may open.
Manage API keys and webhooks
Name: ManageApiKeys
- Makes API keys for yourself, sees every key and revokes any key. See API keys.
- Sets up webhooks, sees every webhook, and turns off or deletes any of them. Changing a webhook's address, events or secret, or sending a test, is only for the person who set it up or an administrator. See Webhooks.
In the web app these are under Settings, API, which also needs Change settings to open.
Use the VRChat proxy
Name: UseVRChatProxy
- Sends requests to VRChat's own API through Modbot, as the group's service account, at
/api/proxy/vrchat/…. Any endpoint the service account can reach, read or write. See VRChat proxy. - The proxy itself is off until an administrator turns it on under Settings, VRChat proxy, which needs Change settings.
Not part of the built-in roles. Administrator holds it.
Set up auto-invites
Name: ManageAutoInvites
- Switches auto-invites on and off, and sets the rules, the minutes somebody must spend in an instance, and how long before the same person may be invited again. In the web app this is Settings, Auto-invites.
Not part of the built-in roles, and deliberately not part of Change settings. Everything else under settings changes what Modbot does to its own data; this one decides who ends up inside your group, without anybody looking at them first.
Administrator holds it.
Import old data
Name: ImportOldData
- Uploads a file of another platform's bans, warnings, notes and audit entries and has Modbot write each record into the log as history, and sees every past import. See Importing old data.
Not part of the built-in roles, and deliberately not part of Change settings, which it used to be. A setting says what Modbot does next and can be changed back. An import writes history that did not happen inside Modbot: bans, warnings and notes dated years ago, about named people, in the same log a moderator reads to decide what somebody has done before. Nothing else Modbot offers can do that in bulk, and events cannot be deleted afterwards — the only way back is purging the people concerned or restoring a backup.
There is no screen for importing. It is done with an API key holding this permission.
Administrator holds it.
Administrator
Name: Administrator
- Everything, including permissions added in future versions. See Administrator covers everything.
Staff accounts, invites and password resets
How to add your moderators, link their VRChat accounts, disable or delete them, and get them back in when they forget a password.
New staff checklist
Give each new staff member a checklist with a buddy. The new mod fills in written tasks themselves, the buddy signs off the rest and writes a note, the Council is reminded on day 30, and the lines are set per server.