Creates a group listing and posts its card. Only title is required. If Group Finder is switched off for the server the reply is Group Finder is not enabled on this server.
Before anything is created the command runs the server's anti-abuse checks, in this order. Each one stops the command with a private reply.
- Minimum account age (off by default). Accounts younger than the limit see
Your account is too new to post hereand the number of days required. - Posting suspension. A suspended member sees
You are suspended from posting listings on this server untilfollowed by when it lifts and the reason. - Active listings per member (default 3, counting your open and full listings on this server):
You already have {count} active listing(s) (max {max}). - Create cooldown (default 60 seconds since your last listing here):
You can create another listing in **{secs}s**. - Blocked words, checked case-insensitively against the title and description together:
Your listing contains a blocked keyword and cannot be posted.
Options are then resolved. A template supplies its party size and expiry when you left size at 5 and hours at 4, fills in game when you left it blank, and adds its role slots to the listing. If hours is still 4 the server's Default expiry applies. Hours are then held between 1 and the server's Longest expiry (default 48), and size between 2 and 40. When the server has Leaders approve joins on, every listing uses approval mode whatever join_mode says. Choosing visibility Public on a server without Allow cross-posting creates a Network listing instead. For Network listings, networks picks which of the server's networks receive it; blank or ALL means every network the server is in, and IDs that are not among the server's networks are ignored.
start is a time from now such as 30m, 2h, 1h30m or 1d, up to 14 days out. Text the bot cannot read leaves the listing unscheduled without a warning. A scheduled listing shows its start time, calendar links, and about 15 minutes before it starts the bot DMs every joined member and every watcher a reminder. repeat needs a start time; without one the reply is A repeating group needs a start time. Add \start` (for example 2h or 1d) and try again. repeat_count` is held between 0 (until you stop it) and 52.
You are added to the listing as its leader. The card shows the title with how many more players are wanted, the game, the leader, a member list and, once the leader has three or more teammate ratings, their rating. Its buttons are Join (or a role picker when the template has role slots, or Apply for approval listings), Leave, Watch, Ready Check and Done; a Waitlist button appears once the group is full.
Where the card goes depends on the channel settings. With a forum channel set and Create forum threads on, the listing becomes a forum thread tagged by game, activity and difficulty, and the reply is **{title}** posted to <#channel>! naming the forum. Otherwise the card is posted in the listing channel, or in the channel you typed in when no listing channel is set. In that last case the channel becomes the listing channel from then on and the reply adds This channel is now your listing channel. Run \/group setup` any time for the full layout.The normal reply is{title} is live!, or {title} posted to <#channel>!` when the card went to a different channel. If a Ping role is set, the post mentions it, at most once every 10 minutes per server.
Good to know
- After posting, members whose alert subscriptions match the listing are notified, and, when the server has Game Pings on, recent players of that game get a DM.
- Network and Public listings are shared to peer servers and get a cross-server event chat room.
- With
voiceon, the bot creates a voice channel named after the listing (user limit equal to the party size, in the listing channel's category) when the group fills, and deletes it when the listing ends. - Difficulty choices are Fresh, Prog, Farm, Learning and Chill. The Experience levels setting does not change this list; it only affects the dashboard's create form.