Built in 39 commands 15 settings

Group Finder: Features

Everything it does

Groups

A group is a Discord post that keeps itself up to date, with a page of its own on the web.

Everything a group needs. Title, game, description, group size from 2 to 40, how long it stays open, region, platform, voice required, whether anyone can join or the leader lets people in, language, level, who sees it and a start time up to 14 days out.
Quick starts. /group quick with mythic+, raid, arena, dungeon or pvp fills sensible defaults, and arena detects 2v2 and 3v3 brackets. It also posts from your server's own quick starts.
Templates and quick starts. Reusable templates with named roles, emoji and a cap per role, your colours and pictures, plus the quick starts /group quick posts from. The five built-in templates can be copied and changed.
Change, bump, relist, close. Change the title, description or size, bump once an hour to post it again, relist a closed run as a fresh copy, or close it. Managers can close any group.
Forum threads. Optionally every group opens its own forum thread for coordination, locked when the group closes.
Groups that end on time. Every 30 seconds the groups whose time is up are closed: the post is redrawn, the thread locked, the voice channel deleted and the chat made read-only, and the leader, the members and the watchers get a DM.

Joining

Seats are counted properly, and leaders can choose who gets one.

One click or a role pick. Join and Leave buttons, or a menu of roles when the group has them, in Discord and on the group page. Members can switch roles.
Capacity that holds. Joins are checked under a database lock, so two people cannot take the last seat at once.
Waiting lists. A full group takes a waiting list, and the first person on it moves up when someone leaves.
Leaders who let people in. A leader can let people in by hand: people ask with an optional 200 character note, and the leader says yes or no in Discord or on the group page. A server setting can make every leader do this.
Removed means removed. A member removed from a group cannot rejoin or ask again. Someone who left on their own can.
Watch a group. Get DM updates on a group you are not in.

Finding groups

Look for a group, subscribe or let the bot find you.

Filters. /group browse filters by game, activity, region and platform, sorted by newest, expiring soon or closest to full, eight per page. Find a group on the dashboard filters by game, activity, region and level.
Games you have played first. Find a group can show groups for games you have joined before at the top.
Alerts. Filtered alerts for new groups by DM, as a mention in a server channel or as an hourly digest, with quiet hours and a cap of 5 per hour. Set them with /group-alerts add or on Find a group.
Game pings. Off by default. When on, a new group DMs people who joined a group for that game in the last 14 days, and for a group posted in Discord also people playing it right now when the bot can see presence, up to 25 per group and once per member per game every 8 hours, each with a Stop these pings button.
A role ping. Optionally ping a role on every new group, at most once every 10 minutes.

Scheduling

For the runs that happen at a time, not right now.

Start times and reminders. Set a start time when you post, or a clock time on New group, and members get a reminder about 15 minutes before.
Time polls. Propose 2 to 5 start times with /group poll, members vote with buttons, and the winner becomes the group's start time.
Repeating runs. Daily, weekly, every two weeks or monthly, up to 52 runs. The next run is posted once the last one has ended, no earlier than three days before it starts, and missed runs are skipped rather than made up.
Calendar links. A group with a start time carries an ICS download and a Google Calendar link, on its post and on its group page.

During and after

Getting the group in, and remembering how it went.

Ready checks. The leader posts a tally and members click Ready or Not Ready, tracked for five minutes. The group chat has a ready check of its own.
Auto voice. When a group that needs voice fills, the bot creates a voice channel sized to the group under the group channel's category, and removes it when the group is done.
Done and rated. Marking a group done, in Discord or on the group page, adds it to everyone's finished groups and DMs each member a thumbs up or down for the leader. The score shows after 3 votes, and only totals are ever shown.
No-shows and reinvites. Leaders can flag a no-show, and /group reinvite DMs recent teammates about a new run.
Your record. Groups joined and finished, how many of your past groups were marked done and their average size, your thumbs up and your no-shows, on the Past tab of My groups.

Sharing across servers

Groups from partner servers, and yours on theirs. Opt-in at every step.

Partner networks. Start a network and share its code, or join one, with separate switches for your groups showing there and their groups showing here.
Live copies. A group shared with partner servers appears as a working post on every partner server, posted by that server's own bot. Joins, leaves and completion update every copy.
Groups looking for players. When your server lets members put a group on the public page, it also shows on the all-servers board at /lfg, which anyone can open without logging in. A signed-in visitor opens the group's page: someone in a server the group reaches joins there, anyone else asks to join with a note, and the leader gets a DM and answers on the group page.
Your own public page and widget. Every server gets a public page and an embeddable widget for your website that refreshes every 60 seconds. They list only the groups on the public page, yours and your partner servers'.
A chat for every group. By default every group gets a live web chat on its page, with markdown, mentions, reactions, pins, edits within 5 minutes and its own ready check. A server can limit chats to groups shared with other servers. The chat turns read-only when the group ends and is deleted 24 hours later.

