Deck Shop ✓ BOT
The best Clash Royale Discord Bot. Verified.
Last updated: 04/26/2020
Features
-
Translations
Bot is translated into many languages and we're working on adding even more.
-
Link conversion
Automatically makes your unreadable friend, clan and deck links pretty.
-
Clan management
Manage your clan more easily and stay on top of what's happening in your clan with the clan log feature! Now with automatic role management!
-
Player stats
Check your game stats and chests by typing simple commands.
-
Alt / Mini account
Do you have a second account? You can save it and track it too.
-
Leaderboards
When added to your server, it automatically creates leaderboards of your members using game information.
-
Decks
Need a deck inspiration? You can list decks by cards, display top decks from the best players and more.
-
Settings & Help
Fully customize the bot to fit into your server even if you have multiple bots.

About the Bot
The only Clash Royale Discord bot you'll ever need. Using the same data directly from the game as Deck Shop Spy, it provides you with all the stats and decks without the need for you to leave Discord.
Do you like the bot? Let us know on:
Bot is already used by:
















Command list
Clan management
!clanwar / !cw
|
Check your clan's Clan War status |
!clanmembers
|
List all your clan members |
A !setclanlog
|
Set a channel where to log your clan activity |
!clans
|
Clan family overview and settings |
A !roles
|
Set automatic role management |
Decks
!topdecks / !topplayers
|
Show decks of top players |
!decks
|
Show decks with a card |
!share
|
Share a defined deck |
!randomdeck / !rd
|
Show random deck |
Leaderboards
!lb / !leaderboard
|
Show Discord members' leaderboards |
!topclans
|
Show top clans |
!clanwars / !cws
|
Show top Clan Wars clans |
Settings & Help
!info / !help
|
Bot help and command list |
!serversettings
|
Show bot-related server settings |
A !setlanguage
|
Set language for the bot |
A !setchannels
|
Set the allowed channels |
A !setprefix
|
Change the command prefix |
A !togglelinks
|
Turns the link conversion on or off. |
A !setlinkchannel
|
Dedicate channels for friend links only |
A |
Resets all server settings to default |
A / Administrator only This means that the user has to have "Manage Server" or "Administrator" permissions in order to use the command.
Help
Adding the bot
Adding the bot to your server is easy, just click the link above, authorize the bot to access your Discord, give it all the listed permissions and it's done.
Then you can restrict it to only certain channels using the !setchannels
command.
And if you have a server in another language, set the language that the bot will use with the !setlanguage
command.
What are the permissions for?
They allow the bot to work properly and interact with your channels.
- Read messages: Without it, the bot wouldn't be able to listen to your commands.
- Manage messages: When you paste a friend / deck link, the bot makes it pretty and deletes your original message.
- Attach files: To some commands the bot replies with an attached image.
- Manage Webhooks: If you want to use the clan log. (optional)
- Send messages: Bot needs this to be able to display the results of your commands.
- Embed links: Allows the bot to use links to Deck Shop to show you more stats, decks etc.
- Use External Emojis: All of the chest, arena and card images are emojis built into the bot.
- Manage Roles: Bot needs this to do automatic role management.
Translations
By using the !setlanguage
command, you can set the bot to work in any of the supported languages.
Link conversion
You've been there. You want to share a friend link for other people to add you, but it is long and ugly and people have no idea what they are clicking on and who you are.
Now you can just paste or share the link in a channel and the bot will convert these links automatically:
- Friend invite links
- Clan invite links
- Shared decks






Much better, isn't it?
If, for some reason, you don't want the links to be converted, you can turn this feature off with !togglelinks
command.
Player stats
The bot allows you to save your main profile and your alt / mini account. Commands for the second account end in '2'.
!save PLAYERTAG [APITOKEN]
!save2 PLAYERTAG
Save your player tag to be able to use the following commands without the need to type it every time. You can provide the API token and verify your account right away. Verification is not available for the Alt / Mini accounts.
If you want to appear on the leaderboards, you have to have your tag saved.
Parameters:
- PLAYERTAG – Your player profile identification. See screenshot below for info where to find it in the game.
- APITOKEN – You can find it in the game, under Settings, at the bottom. Tap the button to show the API token, tap again to copy it to clipboard.


