Skip to content

Bulk import from ClashPerk

If your family already uses ClashPerk, you don't have to rebuild your links by hand. /link bulk (leadership) ingests a ClashPerk export spreadsheet and links every account in it in one pass.

Steps

  1. In your server, run ClashPerk's /export users command and download the .xlsx it produces (the "Discord Members" export).
  2. Run /link bulk in BooM BoT and attach the file.
  3. The bot parses the workbook, matches accounts to Discord users, and reports what it linked and what it skipped.

Both ClashPerk export layouts are supported. Accounts already linked in BooM BoT are left untouched, so re-running an import is safe.

The manual bulk menu

Run /link bulk without a file and you get an interactive menu instead: select any number of unlinked accounts from a paginated list, pick the Discord user, confirm. Selections persist while you page through the list, which makes it comfortable to link someone's six alts in one go.

Tip

ClashPerk's export carries account ownership but not town-hall levels. Don't worry about that — the bot backfills town halls automatically from the game API.