Modbot Docs
Moderation

Lists

Save "our regulars", "new this month" or "linked and 18+" as a list you can come back to. A list is a name and a set of rules, asked again every time you open it; export who is in it, use it in a giveaway or auto-invites, or give its people a Discord role.

A list is a name and a set of rules: "in the group, and seen on at least four different days in the last month". It is not a copy of who matched once. Every time you open it, Modbot asks the rules again, so Regulars next month is next month's regulars.

The rules are the giveaway rules, and Modbot answers them the same way. A list and a giveaway with the same rules name the same people.

A list never does anything by itself. Nobody is messaged, invited or banned because they are in one. What you can do with a list is look at it, export it, name it as a rule in a giveaway or in auto-invites, and pair it with a Discord role in Roles from lists: only then, and only once you switch it on, does being in the list give somebody a role.

Who can use it

To do thisYou need
See the Lists page, every list's rules, who is in each, and exportSee members and See profiles
Make, change and delete lists, and preview rulesManage lists, with See members and See profiles
Change a list a giveaway still being run usesRun giveaways as well
Change a list auto-invites useSet up auto-invites as well
Change a list a Discord role is given fromManage role and ban sync as well

Both See members and See profiles are needed because a list's rules can ask about bans, flags and 18+ verification: who is in "banned twice" is part of those people's history, not only their membership. Without both, Lists does not appear in the sidebar. Manage lists is not in the built-in Moderator or Viewer roles. Administrator holds everything.

The page

Lists is in the sidebar, under Community, after Giveaways. g then u opens it from any page. Each row shows the list's name, how many people are in it right now, and what uses it: a giveaway, or auto-invites.

Click a list to open it. You see its rules in words, what uses it, and Who is in it: everybody the rules let through, by name, fifty to a page. A name with a VRChat account opens their person popup.

Above the names: how many people are in the list, out of how many Modbot looked at, how many are near the line, and when that was worked out.

Who Modbot looks at is everybody in your VRChat group and everybody in your Discord server, joined up where their accounts are linked. Somebody who has left both is not in any list.

About, and near the line

A list whose rules count presence (hours in your instances, seen in the last so many days, days seen, or seen before but not lately) says about 312 rather than 312. Presence comes from the reports your moderators' companions send while they are in an instance, which is a good figure but not an exact one. People whose figure sits within a whisker of a rule's threshold are counted as near the line and shown in amber. Giveaways explains the threshold.

When Modbot cannot answer

If you have set a retention window, a rule reaching further back than the facts Modbot still keeps cannot be answered. The list says so instead of showing a number that looks complete and is not; see When Modbot cannot answer. Seen before, but not in the last N days asks about all of your presence history, so it cannot be answered at all while a presence retention window is set.

Making a list

Click New list. Give it a Name, up to 100 characters; two lists cannot share a name. Build the rules in the rule builder, which works exactly as it does in a giveaway. Preview shows how many people the rules let through and the first fifty of them, before you save anything.

A list cannot use another list.

The rules that suit a list best, beside the giveaway ones:

RuleAsks
Joined the group in the last N days"New this month".
Joined the group before a day / on or after a dayThe join date VRChat states, against a day (UTC).
First seen by Modbot in the last N daysThe first time Modbot saw their VRChat or Discord account.
Days seen, at least NDifferent days they were seen in your instances. "Regulars".
Seen before, but not in the last N daysThey used to come and have stopped. Somebody never seen is not counted.
Times moderated, at least NBanned, removed from the group, kicked from an instance, warned, or join request turned down, as many times as you say. You pick which. "Turned down twice".

Changing and deleting a list

Open the list and click Edit. If a giveaway that is still being run, or auto-invites, uses the list, changing it changes who that giveaway or auto-invites reaches. So it needs their permission as well as Manage lists.

Delete is greyed out while anything uses the list. Take the list out of the giveaway's or auto-invites' rules, off the event's Invite list, or out of Roles from lists, first. A drawn or cancelled giveaway does not count: a draw keeps its own copy of the rules. Nor does a finished or cancelled event.

An event that invites a list sends its people a VRChat invite or a Discord message when the event's instance opens. See Inviting people.

Using a list in a giveaway or auto-invites

In the rule builder of a giveaway or of auto-invites, pick In the list and the list. The list's rules are asked at the moment the giveaway or auto-invites would ask their own, so the list as it is then decides.

  • The giveaway's Discord card shows the list's rules, not its name: your members cannot open your lists, and the point of the card is that they can see the rules.
  • A draw keeps a copy of the rules with the list written out, so changing the list later does not change what an old draw says it was drawn from.

Exporting

Open a list and click Export. Pick CSV or JSON; the dialog shows how many people the file will hold and its columns. Click Export and your browser saves the file.

ColumnIn the file
nameTheir VRChat name, or their Discord name if Modbot knows no VRChat account.
vrchatUserId, discordUserIdTheir ids, where Modbot knows them.
linkedTheir Discord and VRChat accounts are linked.
inGroup, joinedGroupAtIn the VRChat group now, and since when.
inDiscord, joinedDiscordAtIn the Discord server now, and since when.
trustRank, is18PlusVerifiedTheir VRChat trust rank, and whether Modbot has seen them 18+ verified.
vrchatAccountCreated, firstSeenAtThe day their VRChat account was made, and when Modbot first saw them.

Times are UTC. A name that starts with =, +, - or @ is written with an apostrophe in front, so a spreadsheet shows it as text instead of running it.

An exported file leaves Modbot

Once the file is on your computer, nothing Modbot does reaches it. Your retention window does not delete it, and erasing somebody does not take them out of it. Whoever holds the file is responsible for it.

Every export is recorded in the audit log: who exported which list, as which file, how many people, and which columns. The people themselves are not in the record.

In the audit log

EntryWhen
List madeSomebody made a list. Carries its name and rules.
List changedSomebody changed one. Shows before and after.
List deletedSomebody deleted one.
List exportedSomebody exported one. Carries the format, the number of people and the columns.

They are Operational entries in the audit log, beside the giveaway entries, so reading them needs See the operational log.

What a list cannot do

A list cannot be messaged, in Discord or in a group post, and cannot be handed to a ban or kick. The one change it can make is a Discord role, through Roles from lists. See Not built yet.

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