GroupFinds
Discord bot

GroupFinds Bot Commands

Every slash command the bot has registered with Discord — 25 in total, 18 anyone can run and 7 for server admins.

Add the bot to your server

Generated from the bot's registered commands · last published 1 November 2026

What the bot actually does

Counting invites is easy. GroupFinds counts the ones that mattered — and the person who brought them answers for it.

The inviter answers for who they bring

Arrivals stay tied to the member whose link they used. If somebody they brought is banned, kicked, or timed out for longer than the owner’s minimum, within the window the owner sets, that is recorded as a strike against the inviter. Enough strikes and their inviting pauses for a while.

Leaving is never a strike — people drift away from servers and that is not the fault of whoever invited them. Only a moderator acting on somebody counts, the owner chooses which of bans, kicks and timeouts count at all, and strikes are counted from the end of the last pause, so a penalty that has been served is over.

Invites that only count when they work

An invite pays when the person arrives, again if they are still in the server after the stay window the owner sets, and again the first time they are in a voice call. Arriving is easy; staying is harder; joining a call is the thing that turns somebody into a member.

Levelling that rewards showing up

XP for messages and for time in voice, with roles that grant and remove themselves, and optional decay so a leaderboard reflects who is around now. Existing progress can be imported.

Camera-required voice channels

Where an owner has turned it on, somebody who joins one of the chosen voice channels without a camera is asked to turn it on, and is moved or muted if they do not. It applies only to the channels the owner picks.

Poach-watch: evidence, never a verdict

Patterns that look like somebody recruiting out of a server are posted to the moderators’ channel with the accounts and the timestamps. It never bans, kicks, mutes or accuses anybody — every decision stays with a human.

Every threshold, window and reward above is set by the server owner, and each of these features is off until an owner turns it on.

Member commands

Anyone in the server can run these.

/event-report Everyone

Get the attendance report link for this server’s events (event hosts only, private)

/event-report
/gf-clout Everyone

Hours in calls across every server, for everyone who published them

/gf-clout
/gf-compare Everyone

Compare two members head to head

/gf-compare @user1 @user2
  • user1 user required First user
  • user2 user required Second user
/gf-help Everyone

How this works, and where you stand

/gf-help
/gf-highlights Everyone

Server recap as a card (7d / 30d / all-time)

/gf-highlights
/gf-invite Everyone

Get your own invite link for this server

/gf-invite [new-link]
  • new-link true/false optional Replace your current link with a fresh one. The old one stops working
/gf-invites Everyone

Who has brought people to this server who stayed

/gf-invites
/gf-me Everyone

Your stats as a rendered card

/gf-me
/gf-missing Everyone

People you used to share calls with who have not been around

/gf-missing
/gf-passport Everyone

Join a new server and your hours and time in your servers speak for you; no need to type an intro.

/gf-passport [action]
  • action text optional Leave empty to see your Passport, or pick what to do
/gf-predict Everyone

When will you level up?

/gf-predict
/gf-recap Everyone

Your last 30 days in this server, as a card you can share

/gf-recap
/gf-report Everyone

How this server compares with the servers like it, read from Discord.

/gf-report
/gf-server Everyone

Server analytics dashboard as a card

/gf-server
/gf-top Everyone

Server leaderboard (voice-ranked) as a card

/gf-top
/gf-user Everyone

View any member's profile card

/gf-user @user
  • user user required User to view
/gf-vibe Everyone

Live server pulse — who's around right now

/gf-vibe
/gf-wall Everyone

All-time hall of fame + server records

/gf-wall

Admin commands

Discord hides these from members without the required permission — they only appear for admins and owners.

/gf-admin Admin

Admin controls

/gf-admin [status] [weights] [xp] [sync] [levelling] [backfill]
  • status subcommand optional Show current bot config
  • weights subcommand optional Set voice/text XP split
  • xp subcommand optional Adjust user XP
  • sync subcommand optional Sync settings from groupfinds.com
  • levelling subcommand optional Enable or disable levelling system
  • backfill subcommand optional Count the messages from the 30 days before GroupFinds joined (once per server)
/gf-migrate Admin

Bring your levels over from MEE6 or another levelling bot. Shows a preview first. (owner or Administrator)

/gf-migrate
/gf-migrate-roles Admin

Admin: give tier-role holders their level floor — non-destructive, safe to re-run.

/gf-migrate-roles
/gf-passport-server Admin

Passport settings for this server (staff)

/gf-passport-server [cards] [channel] [nameable] [invites-channel] [invites-paused] [in-calls] [honour] [honour-role] [honour-hours] [honour-months] [honour-account-months] [clout-board]
  • cards true/false optional Arrival and activity cards. Paused in every server while The Tavern rollout runs
  • channel channel optional The channel Passport cards go to
  • nameable true/false optional Let members show this server’s name on their Passport (owner only)
  • invites-channel channel optional The Tavern only: where Passport invitations go (server owner)
  • invites-paused true/false optional The Tavern only: pause or resume Passport invitations. Owner only
  • in-calls true/false optional Privately list members in voice calls now who could be invited. Nobody is tagged
  • honour true/false optional Honour Passports: someone new can show their record and get a role straight away
  • honour-role role optional The role a visitor gets. Never a role that can act on other members
  • honour-hours number optional Least hours in voice calls their Passport must show. 0 for no minimum
  • honour-months number optional Least months they must have been on servers. 0 for no minimum
  • honour-account-months number optional Least months old their Discord account must be. 0 for no minimum
  • clout-board true/false optional Allow /gf-clout here: hours in calls across every server, for people who published them
/gf-preview Admin

Owners: see what an automation card will look like, using live server data

/gf-preview <recipe>
  • recipe text required Which automation card to preview
/gf-setup Admin

Set up levelling, roles, decay, penalties, rewards and announcements (owner or Administrator)

/gf-setup
/gf-status Admin

Is GroupFinds working in this server? (staff only)

/gf-status

Quick reference

CommandWhat it doesWho
/event-report Get the attendance report link for this server’s events (event hosts only, private) Everyone
/gf-admin [status] [weights] [xp] [sync] [levelling] [backfill] Admin controls Admin
/gf-clout Hours in calls across every server, for everyone who published them Everyone
/gf-compare @user1 @user2 Compare two members head to head Everyone
/gf-help How this works, and where you stand Everyone
/gf-highlights Server recap as a card (7d / 30d / all-time) Everyone
/gf-invite [new-link] Get your own invite link for this server Everyone
/gf-invites Who has brought people to this server who stayed Everyone
/gf-me Your stats as a rendered card Everyone
/gf-migrate Bring your levels over from MEE6 or another levelling bot. Shows a preview first. (owner or Administrator) Admin
/gf-migrate-roles Admin: give tier-role holders their level floor — non-destructive, safe to re-run. Admin
/gf-missing People you used to share calls with who have not been around Everyone
/gf-passport [action] Join a new server and your hours and time in your servers speak for you; no need to type an intro. Everyone
/gf-passport-server [cards] [channel] [nameable] [invites-channel] [invites-paused] [in-calls] [honour] [honour-role] [honour-hours] [honour-months] [honour-account-months] [clout-board] Passport settings for this server (staff) Admin
/gf-predict When will you level up? Everyone
/gf-preview <recipe> Owners: see what an automation card will look like, using live server data Admin
/gf-recap Your last 30 days in this server, as a card you can share Everyone
/gf-report How this server compares with the servers like it, read from Discord. Everyone
/gf-server Server analytics dashboard as a card Everyone
/gf-setup Set up levelling, roles, decay, penalties, rewards and announcements (owner or Administrator) Admin
/gf-status Is GroupFinds working in this server? (staff only) Admin
/gf-top Server leaderboard (voice-ranked) as a card Everyone
/gf-user @user View any member's profile card Everyone
/gf-vibe Live server pulse — who's around right now Everyone
/gf-wall All-time hall of fame + server records Everyone

Getting started

1

Add the bot

Invite GroupFinds to your server with the button above.

2

It starts tracking

Messages and voice time are recorded from the moment it joins. Nothing to switch on.

3

Try a command

Type /gf-help in any channel to see what is available.

4

Tune it

XP weights, level roles and decay are set on your dashboard on groupfinds.com, or with /gf-setup in Discord (server owner or Administrator).

Frequently asked questions

How is XP calculated?

The owner sets how much a message is worth, how much a minute in voice is worth, and the cooldown between messages that earn. Reply and reaction bonuses can be switched on separately. (Until 2026-09-20 this page named specific rates; they matched no live server, because the rates are a setting.)

What are the level thresholds?

Level = floor(√(XP ÷ 100)) + 1, the same curve in every server. Level 1 starts at 0 XP, level 2 at 100, level 3 at 400, level 4 at 900, level 5 at 1,600 and level 10 at 8,100.

Can I customise the leaderboard?

Members see the leaderboard with /gf-top and their own standing with /gf-me. The leaderboard channel and update frequency on the dashboard are saved, but the bot does not post a leaderboard in a channel yet.

How do I set up level roles?

In the dashboard under Leveling System, Role Rewards. Assign one or more Discord roles per level, and choose whether earlier rewards are removed when a member levels up.

What is XP decay?

Decay slowly reduces XP for inactive members so the leaderboard reflects who is active now. You set the inactivity period, the amount (a percentage or a flat number), how often it runs, a minimum XP floor it will never take someone below, and any exempt roles.

Can members lose XP for breaking the rules or leaving?

Yes. You can also take XP away for each timeout a moderator gives, and reset a member's XP to zero if they leave, are kicked or are banned. Each is a setting in the dashboard.

What does levelling cost?

Nothing. Every levelling feature is free, including XP tracking, level role rewards, the timeout penalty, the leave reset and XP decay.

How do invite rewards work?

Members earn XP and roles for inviting people who stay for a minimum number of days. Tiers let you increase the reward as invite counts grow. Invite rewards are optional and off until you turn them on, and they need one permission the bot does not ask for when it is added: the GroupFinds role needs Manage Server, because Discord only shows a bot which invite link each new member used when it has that permission. GroupFinds uses it only to look at your invite links and how many times each one was used. It never uses it to change your server name, icon, channels, roles or settings, and Manage Server does not let a bot ban, kick or time out anyone. To give it: open Server Settings, then Roles, then the GroupFinds role, turn on Manage Server, and press Save Changes.

Can I exclude channels from XP?

Yes. Exclude any channel under Leveling System, XP Settings — useful for bot-spam and off-topic channels.

Where do the commands on this page come from?

The bot publishes its registered slash commands every time it starts, and this page is generated from that list when the site builds. It shows what the bot actually has, not a description of it.