Why link accounts

Linking connects a Clash of Clans account (a tag like #Q2QUJV0) to the Discord user who plays it. It is the single highest-value piece of setup after channels, because so much of the bot keys off it:

• Roster DMs — when rosters are published, each player gets a DM listing where all of their accounts landed, with buttons to request changes.
• Signups — a member's signup automatically covers their linked accounts.
• Announcements — published rosters ping the right Discord user next to each account.
• Vetting and flags — flags follow the person: a flag on one account is visible on every account linked to the same Discord user, including accounts linked later.
• The builder — accounts show their owner's name, so you always know whose alt you are rostering.

One Discord user can have any number of linked accounts; mains and alts are all first-class.

The four ways accounts get linked

Method	Who does the work	Best for
Link dashboard	The member (or a leader)	Day-to-day, one account at a time
Claim board	Members, with leader review	Onboarding a whole server gradually
Bulk import	A leader, once	Migrating a family that already uses ClashPerk
ClashPerk mirroring	Nobody — automatic	Servers running both bots

Unlinked accounts still exist in the registry (the bot discovers them by watching your linked clans); linking just attaches an owner.