Rosters

Rosters let you assemble the exact lineup you want for CWL, wars, esports, or trophy pushes, then keep it in sync with your in-game clan. Members can sign themselves up with a button, staff can bulk-import a whole clan, and every roster can be shared to another server as a compact code.

i

All /roster subcommands require the Manage Server permission. The public Sign Up / Leave buttons posted by /roster signup work for everyone — they are not gated by that permission.

/roster at a glance

Build lineups

Create rosters with Town Hall floors/ceilings, size caps, and a linked clan.

Self-signup

Post a roster with Sign Up / Leave buttons so members add their own linked account.

Sign-up groups

Organize members into sub-groups (Main / Sub, A-Team / B-Team) with optional roles.

Share & reuse

Export any roster to a code and import it into another server or as a new roster.

Subcommands

Subcommand	Purpose
/roster create	Create a new roster
/roster edit	Change a roster’s settings
/roster list	List every roster in the server
/roster delete	Delete a roster
/roster clone	Duplicate a roster (settings + members)
/roster add-player	Add a player by tag
/roster remove-player	Remove a player by tag
/roster move-player	Move a player from one roster to another
/roster manage	Bulk-add a clan’s current members
/roster refresh	Refresh members’ TH / name from the game
/roster post	Post a read-only roster embed to a channel
/roster signup	Post a roster with self-signup buttons
/roster ping	Ping the roster’s linked members
/roster role-refresh	Re-assign roster / group roles to members
/roster export	Export a roster as a share code
/roster import	Create a roster from a share code
/roster search	Find which rosters a player or user is on
/roster groups create	Create a sign-up group
/roster groups modify	Rename, re-order, re-role, or delete a group
/roster groups list	List sign-up groups

Create and edit

/roster create

Create a lineup. Only name is required — everything else has sensible defaults.

namestringrequired

Roster name (up to 60 characters).

categorychoice

CWL, War, Esports, Trophy, or Other. Defaults to CWL.

clanstring

A clan tag to link to the roster (used by ping modes and /roster manage).

max_sizeinteger

Maximum players, 1–500. Defaults to 50.

min_thinteger

Minimum Town Hall required to join, 1–18.

max_town_hallinteger

Maximum Town Hall allowed, 1–18.

roster_rolerole

A Discord role granted to everyone on the roster.

allow_multi_signupboolean

Allow a member to add more than one of their accounts.

sort_bychoice

Display order: Town Hall, Trophies, or Name.

/roster create name:CWL Main category:CWL clan:#2PP0JCCL min_th:15 max_size:15 roster_role:@CWL

/roster edit

Takes the same settings options as create plus closed (open or close signups) and name to rename. Provide roster (the current name) plus at least one setting to change.

/roster edit roster:CWL Main closed:true sort_by:Trophies

Members

/roster add-player — add by tag

Options: roster (required), player tag (required), user (optionally link the entry to a Discord member), group (a sub-group label). Enforces the roster’s TH floor/ceiling and size cap.

/roster remove-player — remove by tag

Options: roster (required), player tag (required).

/roster move-player — move between rosters

Options: roster (from, required), player tag (required), to_roster (required). The player is added to the target first, then removed from the source, so a member is never lost if a write fails.

/roster manage — bulk-add a clan

Options: roster (required), from_clan tag (required), linked_only (only add members already linked to a Discord user). Respects the roster’s TH filters and size cap.

/roster refresh — re-pull from the game

Options: roster (required). Refreshes each member’s name and Town Hall level from the live game data.

Posting and self-signup

/roster post

Posts a clean, read-only roster embed. Options: roster (required), channel (defaults to the current channel).

/roster signup

Posts the roster with Sign Up and Leave buttons. Options: roster (required), channel (defaults to the current channel).

Post the panel

Run /roster signup roster:CWL Main channel:#cwl-signups.

Members sign themselves up

A member clicks Sign Up. ClashDuke uses their linked account — if they have not linked yet, they are prompted to run /link first.

Automatic role & rules

If a roster_role is set, it is granted on sign-up and removed on leave. Closed rosters, full rosters, and TH limits are all enforced automatically.

/roster ping

Pings the roster’s linked members. Options: roster (required), message (custom text), mode:

Mode	Who is pinged
all	All roster members (default)
missing	Roster members no longer in the linked clan
unregistered	Clan members who are not on the roster

i

missing and unregistered require the roster to have a linked clan.

Sign-up groups

Groups split a roster into labelled sub-teams. Each group can grant its own Discord role and be marked self-selectable.

Subcommand	Options
/roster groups create	name (required), group_role, selectable
/roster groups modify	group (required), name, order (1–1000), group_role, selectable, delete_group
/roster groups list	—

Use /roster role-refresh roster:<name> to (re)assign the roster role and each member’s group role to everyone with a linked Discord account.

Share, clone, and search

Export / Import

/roster export roster:<name> returns a share code. Anyone can paste it into /roster import code:<code> — in the same server or a different one — to recreate the roster (settings and members, up to 500).

Clone

/roster clone roster:<name> duplicates a roster and its members. Provide name for the copy, or one is generated. The clone starts open with no roster role attached.

Search

/roster search finds which rosters a player is on. Pass a player tag, a user, or neither (defaults to your own linked accounts).

!

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