Popups
The popups that open when you click a person, a world or an instance, how they stack, what each one shows and which permissions they need.
Almost every name in Modbot can be clicked: a person in the audit log, a world on Live, an instance number in a table. Clicking one opens a popup over the page you are on. The page stays exactly as it was underneath, with its scroll position, filters and loaded rows, so closing the popup puts you back where you were.
There are three kinds: a person, a world and an instance.
A person means one human being, not one account. Somebody can be up to three things in Modbot — a VRChat account, a Discord account, and the Modbot account they sign in with — and clicking any of them opens the same popup, showing every account Modbot can tie to the one you clicked. You never have to know which of somebody's accounts to click.
How popups stack
- Opening something from inside a popup puts a new popup on top. Click the world inside an instance popup and the world opens over it.
- Only the top popup is shown. Its header has a back control naming the one underneath, such as Back to the instance. Hover over it to see how many more are open below.
- Closing goes back one level. Escape, the close button, a click outside the popup and your browser's Back button all do the same thing.
- Clicking the thing that is already on top does nothing, so a list that names the same world twice does not build a pile of identical popups.
The whole stack is kept in the page address (as one or more ?subject= values). You can copy the
address and send it to another moderator, and it opens the same popups for them. They still need
the permissions to see what is inside.
Person popup
The title is Person, with the person's id under it.
Which accounts belong together
Modbot ties accounts together from two things and nothing else:
- the account link a member proved between their Discord and VRChat accounts;
- the VRChat account a Modbot account proved, and the Discord id an administrator typed onto a Modbot account.
Names are never used. Two people called the same thing stay two people, and an account link that was ended ties nothing.
If an account cannot be tied to the others, the popup still opens on what is known and says which are missing in one line, such as Not linked to Discord or Modbot. You are only told a Modbot account is missing if you are allowed to know who holds one — otherwise nothing is said either way.
Left side
- Who they are. Their banner with their picture over it, display name, pronouns and the 18+ verified mark, then a row of badges: the trust rank, VRC+ (in gold) if they subscribe, the platform they last used (PC, Android or iOS), VRChat staff, Nuisance, Early adopter, and one badge per language on their profile. Under that, the group they represent (its icon and name; hover for the group id) and how old the stored profile is. Opening the popup asks for a fresh copy. See Profiles. The rest of the profile is on the Overview tab.
- Discord. Only when Modbot knows a Discord account for them: the Discord name and id. When the two accounts proved a link, also when they linked, the roles Modbot gave them, and Not in the server if they have left it, and anybody with Manage Discord links sees an Unlink button. See Account linking. Where the Discord id was typed onto a Modbot account rather than proved, none of that is shown, because none of it exists.
- Modbot account. Only for people allowed to know who holds one: the username, Disabled if it is, its roles, when it was made and when it last signed in.
- Membership. Whether they are in your group now and since when, whether they are representing the group, who invited them (Invited by), who let them in from a join request (Approved by), how many times they asked to join and how many of those were rejected and by whom, Blocked from asking if they were, their group roles, the group's manager notes about them, and whether they are on the ban list, or when a ban was lifted. The invite and join request lines come from the audit log, so they need See the audit log. The last line, Checked, says how long ago the older of the member list and the ban list was last read. If the member list has never been read, it says Member list not read yet. Below that, Kick, Ban or Unban, for whoever holds those permissions — see Kicking, banning and unbanning.
Tabs
| Tab | What it shows |
|---|---|
| Overview | Profile: their status line, bio, Joined VRChat, Last seen by Modbot, and the tags that have no badge behind a control that counts them (12 more tags / Hide tags). Then the Past actions block (how many times the person has been acted on, by how many moderators, and their status; see Reviews and repeat offenders), their time in world (Time seen, Instances visited, Worlds visited, Arrivals, Last seen and First seen), a table of the instances they were seen in (newest 25), Visits (see below), and the newest 8 audit log entries about any of their accounts, with All activity to open the Activity tab. |
| Activity | Recorded about this person: every audit log entry about any of their accounts or done by any of them, newest first, 50 at a time with Load more at the bottom. It is the audit log's own list with its filters, narrowed to this person, and new entries arrive while it is open. Show starts on Everything; pick Moderation only for bans, kicks, warnings, rejected join requests, notes, watches, case files, AutoMod and copied bans, Presence for arrivals, leaves, avatar changes and clips a moderator saved, or Discord for their Discord history and everything Modbot copied between the two. Each row says which account it was found under, so a Discord ban is never mistaken for a group one. Click a row to see everything the entry holds. Where AI briefs are on, Brief me is at the top of the tab. |
| Notes | What moderators have written down about them, newest first, and a box to add another. Notes that were taken back are still listed and marked. See Notes. |
| Profile changes | Their VRChat profile as it stood after each change Modbot recorded, newest first. Pick a version on the left to see it in full, pictures, banner and represented group included; the fields that change carried are marked. JSON under a version shows that version's record as stored; Hide JSON puts it away. Now is the profile as stored; First seen is where the record begins. See Profile changes. |
| Cases | Their case files, withdrawn ones included and marked as such. Click one to open it. See Bans and case files. |
| Flags | What AutoMod rules flagged about any of their accounts, switched between Open, Dismissed and Confirmed. Flags page opens the Flags page, where flags are dismissed or taken to a review. |
| Discord | Their Discord details, their activity in the server (messages and voice), and their own history there: comings and goings, renames, roles, timeouts, bans, and the bans and roles Modbot copied over from VRChat. See Discord members. |
| Messages | Everything they wrote in Discord that Modbot has stored. Needs Read Discord messages. |
| Account | Everything their Modbot account did and everything done to it: sign-ins, role changes, settings they changed, and every kick, ban and unban they pressed in Modbot. Above the history, their new staff checklist, when they have one. |
| Raw data | The stored records as Modbot's API answers them, as one document with one copy button. Its named parts are the profile, the membership and ban standing, the two bodies VRChat last sent (the public profile and the user object), the Discord member row, their Discord activity and the Modbot account. A part you do not hold the permission for is left out rather than shown empty; if you hold none of them the tab says so. Open it from ⋯ in the popup's header; it shows as a tab while it is open. |
A tab is only there when there is an account behind it and you hold its permission.
Profile changes
Modbot keeps no separate copies of a profile. When a refresh finds a field changed, it writes an audit log entry with the old and new values, and the Profile changes tab replays those entries backwards from the profile as stored now. A version's time is the window between the two reads that noticed the change. Clicking VRChat profile in a profile changed entry on the audit log opens the person on this tab at that version.
Visits
Visits on Overview lists where the person was seen, one row per visit, newest first, 10 at a time with Load more: the instance (click it to open the instance), when they arrived and left and how long that was, Already there when a moderator's companion arrived after they did, Not seen leaving when nobody saw them go (the visit then runs to the last thing reported from that instance before it closed), the name they had if it was not the one they have now, the avatars they were seen changing into, and Seen by with the moderators whose companions saw them. Visits are made from the same reports as the time-in-world figures. It needs See the audit log, the permission that reads the same arrivals and leaves in the audit log.
The time-in-world figures on Overview only count time a moderator's companion shared an instance with the person. When no client has seen them they are left out, which does not mean the person has never been in an instance.
World popup
The title is the world's name, with the world id under it.
Left side
The world's picture and name, then:
| Field | Meaning |
|---|---|
| Made by | The world's author. Click to open them as a person. |
| Who can find it | Anyone (public), Only people given the link (private) or Hidden. |
Name not read yet is normal for a few minutes after a new world turns up, and permanent for a private or deleted world.
Tabs
-
Overview: Details, then the four figures (Time seen, Visitors, Instances opened with how many are open now, and Last seen), the newest 5 instances, and two daily charts: Visitors per day and Instances opened per day. Time and visitors only count time a moderator's companion was in the world. The details are:
Field Meaning Holds How many people the world page says it holds, and the suggested number if different. This is what the page says; group exemptions can raise the real limit. First seen by Modbot When the world first turned up. Published on VRChat When the author published it. Page last read When Modbot last read the world's VRChat page. Description The world's description. -
Instances: the newest 25 instances that have run in this world. The number on the tab is the total.
-
History: the newest 50 audit log entries recorded in any of this world's instances.
-
Raw data: the world's stored record as the API answers it, with a copy button. Open it from ⋯ in the popup's header; it shows as a tab while it is open.
Opening a world popup never asks VRChat for anything. It shows what Modbot already has.
Instance popup
The title is the world name and the instance number. Under it: Open now or Closed.
Modbot gives every instance its own id, because VRChat hands the same instance number out again after an instance closes. Two evenings under the same number are two different instances and two different popups.
Left side
The world's picture, then World (click to open the world popup), Instance number, Who can join, and either Closed with when (and "went quiet" if Modbot closed it after hearing nothing for a long time) or Open now with when it was last seen.
Tabs
- Overview: Details (Region, Opened, People now for an open instance, and
Seen by a moderator's client: how many people a client saw and for how long in total), then
Next game when the instance belongs to an open event that picks from a
world list (with See calendar), then
Ran for or Open for and Most at once, then Joins (Total: every join a
moderator's client saw; Firsts: the different people who made them, counting someone already
there when the client arrived; Rejoins: the joins that were somebody coming back; Returning
members: how many of those people are group members now), and the six people seen longest.
In Busiest others, another group's instance shows its name and its group's name once
Modbot has asked VRChat for them, which it does once per instance and once per group, and never
for an instance only invited people, friends or group members can join.
- People over time, under Joins: the line is green where the count went up, dark red where it dropped at a kick and light red where it dropped because people left. The keys above it turn on dashed lines for Members and for each trust rank, counting the people a moderator's companion saw there against today's membership and rank; the tooltip lists every line whether or not it is drawn.
- People: Who was seen in this instance: the People list narrowed to
the people a moderator's client saw in this instance, one row each. Arrived at is their first
arrival, Left at their last leave, and Visits how many times they came; a time is marked
Already there when the moderator's client found them in the instance and did not see them
arrive, and Not seen leaving when nobody saw them go (their Left at is then the last
report from the instance). The search and every filter on the People page work here too. The list
starts with whoever arrived first, and can be sorted by First to arrive, First to leave or
By name. Here at and Not here at are added for working out who was there at a moment:
pick a day and a time, seconds included, and press Apply. Add as many as you like; a person
must match every one, so Here at 9:30 PM and Here at 9:50 PM is everybody who was there at
both times, and Here at 9:30 PM with Not here at 9:50 PM is the people who left in
between. Someone counts as there at a moment if any of their visits covers it. The chips last
until you close the popup and are not part of the page address.
- Clicking the chart: a click on a point of People over time adds a Here at chip for that moment and opens this tab, so the list of who was there just before a drop is one click away. Add Not here at from Filter for a moment after the drop to see who was there before it and not after. The click needs the same permissions as the tab, See analytics and See the audit log; without them the chart does nothing.
- When a moderator crashes: while a moderator's client is gone it sees nobody leave. When it comes back it lists who is in the instance, and anybody it had listed who is not in that list is counted as having left when the client went away, the last moment that moderator vouched for them. If another moderator's client kept watching and still saw them afterwards, they stay. A person nobody saw leave is shown as Not seen leaving.
- Who was there comes only from the reports of moderators' Modbot apps (the companion). Nobody a moderator's client did not see is in the list.
- Activity: What happened in this instance: the audit log narrowed to this instance, with the same filter chips as the Audit log page; When starts on the days the instance ran. Open in Audit log opens the page with the same chips. Where AI briefs are on, Summarise what Modbot recorded sits beside it.
- Raw data: the instance's stored record as the API answers it, with a copy button. Open it from ⋯ in the popup's header; it shows as a tab while it is open.
Size and address
A popup fills the window except for a small margin, with the thing it is about on the left and
the tabs on the right. The tab a link opens on can be part of the address (?tab=history), and
for a person the version too (?version=); switching tabs by hand does not change the address.
Who can see what
| Part | Permission |
|---|---|
| Person popup: profile, Discord card, Cases, Profile changes and Flags tabs, time in world on Overview, Discord activity on the Discord tab, Past actions block | See profiles |
| Person popup: Membership card, Discord tab | See members |
| Person popup: Unlink button | Manage Discord links |
| Person popup: Messages tab | Read Discord messages |
| Person popup: Modbot account card — knowing who holds which account | See the operational log or Manage staff accounts |
| Person popup: Account tab | See the audit log for what they did as a moderator, See the operational log for their sign-ins and role changes |
| Person popup: entries in Activity | See the audit log (and See the operational log for Modbot's own entries such as sign-ins) |
| Person popup: Notes tab | See the audit log to read them, Write notes to add one |
| Person popup: Brief me, and instance popup: Summarise what Modbot recorded | Use AI chat, with AI, Chat and AI briefs on; the instance's also needs what its Activity tab needs. Save as note needs Write notes |
| World popup | See analytics |
| Instance popup | See analytics |
| Instance popup: People and Activity tabs, Seen by a moderator's client, Joins, the Members and trust rank lines on People over time, and the people seen longest | See analytics and See the audit log |
When you lack a permission, the popup still opens and says You do not have permission to see this. (or a similar line) in the part you cannot see. See Roles and permissions for the full list.