Generated15 settings
Group Finder settings
The Group Finder settings, from the typed spec the dashboard form and the AI server builder share. Accepted range is what the settings writer takes; where the form or the service is stricter, the description says so. Controls that exist only on the dashboard form are listed at the end.
| Setting | Type | Accepted range | What it does |
|---|---|---|---|
| Settings: Where groups are posted | |||
Channellisting_channel_id |
channel | The channel every new group is posted in while How groups are posted is Cards in a channel. Not required: the first /group create on a server with no channel posts in the channel it was typed in and makes that channel this one, while a group made with New group on the dashboard is not posted in Discord. /group quick and /group bump also post here. While A thread per group, in a forum is picked, new groups go to the forum instead, and some posts still fall back to this channel when the forum cannot be reached. The dashboard health check flags group posting while this is empty or points at something deleted. | |
Forumforum_channel_id |
forum channel | The forum used while How groups are posted is A thread per group, in a forum: each new group opens its own thread there. Only forum channels can be picked. The dashboard health check flags group finder forum while this is empty or points at something deleted. Only checked when auto forum threads is on. | |
How groups are postedauto_forum_threads |
on or off | Cards in a channel (off, the default) posts every new group in the channel picked below it. A thread per group, in a forum (on) opens a thread for each new group in the forum, tagged by game, activity and level when the forum has tags with those names; people plan in the thread and it is locked and archived when the group ends. While a forum is set and this is on, groups from /group create, /group quick, /group relist and New group are posted in the forum only. | |
| Settings: Who gets told | |||
Channel for reportslog_channel_id |
channel | The bot posts a line here each time a member reports a group, with /group report or on the group's page. Nothing else is posted there. The dashboard health check flags group finder report channel while this is empty or points at something deleted. | |
Channel for alert mentionsalert_channel_id |
channel | For members who chose to be mentioned in a channel for their alerts, with /group-alerts add or under My alerts on Find a group. With none picked, those alerts are not sent. The dashboard health check flags group finder alert channel while this is empty or points at something deleted. | |
Ping this role on every new groupping_role_id |
role | A role mentioned when a group is posted or bumped, at most one ping every 10 minutes for the whole server; a group posted in between gets no ping. Members cannot mute it through the bot; they leave or mute the role in Discord. /group-alerts pings controls game ping DMs, not this role. The dashboard health check flags group finder ping role while this is empty or points at something deleted. | |
| Settings: Rules for starting a group | |||
Open groups per membermax_active_per_user |
whole number | 1 to 20 | How many open or full groups one member can lead at once on this server, 1 to 20. Default 3. Checked by /group create, /group quick, /group relist and New group on the dashboard. |
Every leader lets people in by handrequire_approval |
on or off | New groups get an Apply button, not Join, and the leader says yes or no to each person, even when the leader picked Anyone can join. Off by default: each leader chooses for their own group. Applies to /group create, /group quick, /group relist and New group. | |
Minimum account age in daysmin_account_age_days |
whole number | 0 to 365 | Discord accounts younger than this many days cannot start groups, 0 to 365. 0 turns the check off. It never stops anyone from joining. |
Seconds between two groupscooldown_seconds |
whole number | 0 to 3600 | Seconds a member must wait between starting two groups, 0 to 3600. Default 60. 0 turns the wait off. |
Blocked wordskeyword_blocklist |
list of text | up to 20 entries of 40 characters | Words that are not allowed in a group's title or description. A group containing one is refused by /group create, /group quick and New group, and a change on the group page that adds one is refused too. Matching ignores case and matches inside longer words. Up to 50 words of at least 2 characters. Empty by default. |
| Settings: What a new group starts with | |||
Hours a group stays open unless its leader picks another lengthdefault_expiry_hours |
whole number | 1 to 168 | Hours a group stays open when its leader does not pick a length, 1 to 168. Default 4. New group starts with it, and picking a template or a quick start there sets theirs instead. /group create uses it when the hours are left blank, unless the template has a length of its own; /group quick uses the length of its quick start. |
The longest a group can stay open, in hoursmax_expiry_hours |
whole number | 1 to 720 | The most hours a group can stay open, up to 720. Default 48. Caps /group create, /group quick, /group relist, New group and the window of each repeating run. When the time is up the group closes by itself. |
Levelsexperience_levels |
list of text | up to 8 entries of 24 characters | The levels New group, Find a group and the alerts on the dashboard offer, up to 8 of 24 characters each. Default Fresh, Prog, Farm, Learning, Chill. The /group create slash command keeps its fixed list (Fresh, Prog, Farm, Learning, Chill) whatever is set here. |
| Other servers: The public page | |||
Members can put a group on the public pageallow_cross_post |
on or off | Lets a leader who picks The public page (Public in /group create) put the group on the server's public page and the all-servers board, and share it with every partner network this server is in. Off by default; while off, such a group is shared with partner servers only. Sharing with partner servers itself depends on network membership and never needs this switch. | |
Also on the dashboard form
Game pings Settings, Who gets told. When a group with a game is posted, DM members who joined a group for the same game on this server lately, and, for a group the bot posts itself (not one from the dashboard) where the bot can see presence, members playing it right now. One ping per member per game every eight hours, at most 25 for one group, and every DM carries a Stop these pings button. Members opt out per server with /group-alerts pings or under My alerts on Find a group. /group quick and /group relist send none. Off by default.
Days game pings look back Settings, Who gets told. How many days back a member's groups count when Game pings look for people who played a game lately. Default 14, 1 to 90.
Group chat Settings, What a new group starts with. Every group gets a chat (the default), or Only groups shared with other servers. The chat is on the group's page, for the leader and the people in the group or on its waiting list. It turns read-only when the group ends and is deleted 24 hours later. A group that was running before a change gets its chat when its page is opened.
Not in this table
Things with their own editor in the dashboard, such as rules, panels, templates and schedules, are described on the overview page under In the dashboard. Internal state is not a setting.
YourBot docs
Reference tables are generated from the code that is running.
Ask in Discord
Suggest a correction