!verify APITOKEN
Verify that the player tag that you saved is really yours. This is required before using some commands.
Verification is not available for the Alt / Mini accounts.
Example usage:
!verify 2fpgjb92
Parameters:
- APITOKEN – You can find it in the game, under Settings, at the bottom. Tap the button to show the API token, tap again to copy it to clipboard.


!profile
!profile2
Show your player profile info and stats.


!chests
!chests2
Show your chest cycle.


!cycle
!cycle2
Receive a direct message with your complete chest cycle.

!clan
!clan2
Show your clan info.


!deck
!deck2
Show your current deck.


Decks
!topdecks [LOCATION]
/ !topplayers
Show decks of players on the top of the leaderboard.
Example usage:
!topdecks
!topdecks sk
!topdecks Canada
Parameters:
- no parameter = global leaderboard
- LOCATION = see list of locations

!decks [CARD]
Show the best Clash Royale decks with a certain card.
Example usage:
!decks
!decks ma
!decks InfernoD
Parameters:
- no parameter = random decks
- CARD = see list of cards

Share a deck containing the 8 cards listed.
Example usage:
!share ebarbs rage arrows zap log rg horde freeze
!share InfernoD MegaKnight IceWiz Hog Tornado Log Fireball Skarmy
Parameters:
- 8 CARDS = see list of cards

!randomdeck [ELIXIR]
/ !rd
Create a completely random deck with a specified elixir cost.
Parameters:
- no parameter = create a completely random deck
- 2 = create a deck with AEC 2.x
- 3 = create a deck with AEC 3.x
- 4 = create a deck with AEC 4.x and higher
AEC means Average Elixir Cost.

Clan management
!clanwar
/ !cw
Show a quick overview of your clan's Clan War status.

!clanmembers [PARAMETER]
/ !clanm
Show clan members overview. With the optional "all" parameter, you can list all the members and their saved Discord usernames.
Example usage:
!clanmembers
!clanmembers all
!clanmembers donations
Parameters:
- no parameter = clan members overview
- all = lists all clan members
- donations = sort clan members by donations


!setclanlog CHANNEL [disable]
Administrator only
In order to use this command, you need to be a verified leader / co-leader of the clan!
The bot also needs to have "Manage Webhooks" permissions, otherwise the command won't work.
Set a channel in which to log all the clan activity from the clan that you lead.
It is recommended to create a new channel for the clan log.
Clan changes that are logged:
- Clan type (open, closed, invite only)
- Clan description
- Clan badge
- Clan location
- Clan requirements (trophies)
- Members: join / leave
- Roles: promotion / demotion
- War / Collection day: started / ended
- Naughty members (missing war attacks)
Example usage:
!setclanlog #clan_log
!setclanlog #clan_log disable
Parameters:
- CHANNEL = your discord channel where to log the activity
- disable = disables the logging


!clans [ORDER_BY] [ORDER_DIRECTION]
!clans SET PARAMETER [VALUE]
Administrator only
!clans RESET PARAMETER
Administrator only
Show a fully customizable clan family overview. Lists all the clans with the enabled clan log on the current server. This command adds and removes clans automatically as you enable/disable clan logging.
Parameters:
The command has multiple parameters, so it may seem complicated, but most of it is just to set it up, you don't need to do that.
If you need help, you can display all the arguments with !clans set
.
ORDER_BY
- no parameter = clan score
- trophies (score) clan score
- war (cw) clan war trophies
- members (m) member count
- donations (d) donations per week
- requirements (req) minimum requirements
- name (n) clan name (alphabetically)
ORDER_DIRECTION
- no parameter = from high to low
- high (desc) from high to low
- low (asc) from low to high
SET / RESET
- empty = display all the possible parameters
- description TEXT = command description, markdown and emojis are supported
- color HEX_COLOR = embed color, has to be a valid hex color
- titleName TEXT = text title
- titleLink URL = destination url when you click the title
- titleImg URL = small icon next to the title
- thumbnail URL = bigger image in the top right corner
- footerText TEXT = text in the footer
- footerImg URL = small image in the footer
- timestamp = timestamp in the footer
- limit NUMBER = how many clans to list (default = all)
- disable = disable this command
Example usage:
!clans
display all your family clans ordered by clan score
!clans cw
display all your family clans ordered by clan war trophies
!clans members low
display all your family clans ordered by member count from low to high
!clans set description Cool new description
set description to a custom text
!clans reset description
reset description to its default value (empty)
!clans set disable
disable this command