Moderation

Reports, suspensions and rules that run before a group posts.

Reports. Members report a group or its leader, and managers answer on the Safety page: dismiss it, close the group or close it and suspend the leader for a length they pick.
Suspensions. Stop a member from starting groups for 1 to 720 hours with a reason, on the Safety page or with /group-admin suspend. They can still join groups. Suspensions are per server.
Rules before posting. Up to 50 blocked words, a minimum account age, a cap on open groups per member and a wait between two groups.

In the dashboard

Home What needs you (people asking to join, a group that starts soon and is not full, open reports), the groups running now and coming up, setup and the slash commands.
Find a group Every running group this server can see, with filters, and My alerts with the game pings switch.
My groups The groups you lead, the ones you are in or wait for, and your past groups with your record.
New group Start from a template or a quick start, pick roles and your own role, a clock time and a repeat, then see the post as members will before you post it.
The group page One page per group, for members too: who is in, join, switch role, leave, watch and report, the leader's tools (let people in, remove, change, bump, mark done, close) and the group chat.
Templates Templates with roles and your look, with the post shown live while you edit, and the quick starts /group quick posts from.
All groups Every group of the server, running, full or ended, with a search, and Close on any of them.
Safety Reports, suspended members and Suspend someone, and the rules that stop a group before it posts.
Other servers Partner networks with their two switches, the public page switch and the public page's address and website widget code with a dark and a light theme.
Insights The numbers (groups started and filled, the games played most, how groups end, the busiest hours, the templates used) and the activity log.
Settings Where groups are posted, who gets told, the rules for starting a group, what a new group starts with and the group chat, plus setup and health.

Settings

GeneratedAll 15 settings
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 also posts here, and /group bump does while How groups are posted is Cards in a channel. 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.
Channel for reports 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.
Channel for alert mentions 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.
Forum 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.
How groups are posted 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.
Ping this role on every new group A role mentioned when a group is posted, or bumped in a channel, 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.

Runs on its own

A 30-second loop. Closes the groups whose time is up and tells their people, purges old chats, redraws running groups after a template edit, sends start reminders, posts the next repeating run and sends the hourly alert digests.
Fan-out on post. Alerts and game pings go out the moment a group is posted with /group create or New group, or a repeating group posts its next run. /group quick sends the alerts. Copies on partner servers go out at the same time.
Rate limits built in. One role ping per 10 minutes, 5 alerts per member per hour, and 15 network broadcasts per minute per server.

Limits

WhatValueNotes
Group size2 to 40
Open groups per member1 to 20Default 3.
Time between two groups0 to 3,600 sDefault 60.
How long a group stays openup to 720 hDefault 4 h, longest 48 h unless you raise it.
Default time open1 to 168 hDefault 4.
Minimum account age0 to 365 daysDefault 0, which is off.
Start timeup to 14 days ahead
Bumponce an hour
Repeating series52 runsThe next run posts no earlier than 72 h before it starts.
Time poll options2 to 5
Alerts per member5 per hourDigests go out once an hour.
Game pings25 per groupOnce per member per game every 8 hours.
Game ping look-back1 to 90 daysDefault 14.
Blocked words50 words
Suspension1 to 720 hPer server.
Chat message1,000 charactersEdit or delete within 5 minutes.
Widgetup to 25 groupsRefreshes every 60 s.

Safety

This server by default. A group stays in your server unless its leader shares it with partner servers or puts it on the public page, and the public page also needs your server to allow it.
Partners cannot reach in. A button on a copied group re-checks that the group is still shared with that server before acting.
Anonymous ratings. Only totals are ever shown, never who voted.
No smuggled pings. Report notices never mention roles or everyone, whatever a group title contains.
Chat is checked live. A removed member's chat connection is closed on the next roster update, and every chat action is scoped to its own group.
Visitors join only where they belong. On the web a signed-in visitor joins a group only when they are in a server it reaches. Everyone else asks, and the leader decides.
Your command rules apply. Your per-command role, channel and cooldown rules apply to every command, to the role menu and to the Join, Waitlist, Leave, Watch and Apply buttons.

What it does not do

  • No matchmaking or skill rating. Reputation is a thumbs-up percentage.
  • No account linking for PSN, Xbox or Steam, and no game invites.
  • Suspensions do not follow a member across a network.
  • The auto voice channel is a plain Discord channel, not a join-to-create room.
  • No email or push alerts. Alerts are DMs, a channel, or a DM digest.
  • Putting games you have played first is on the dashboard only.
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord