GroupFindsWhat it asks for
It joins your server as a bot and adds slash commands, like /gf-me and /gf-passport. Nothing else.
- See channels — Lets GroupFinds notice who is chatting and who is in a voice channel, so members earn XP.
- Send messages — Lets GroupFinds congratulate members when they level up, and post one welcome message when you add it.
- Read message history — Lets GroupFinds count the last 30 days of messages once, right after you add it, so your leaderboard is not empty on day one. It never keeps what anyone wrote.
- Manage roles — Lets GroupFinds hand out the roles you pick when members reach a level, and only roles below its own.
- Connect to voice channels — Discord treats a voice channel a bot cannot join as invisible to it, including the text chat inside it. GroupFinds never joins a call and never records audio; without this it simply cannot post or see anything in a voice channel.
After you add it
It starts working straight away, and silently. It posts nothing on arrival — GroupFinds speaks to a server once a week, in one card, and otherwise not at all. It never posts a reminder and never sends anyone a direct message. Try /gf-me whenever you like.
Coming from another levelling bot? Nobody starts again at zero. Run /gf-migrate and GroupFinds reads your old bot and your own level roles, shows you a preview before it writes anything, and undoes the whole thing for seven days. How bringing your levels over works.
Set it up in Discord. Anyone with the Manage Server permission can run /gf-setup and press Use recommended setup, or change levelling, level roles, XP decay, penalties, multipliers, automations, invite rewards and announcements one by one. These only change things inside your server.
Optional: list your server on GroupFinds. Nothing in your server needs this. A directory listing, public server page and events are shown outside your server, so the server owner sets them up on the website. List your server.
Invite rewards are optional and off until you turn them on. They need one permission the bot does not ask for when you add it.
Why a permission is needed: to reward the member who invited someone, GroupFinds has to know which invite link each new member used. Discord only shows a bot that when its role has the Manage Server permission. GroupFinds does not ask for it when it is added.
What it does not do: 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, or to make or delete invite links. Manage Server does not let a bot ban, kick or time out anyone.
How to give it: open Server Settings, then Roles, then the GroupFinds role, turn on Manage Server, and press Save Changes. Turn it off the same way whenever you like.
Only if you turn a feature on
Not asked for when you add it. When you switch one of these features on, GroupFinds tells you in Discord which permission to give, with a link that adds it in one step.
- Attach files — Only if you turn on celebration or weekly posts, or Passport cards, which are pictures. Cards in replies to commands work without it.
- Ban members — Only if you turn on “remove XP when banned”. Discord only tells a bot about bans when it has this. GroupFinds never bans anyone.
- Manage server — Only for invite rewards, because Discord only shows a bot which invite link each new member used when it has this.
- Mute members — Only if you turn on “camera required in voice calls”. It is how GroupFinds mutes someone until their camera is on, and unmutes them the moment it is.
- Deafen members — Only if you turn on “camera required in voice calls”, so someone with their camera off cannot listen in either.
- Move members — Only if you turn on “camera required in voice calls”. It is how GroupFinds takes someone out of a call when the camera never comes on. Nobody is ever kicked or banned.
What it keeps, and what it never keeps
What it keeps
- Per-server counts: minutes in voice calls, message counts, XP, level, and when a member joined or left that server.
- Server settings you choose on the dashboard or with /gf-setup, such as level roles and which channel gets cards.
- Passport fields, only for a member who switched them on, and only the ones they switched on.
What it never keeps
- What anyone writes. Message text is never saved.
- Voice or video. The bot never joins a call and never records audio.
- Direct messages.
- Any list of where a member was banned, timed out or kicked across servers. That is never built, not even privately.
- Passwords or login details.
Passport is the member’s choice
Nothing about a member travels from one server to another unless that member switches it on, field by field. A server’s name only appears on a Passport if the server owner allows it.
Add it
Opens Discord so you can pick a server. You can remove the bot at any time from your server settings.
What the bot does once it is in
The inviter answers for who they bring
If somebody a member invited is banned, kicked or timed out soon after arriving, that counts against the member who brought them.
Anyone can rack up an invite count by dragging in whoever will click. That number tells an owner nothing, because it does not distinguish the member who brought five people who stayed from the member who brought fifty who were banned by Friday.
So arrivals are tied to the member whose link they used, and it stays tied. If that person is banned, kicked, or timed out for longer than the owner's minimum, within the window the owner sets, it is recorded as a strike against the inviter. Enough strikes inside that window 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 is counted, and the owner chooses which of bans, kicks and timeouts count at all.
Strikes are counted from the end of the last pause, so a penalty that has been served is over rather than following somebody around forever. An owner can clear a strike outright.
Every number here belongs to the owner: how long the window is, how long a timeout has to be before it counts, how many strikes are too many, and how long a pause lasts.
Invites that only count when they work
An invite pays in stages, and the later stages only happen if the person actually stays and takes part.
The member gets something when the person they invited arrives. They get more if that person is still in the server after the stay window the owner sets. They get more again the first time that person is in a voice call.
That is deliberate: arriving is easy, staying is harder, and joining a call is the thing that actually turns somebody into a member. Paying only on arrival rewards whoever is loudest in an invite-trading server.
The owner sets every amount and the length of the stay window, and can switch the whole thing off. A member can see their own standing, and what each stage is worth in that server, with a single command.
Levelling that rewards showing up
XP for messages and for time spent in voice, with roles that grant themselves, and XP that decays when somebody stops turning up.
Time in a call counts, not just messages — which is what most of the activity in a voice-first server actually is. Roles can be attached to levels and are granted and removed automatically.
XP decay is optional and set by the owner: after a chosen period of inactivity a member starts losing ground, so a leaderboard reflects who is around now rather than who was around two years ago. Somebody who drops below a role's threshold loses that role and earns it back by coming back.
Existing XP can be imported, so a server switching over does not reset everybody to zero.
Camera-required voice channels
An owner can require cameras in chosen voice channels, and the bot enforces it in those channels only.
Where an owner has turned it on, somebody who joins one of those 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.
It is off until an owner switches it on, and the wording members see is the owner's to edit.
Poach-watch: evidence, never a verdict
Patterns that look like somebody recruiting out of a server are reported to moderators, who decide what to do.
It surfaces things a moderator would want to see: an account that joins calls broadly without taking part, members leaving together shortly after the same person spoke to them, a call that empties whenever a particular account joins, an invite link sitting in a profile.
It never bans, kicks, mutes or removes anybody, and it never accuses. It posts what it saw, with the accounts and the timestamps, to the channel the owner chooses. Every decision stays with a human, and an owner can mark an account exempt.