!roles
!roles GET
!roles SET CLANTAG
Administrator only
!roles SET CLANTAG CLAN_ROLE DISCORD_ROLE
Administrator only
!roles REMOVE CLANTAG
Administrator only
Allows you to set up automatic role management. Your clan Elders can get a special @Elder role for example. It is a very flexible command, but quite easy to set up.
Once set up, the roles are managed automatically. When members are promoted/demoted, leave the clan or come back or save their tag for the first time.
Things to know before the setup
- In your server, the bot has to have the following permissions: Manage Roles
- Automatic roles are only given to users with saved and verified profiles! (
!save
or!verify
) - Clan log needs to be active for the clan. (
!setclanlog
) - You can enable automatic roles for multiple clans on your server.
- Multiple Discord roles can be assigned per one clan role.
- But there is no hierarchy of roles, Elders are not automatically assigned roles for Members.
- Roles for Guests are shared among all your clans that have automatic roles activated.
- You have to be Administrator to set it up.
Setting up automatic roles
Repeat this procedure for each family clan in your Discord server.
!roles set CLANTAG
— This will enable automatic roles for your clan.!roles set CLANTAG Members @ClanMember
— This will add @ClanMember role to your clan members.!roles set CLANTAG Elders @ClanElder
— This will add @ClanElder role to your clan Elders.!roles set CLANTAG CoLeaders @ClanLeaders
— This will add @ClanLeaders role to your clan Co-leaders and Leader.!roles set CLANTAG Guests @Guests
— This will add @Guests role to all server members that are not in your clan(s).
If you want your Elders and Co-leaders to also have a @ClanMember role, you have to set it up separately.
!roles set CLANTAG Elders @ClanMember
!roles set CLANTAG CoLeaders @ClanMember
Troubleshooting
Something is not working? Maybe this will help.
- If you made a mistake when setting up the roles, you can reset one clan role:
!roles set CLANTAG Elders reset
- Or you can remove all the settings for one clan:
!roles remove CLANTAG
- If you think you were not given the right roles, you can force it manually:
!roles get
- Make sure the bot has the following permissions: Manage Roles
- Automatic roles are only given to users with saved and verified profiles! (
!save
or!verify
) - Clan log needs to be active for the clan. (
!setclanlog
) - Bot can only assign Discord roles that are below its highest role in the Discord role hierarchy (in the Server settings).
Parameters:
- CLANTAG = clan tag of the clan you are setting up
- CLAN_ROLE = one of the following clan roles: Members, Elders, CoLeaders (or a special Guests role)
- DISCORD_ROLE = any existing role on your Discord server (works with @ or without it)
Example usage:
!roles
list all server clans with automatic role management active
!roles get
manual refresh of your roles
!roles set 922VCJ
enable automatic role management for the clan
!roles set 922VCJ Elders @ClanElder
assign @ClanElders role to all Elders in the clan
!roles set 922VCJ Elders reset
resets all assigned roles for clan Elders
!roles remove 922VCJ
remove all roles from the clan


