Built in 39 commands 15 settings

Group Finder: Set it up

In short

Run one command or click one button and Group Finder makes its channels. Then post a test group to check it works.

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. A server owner or a member with Manage Server can do every step below.

1. Check the bot can create channels

Give the bot Manage Channels in the server, so the setup wizard can create its channels. To use channels you already have instead, skip to step 4.

What the wizard needs

The wizard creates a category, a text channel and a forum channel. Without Manage Channels it stops before changing anything and asks you to grant the permission.

2. Turn on Group Finder

Open the dashboard, choose the server, open Services and switch Group Finder on. The wizard in step 3 also switches it on, so you can skip this step.

3. Run the wizard

In Discord, type /group setup. Or, on the dashboard, open Group Finder from Services and click Set it up for me on Home.

What the wizard creates
  • A Group Finder category.
  • #lfg-listings, where everyone reads and only the bot posts. The wizard posts a welcome card there.
  • #lfg-forum, with a tag for each game your channel and role names mention, plus Raid, Dungeon, PvP, Social, Arena, Fresh, Prog, Farm, Learning and Chill.

The wizard also sets the channel permissions, saves both channels, makes every new group open its own thread in the forum and creates starter templates. Rerunning it reuses channels and templates that already exist.

Where else to run it, and failed steps
  • While nothing is set up, Home says so, and Set it up for me asks you first, then runs the wizard.
  • The same wizard is under Setup and health at the bottom of Settings, as Set up Group Finder.
  • 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. Optional: choose the channels 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.

The Where groups are posted card in Group Finder's Settings: Cards in a channel or A thread per group, in a forum, with the channel and forum to use.
1: every group as a card in one channel. 2: every group as its own forum thread. 3: the channel the cards go to.
Posting with no channel, and the defaults

Where groups are posted is the only setting that matters for posting. With no channel set:

  • the first /group create adopts the channel it was typed in
  • a group made with New group on the dashboard is not posted in Discord

The other settings start with these defaults:

  • 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
  • a chat for every group

5. Optional: decide who gets told

On the same page, under Who gets told, pick a Channel for alert mentions and a Channel for reports. Turn on Ping this role on every new group and Game pings if you want them.

What each one does
  • 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.
  • 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. Then look for the card.

The reply and the card

The reply in Discord is **{title}** is live!, or posted to #channel when the card went elsewhere.

The card shows the title with how many players are wanted, the leader, the group size and the time left. It has 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. Test it with a second member

Have a second member press Join on the card. The card updates with their name. Then press Done on the card or run /group close to end the group.

Other ways to join, and what ending does
  • A member can also run /group join and pick the group, or join from the group's page.
  • /group browse and Find a group list the group.
  • When the group ends, the card switches to closed and the chat turns read-only. With a thread per group, the thread is locked and archived.

8. Check the summary

Run /group-admin settings to see the channels and limits the bot is using.

Reading the summary, the dashboard check and templates

A channel shown as a dash 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. By default Discord hides the /group-admin commands from members without Manage Server.

If you use the Balanced or Locked down preset

/group noshow, /group approve, /group deny and /group report sit in the moderation category. Applying the Balanced or Locked down preset therefore 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.

What members see on the dashboard

Members with the Viewer role see Home, Find a group, My groups and New group. The other pages are for managers.

If something does not work, see Troubleshooting.

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
Was this page helpful?
YourBot docs Reference tables are generated from the code that is running. Ask in Discord