Links & Verification

Linking connects a member’s Discord to their Clash of Clans account(s). It powers autoroles, rosters, reminders, to-do lists, and the “who is this?” lookups across ClashDuke. This page covers linking, verifying, coverage boards, the self-service onboarding kit, and auto-expanding pasted in-game links.

i

Each Discord user can link up to 25 accounts. Links are one-owner-per-account: claiming an account already linked to someone else needs a valid in-game API token (proof of ownership) or a server manager’s help.

/link

Link and manage Clash of Clans accounts.

Subcommand	Purpose
create	Link a player account (add an API token to verify or claim it)
list	List a user’s linked accounts, or a clan’s link-coverage board
default	Choose which of your accounts is your main
delete	Unlink an account
button	Post a self-service “Link Account” button (Manage Server)
greeting set / clear / show	Manage the welcome message sent when a member links (Manage Server)
welcome post / auto / disable / show	Manage the onboarding button kit (Manage Server)

/link create

Option	Type	Required	Description
player_tag	string	Yes	Player tag
user	user	No	User to link (staff only; default you)
api_token	string	No	In-game API token (Settings → More Settings → API Token)
default	boolean	No	Set as main account

Adding a valid api_token marks the link verified and lets you claim an account from a previous owner. Linking another member’s account (user) requires Manage Server.

/link create player_tag:#9G8QCROV
/link create player_tag:#9G8QCROV api_token:abc123 default:true

/link list

Without a clan, lists a user’s linked accounts. With a clan, shows a coverage board of that clan’s members split by linked / not linked.

Option	Type	Required	Description
user	user	No	User (default you)
clan	string (autocomplete)	No	Show a clan roster with who is / isn’t linked
sort	choice	No	Sort the coverage board: Name, Tag, Username, Town Hall

/link list
/link list user:@Chief
/link list clan:#2PP sort:Town Hall

/link default

Pick which of your accounts is your main. With player_tag it sets it directly; without, it shows a menu of your accounts. Only ever acts on your own links.

Option	Type	Required	Description
player_tag	string (autocomplete)	No	Account to set as main (leave empty to pick from a menu)

/link delete

Unlink an account — your own always, or anyone’s with Manage Server.

Option	Type	Required	Description
player_tag	string (autocomplete)	Yes	Player tag, or pick a linked account

/link button

Posts a public Link Account button. Members click it and link themselves through a private pop-up form (they can paste an API token to verify). Requires Manage Server.

/link greeting

A welcome message sent when a member successfully links an account. Requires Manage Server.

Subcommand	Options
set	message (required, max 1000 chars)
clear	—
show	—

The template supports these variables: {player}, {clan}, {user}, and {th}.

/link greeting set message:Welcome {user}! Linked {player} (TH{th}) in {clan}.
/link greeting show

/link welcome

An onboarding kit — a reusable button message (Link Account · Help · Refresh Roles · To-Do · My Rosters). Post it on demand or auto-post it when a member joins. Requires Manage Server.

Subcommand	Options
post	channel (default: here) · message (custom intro, max 1000 chars)
auto	channel (required) · message (custom intro, max 1000 chars)
disable	—
show	—

!

Auto-posting on join requires the Server Members privileged intent to be enabled for the bot.

/link welcome post channel:#welcome
/link welcome auto channel:#welcome
/link welcome disable

/verify

Verify account ownership with your in-game API token. Verifying proves ownership, so it claims the account from any prior owner. This reply is always private (ephemeral).

Option	Type	Required	Description
player_tag	string	Yes	Player tag
token	string	Yes	Settings → More Settings → API Token

/verify player_tag:#9G8QCROV token:abc123

Open the in-game token

In Clash of Clans: Settings → More Settings → API Token. Copy the token at the bottom.

Run /verify

Paste your player tag and token. ClashDuke checks the token and links the account as verified.

Done

Verified links can’t be claimed by anyone else without their own token — they’re yours.

/discord-links

A clan’s Discord-link coverage board: members grouped into In this server, Linked, not in server, and Not linked, each with a verified badge, Town Hall, and mention.

Option	Type	Required	Description
clan	string (autocomplete)	No	Clan tag, or a linked clan
sort	choice	No	Sort the board: Name, Tag, Username, Town Hall

The reply has a sort button, and a Switch clan… dropdown when the server has more than one linked clan.

/discord-links clan:#2PP
/discord-links clan:#2PP sort:Town Hall

Auto link-parsing

When enabled, ClashDuke watches for pasted in-game share links and expands them into compact rich embeds in the channel — no slash command needed. It recognises:

• Player profile links → a compact player embed
• Clan profile links → a compact clan embed
• Army links (“Copy Army Link”) → an army embed with a Copy Army Link button
• Base layout links (“Copy Link”) → a layout card with an Open Layout button

Turn it on with /setup link-parse mode:enable.

!

Auto link-parsing requires the Message Content privileged intent to be enabled for the bot — without it Discord doesn’t deliver message text, so nothing is expanded. To prevent spam, ClashDuke expands at most 3 links per message and no more than once per channel every few seconds.

---

i

ClashDuke is fan-made content and is not affiliated with, endorsed, sponsored, or specifically approved by Supercell. For more information see Supercell’s Fan Content Policy.