Leaderboards
If you want to appear on the leaderboards, you have to have your tag saved.
See the !save
command.
Second accounts are not part of the leaderboards yet.
!lb [GLOBAL?] [TYPE] [LEVEL?] [VERIFIED?]
/ !leaderboard
Show a local Discord leaderboard that includes all the members that saved their player tag. Different leaderboards are available using parameters.
Parameters:
The command has multiple parameters, so it may seem complicated, but the order is logical and you can filter the leaderboards to your liking.
If you need help, you can display all the arguments with !lb args
.
GLOBAL?
- empty = display leaderboard for the current discord server
- global (g) = display global leaderboard from all discord servers
TYPE
- no parameter = display trophy leaderboard
- personalbest (best, pb)
- donations (don, d)
- 3crowns (3c, threecrowns, crowns, tcw)
- cardswon (cards)
- battles (b)
- wins (w)
- draws (dr)
- losses (l)
- win% (percentage, %)
- warwins (ww)
- collectedcards (clancards, cc)
- clans (cl) total clans joined
- tournaments (tp) tournaments played
- hosted (h) tournaments hosted
- friendly (fb) friendly battles won
- challengewins (ch) max challenge wins, sorted by trophies in case of tie
- time (t) time spent playing in days
LEVEL?
- empty = players of all levels displayed
- lvl1–lvl13 (l1–l13, level1–level13) = filter leaderboards to display only players of a given level
VERIFIED?
- empty = global leaderboard will display only verified users, server leaderboards will display all users
- verified (v) = display only verified users on the leaderboard
- nofilter (nf) = display all users on the leaderboard
Example usage:
!lb
local leaderboard of all server members sorted by trophies
!lb warwins
local leaderboard of all server members sorted by war wins
!lb cc verified
local leaderboard of verified server members sorted by collected clan cards
!lb g personalbest lvl11
global leaderboard of verified level 11 players sorted by personal best
!lb g battles lvl8 nofilter
global leaderboard of all level 8 players sorted by battle count


!topclans [LOCATION]
Show top clan leaderboard.
Example usage:
!topclans
!topclans sk
!topclans Canada
Parameters:
- no parameter = global leaderboard
- LOCATION = see list of locations

!clanwars [LOCATION]
/ !cws
Show top Clan Wars clan leaderboard.
Example usage:
!clanwars
!clanwars sk
!clanwars Canada
Parameters:
- no parameter = global leaderboard
- LOCATION = see list of locations

Settings & Help
!info [here]
/ !help
Receive a direct message from the bot with detailed help with all the commands and other useful links and information.
Parameters:
- here = display the info directly in the channel – useful if you want to pin it!

!serversettings
Detailed permission and server settings overview. Let's you know if everything is set up correctly.


!setlanguage [LANGUAGE]
Administrator only
Set the language in which the bot will reply in the current server.
Example usage:
!setlanguage es
!setlanguage Español
Parameters:
- no parameter = the list of currently supported languages
- LANGUAGE = see the list of currently supported languages

!setchannels [CHANNELS]
Administrator only
Limit the bot only to certain channels that you specify to avoid spamming in other channels.
Empty parameter = allow bot to every channel on your server.
Channels are separated by a space, example usage:
!setchannels #bot #clan_recruitment #friend_invites

!setprefix [PREFIX]
Administrator only
Change the prefix of all the commands to avoid possible collisions with other bots. Usually, you don't have to touch this.
Empty parameter = set the default prefix.
The default prefix is !

!togglelinks
Administrator only
Turn the link conversion for your server on or off.


!setlinkchannel
!setlinkchannel ADD CHANNEL
Administrator only
!setlinkchannel REMOVE CHANNEL
Administrator only
Restrict up to 2 channels to allow only friend links to be posted there. Everything else anyone types into those channels will be deleted. Useful for keeping things clean.
Parameters:
- no parameter = list all active link channels
- add #channel = set channel as link only
- remove #channel = set channel as normal

!dsresetserver
Administrator only
CAUTION! Last-resort command to get you out of any trouble. Resets all the server settings to default. It can be called from any channel with the default "!" prefix.
Parameter values
Languages
By using the !setlanguage
command, you can set the bot to work in any of the supported languages.
Cards
Cards are used as a parameter for the deck commands.











































































































Locations
Locations are used as a parameter for the leaderboard commands.