Modbot Docs
Discord

Roles and channels

Two read-only lists for tidying up your Discord server, on the Discord page's Roles and Channels tabs - roles nobody holds or that look alike, and channels nobody writes in.

The Discord page has two tabs for tidying up your server: Roles and Channels. They are in the row under the server's header, between Events and Members, and Discord stays lit in the sidebar while they are open. The command palette finds them as Discord roles and Discord channels. Their addresses are /discord/roles and /discord/channels.

Both only show things. Nothing on them changes your server: you rename, merge, archive or delete in Discord itself.

Both need See analytics, the same as the Discord page. They show counts and dates about the server, never who holds a role or who wrote a message. The bot must be set up and connected (Setting up the bot).

Modbot asks Discord for nothing to make them. They are built from what the bot already keeps: the role and channel lists it reads when it connects and keeps up to date, the member list, and the messages it stores.

Roles

Every role in your server except @everyone, with how many people in the server hold it.

ColumnWhat it shows
RoleThe role's name, with a square in its colour if it has one.
MembersHow many people in the server hold it, from Modbot's copy of the member list. People who left are not counted.
Marked asWhy the role might be worth a look, if there is a reason (below).

A role can be marked as:

MarkMeans
No membersNobody in the server holds it.
Same name as another roleAnother role has the same name. Capital letters and spaces at either end do not count, so "Zuelbot" and "ZuelBot" match.
Same permissions and colour as another roleAnother role has exactly the same permissions and the same colour: maybe the same role made twice. Point at the mark to see which roles.
Bot roleA role Discord made for a bot or an integration: a bot's own role, the booster role, a Twitch or other subscriber role. Nobody can give these out by hand.

Same permissions and colour leaves out roles that have no colour and give nothing beyond what @everyone already has, such as most pronoun, time zone and hobby roles. Every one of those would match every other, and the pairs that matter would be lost among them. Bot roles are left out of it too.

Marked roles come first: the most marks first, then the fewest members, then your server's own role order.

Until the bot has read the whole member list, Members shows —, nothing is marked No members, and the list says The Discord member list has not been read yet. Reading the list needs the Server Members Intent (see Intents the bot asks for).

Channels

Your server's text, announcement and forum channels, the quietest first.

ColumnWhat it shows
ChannelThe channel's name, with a lock if @everyone cannot see it (a staff-only channel).
CategoryThe category it sits in.
Last messageThe day of the newest message in the channel, or in any of its threads or forum posts.
Quiet forHow long ago that was, in Modbot's units: 5h, 21d, 3mth, 5y.

Instead of a time, Quiet for can say:

  • No messages: Modbot has stored no message for the channel. Nobody may have ever written there, or its messages may have been deleted after a while (see Where the time comes from).
  • Still reading: the bot is still reading the channel's history and has found nothing yet.
  • Can't read: the bot is not allowed to see the channel or read its history. Give the bot's role View Channels and Read Message History there to include it.

The list opens with the quietest first: channels with no messages, then the longest quiet, then channels still being read, then channels the bot cannot read.

Sorting

Click a column's name to sort by it, and click it again to turn the order round. An arrow marks the column in use. On a phone, where the table is a list, the Sort box and the arrow beside it do the same. Channels that have nothing to sort by in a column (no category, no last message, a time that is not known) always come last, whichever way it runs.

ColumnSorts byFirst click
ChannelName, A to Z, numbers counted as numbers.A to Z
CategoryThe category's name.A to Z
Last messageThe day of the newest message.Newest first
Quiet forHow long it has been quiet. Channels with no messages count as quiet longest.Longest first

Filtering

Filter adds a filter; each one is a chip that can be changed or removed with its ×, and Clear takes them all off. Filters combine: a channel has to pass every one. The search box finds channels by part of their name.

FilterKeeps
Seen byChannels a role can see, or with is not, channels none of the roles picked can see. See below.
Quiet forChannels quiet for at least 7, 30, 60, 90, 180 or 365 days. Channels with no messages count; channels still being read and channels the bot cannot read do not, since nothing is known about them.
CategoryChannels in the categories picked, or with is not, all the others. No category picks the channels at the top of the list.
TypeText, announcement or forum channels.
StatusHas messages, No messages, Still reading or Can't read, as Quiet for shows them.
Staff-onlyYes or no. Shown only to someone who can Change settings, as the others never see staff-only channels.

The sort and the filters are in the page's address, so copying it gives someone else the same view.

Seen by a role

Seen by answers "which channels can people with this role see?", worked out the way Discord does for someone who holds only that role (and so @everyone):

  • The permissions of @everyone and the role are added together. If that includes Administrator, the role sees every channel.
  • Otherwise View Channels decides, unless the channel says something about @everyone, which wins over the server-wide permission, or about the role itself, which wins over both.
  • A channel synced to its category already holds the category's settings, so nothing more is looked up.

Modbot reads the channel settings with the rest of the channel list when the bot signs in or resumes, and keeps them up to date as they change in Discord, so it asks Discord for nothing more. Until the bot has read a channel's settings once after Modbot was updated, Seen by leaves that channel out whichever way it is asked, since nothing is known about it. A person's own settings in a channel (a setting for one member, not a role) and anything else that member holds are not looked at: the answer is for the role alone.

Staff-only channel names are shown only to someone who can also Change settings. Everyone else sees the public channels and one line, for example 3 staff-only channels, with nothing else about them. Sorting and filtering change nothing about that.

Where the time comes from

The last message is the newest one Modbot has stored for that channel or any of its threads or forum posts. The bot reads each channel's history back to its first message when it is set up, and stores every new message as it arrives, so for a channel it can read this is usually the same as Discord's own. A message deleted since still counts: somebody wrote there then.

It differs from Discord's own in three cases:

  • A channel the bot cannot read has no time, even though Modbot may hold older messages from before: Can't read shows instead.
  • Message retention. If you set Discord messages to be deleted after a while (see Data retention), a channel quiet for longer than that shows No messages.
  • A read that has not started yet. A channel the bot has not got to reading back, or one it was only just able to see, may show a later time or No messages until its history has been read. Still reading covers only a read that has begun.

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