Docs / Core Services / Group Finder
Built in Service id group_finder 39 commands 15 settings

Group Finder

Members post what they want to run, with roles and a start time, and others join with one click, in Discord or on the group's own page. A group can stay in your server, be shared with partner servers or go on the public page, and by default every group gets a live web chat.

Turn it onDashboard, Services, Group Finder, switch to Enabled
First stepRun setup
PlanEvery feature included for every server: unlimited templates

Set it up

The dashboard's health check expects: Channel. It shows a warning while one of these is missing or points at something deleted. The steps below say what each one does.

Group Finder lets members post a group they are recruiting for, join with one click, and get told when a matching group appears. Setting it up takes one command or one click. Every step below can be done by a server owner or a member with Manage Server.

  1. Check the bot can create channels. The setup wizard creates a category, a text channel and a forum channel, so the bot needs Manage Channels in the server. Without it the wizard stops before changing anything and asks you to grant the permission. If you would rather point Group Finder at channels you already have, skip to step 4.

  2. Turn the service on. Open the dashboard, choose the server, open Services and switch Group Finder on. You can skip this step when you use the wizard in step 3; switching the service on is one of the wizard's own steps.

  3. Run the wizard. In Discord, type /group setup. On the dashboard, open Services, then Group Finder: while nothing is set up, Home says so and Set it up for me runs the wizard after asking you first. The same wizard is under Setup and health at the bottom of Settings, as Set up Group Finder. The wizard detects the games your channel and role names mention, creates a Group Finder category with #lfg-listings (everyone reads, only the bot posts) and #lfg-forum (one tag per game plus Raid, Dungeon, PvP, Social, Arena and Fresh, Prog, Farm, Chill), sets the channel permissions, saves both channels, makes every new group open its own thread in the forum, creates starter templates, and posts a welcome card in #lfg-listings. Rerunning it reuses channels and templates that already exist. The final card in Discord lists each step with a check mark or a cross; a cross means that step failed, so read the lines rather than the title.

  4. Or configure by hand. On the dashboard open Services, Group Finder, Settings. Under Where groups are posted, pick Cards in a channel and a Channel, or A thread per group, in a forum and a Forum. That is the only setting that matters for posting; with no channel set, the first /group create adopts the channel it was typed in, and a group made with New group on the dashboard is not posted in Discord. Everything else has a working default: 3 open groups per member, groups open 4 hours by default and 48 at most, 60 seconds between two groups, no minimum account age, no blocked words, anyone can join, and a chat for every group.

  5. Decide who gets told. On the same page, under Who gets told: a Channel for alert mentions is needed only if members choose to be mentioned in a channel for their alerts; without it those alerts are not sent and /group-alerts add says so. The Channel for reports gets a line each time a member reports a group. Ping this role on every new group makes each new post mention that role, at most once every 10 minutes. Game pings DM members who lately joined a group for the same game.

  6. Post the first group. In any channel, run /group quick dungeon or /group create title:Test run, or use New group on the dashboard. The reply in Discord is **{title}** is live! (or posted to #channel when the card went elsewhere). Look for the card: it shows the title with how many players are wanted, the leader, the group size, the time left, and Join, Leave, Watch, Ready Check and Done buttons. With a thread per group, the card is the first post of a new thread in #lfg-forum. Every group also has its own page on the web, with who is in and the group chat.

  7. Confirm it works end to end. Have a second member press Join on the card, run /group join and pick the group, or join from the group's page. The card updates with their name, and /group browse and Find a group list the group. Then press Done on the card or run /group close to end it; the card switches to closed, the chat turns read-only and, with a thread per group, the thread is locked and archived.

  8. Check the summary. /group-admin settings shows the channels and limits the bot is using. If a channel shows as a dash, it is not set. Setup and health on Settings checks the same things on the dashboard, with a link to fix each one. /group-admin templates lists the templates members can pick in /group create, including the starter ones the wizard made.

  9. Decide who can run what. Open Services, Group Finder, Commands in the dashboard. /group-admin commands are hidden by Discord from members without Manage Server by default. /group noshow, /group approve, /group deny and /group report sit in the moderation category, so applying the Default preset limits them to your moderator roles even though members and leaders use them; give them a rule of their own if you want everyone to keep them. On the dashboard, members with the Viewer role see Home, Find a group, My groups and New group; the other pages are for managers.

4 optional features with their own switch
  • Forum: group finder forum (when auto forum threads is on)
  • Channel for reports: group finder report channel
  • Channel for alert mentions: group finder alert channel
  • Ping this role on every new group: group finder ping role

How it works

  1. Run setup. /group setup, or the setup button on the dashboard, makes the channel for groups, a forum, the permissions and starter templates in one go.
  2. Post a group. /group create, /group quick raid, or New group on the dashboard with a live preview of the post. Title, game, group size, roles, how long it stays open, region, platform, voice, who can join, language, level, who sees it and an optional start time.
  3. People join. Join, Leave and Watch buttons on the post, or a role menu when the group has roles, and the same on the group's own page. A full group takes a waiting list.
  4. Run it and close it. A ready check, a reminder 15 minutes before the start, a voice channel if the group needs one, then Done, which credits everyone and asks them to rate the leader.

Permissions the bot needs

Generated

The invite link grants these. If one is missing the service page in the dashboard shows a re-grant banner, and the affected commands say what they cannot do instead of failing silently. The Setup Check on the Bot page, or /yourbot check in Discord, lists everything the bot is missing across your services.

Manage ChannelsView ChannelSend MessagesEmbed LinksRead Message HistoryManage RolesManage ThreadsCreate Public Threads

What is included

GeneratedSee pricing

Every Group Finder feature is included for every server, on the shared bot and on custom bots. A subscription adds a custom bot identity and marketplace access, not features here.

FeatureIncluded
OverviewYes
View TemplatesYes
Create/Edit TemplatesYes
Browse ListingsYes
Listing DetailYes
Moderate ListingsYes
SettingsYes
AnalyticsYes
ReportsYes
Audit LogYes
SuspensionsYes
NetworksYes
Limits
TemplatesUnlimited

Commands

GeneratedEvery command in detail
CommandWhat it doesWho by default
/group
/group setupAuto-setup Group Finder for this serverServer managers
/group createCreate a new group listingEveryone
/group browseBrowse active group listingsEveryone
/group joinJoin a group listingEveryone
/group leaveLeave a group listingEveryone
/group my-listingsView your active group listingsEveryone
/group closeClose one of your active listingsEveryone
/group noshowReport a member who didn't show up to your groupModerator roles
/group reinviteDM your recent teammates about your latest groupEveryone
/group pollLet members vote on when one of your groups should runEveryone
/group repeatMake one of your groups repeat on a schedule, or stop itEveryone
/group relistRelist a previously closed or expired groupEveryone
/group watchWatch a listing for join/leave/close updatesEveryone
/group watchingList all listings you're watchingEveryone
/group editEdit the title or description of your listingEveryone
/group applyApply to join an approval-required listingEveryone
/group approveApprove an applicant for your listingModerator roles
/group denyDeny an applicant for your listingModerator roles
/group bumpRe-post your listing to make it visible again (1h cooldown)Everyone
/group reportReport a listing or its leaderModerator roles
/group quickQuick-create a group from presets (e.g. mythic+ 15)Everyone
/group-admin
/group-admin settingsView current Group Finder settingsServer managers
/group-admin templatesList Group Finder templates for this serverServer managers
/group-admin close-listingForce-close any active listingServer managers
/group-admin statsShow Group Finder statistics for this serverEveryone
/group-admin reportsView open reports for this serverServer managers
/group-admin suspendSuspend a user from creating listingsServer managers
/group-admin unsuspendLift a user's listing suspensionServer managers
/group-admin suspensionsList all active posting suspensionsEveryone
/group-admin network createCreate a new federation networkServer managers
/group-admin network joinJoin an existing federation networkServer managers
/group-admin network leaveLeave a federation networkServer managers
/group-admin network listList all networks this server belongs toEveryone
/group-admin network set-visibilityUpdate outbound/inbound visibility in a networkServer managers
/group-alerts
/group-alerts addSubscribe to alerts for new group listingsEveryone
/group-alerts listView your active alert subscriptionsEveryone
/group-alerts removeRemove an alert subscriptionEveryone
/group-alerts clearRemove all your alert subscriptionsEveryone
/group-alerts pingsTurn game pings from this server on or off for youEveryone

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 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.
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, 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.

Questions

Can members from other servers join my group?

Only if you share the group. A group shared with partner servers can be joined from every server in the network. On a group that is on the public page, anyone else signed in can ask to join from its group page, and the leader says yes or no.

Does a group post to other servers automatically?

No. This server only is the default. The leader picks partner servers or the public page for each group, and the public page also needs your server to allow it.

What happens when the group is full?

The post shows full, new joiners go on the waiting list if it is on, and if the group needs voice the bot creates a voice channel sized to the group.

Can I run the same raid every week?

Yes. On New group, set a start time and post it again every week, or use /group repeat weekly. The next run posts once the last one has ended, no earlier than 72 hours before it starts, up to 52 runs.

How do alerts work?

Subscribe to a game, activity, level, region or platform and get new groups by DM, in a channel or as one digest an hour, with quiet hours if you want them.

Can I put groups on my website?

Yes, the ones on the public page. Every server has a public page and an embeddable widget with dark and light themes that refreshes every minute. Groups kept to your server or shared with partner servers only never appear there.

YourBot docs Reference tables are generated from the code that is running. Ask in Discord Suggest a correction