BallsDex

↑↓ to move Enter to open See all results

Commands

How to start collecting countryballs on Discord, and everything BallsDex can do once you have.

Add to Discord Join the community server

Getting started

  1. Add BallsDex to a server

    Invite it to a server you manage, or join the community server and play there.

  2. Pick a spawn channel

    Someone with Manage Server runs this in the channel where countryballs should appear. They spawn there as people chat in the server.

    /config channel

  3. Catch countryballs

    When a countryball appears, press "Catch me" and type its name. The first player to name it correctly keeps it.

  4. Look through your collection

    See what you've caught and how much of the countryball roster you have. It's on the website too, once you sign in.

    /balls list /balls completion Or open My Collection on this site →

  5. Trade with other players

    Start a trade, both add the countryballs you're offering, then press "Lock proposal" and "Confirm" once you're both happy.

    /trade start /trade add

  6. Choose who sees your inventory

    Inventory privacy, donations, friend requests and trade cooldowns.

    /player settings Or open Account on this site →

All commands

/achievements

Commands to list and view achievements.

/achievements info <achievement>

Show information about a specific achievement.

1 option
achievement
-

/achievements list [sort_by] [ephemeral]

List achievements available and which ones a user has unlocked.

2 options
sort_by optional
Sort order: show unlocked first or locked first (default: locked_first).
ephemeral optional
-

/achievements mine [compact] [latest] [ephemeral]

Show your unlocked achievements.

3 options
compact optional
Whether to show a compact list of achievements (default: False).
latest optional
Whether to show latest achievements first (default: True).
ephemeral optional
-

/auction

Global, channel-less auction house - list countryballs and bid on anyone else's

/auction bid <auction_id> <amount> [max_bid]

Place a bid on an active auction.

3 options
auction_id
The auction to bid on, e.g. 19C.
amount
Your bid amount.
max_bid optional
Optional: auto-bid up to this amount as others outbid you, without you coming back each time.

/auction bids [all]

See auctions you've placed a bid on.

1 option
all optional
Include auctions that have already ended. Off by default (active only).

/auction feature <auction_id>

Pay to post an auction to the featured-auctions channel.

1 option
auction_id
The auction to feature, e.g. 19C.

/auction list [ball] [special] [is_special] [is_frame] [seller] [sort] [no_bids_only] [lot_type]

Browse and search active auctions across the whole bot.

8 options
ball optional
Only show auctions for this countryball species.
special optional
Only show auctions for this special background.
is_special optional
Only show auctions for items with any special background.
is_frame optional
Only show auctions for items caught with a special frame.
seller optional
Only show auctions listed by this player.
sort optional
How to order the results (default: ending soonest).
no_bids_only optional
Only show auctions that haven't received a bid yet.
lot_type optional
Only show single-item auctions, only multi-item lots, or both (default: both).

/auction mine [status]

See your own auctions - active and past.

1 option
status optional
Only show auctions with this outcome. Shows everything by default.

/auction multi <duration> [unit] [min_bid] [min_increment] [buy_now] [reserve_price] [countryball] [special] [sort] [filter]

List several of your countryballs as one lot in the global auction house.

10 options
duration
How long the auction should run for (30m-24h, Patreon supporters up to 7 days).
unit optional
Whether 'duration' is in minutes, hours or days (default: hours).
min_bid optional
The minimum opening bid for the whole lot (default: 1).
min_increment optional
The minimum raise per bid (default: 1).
buy_now optional
Instant-win price - a bid at or above this ends the auction immediately.
reserve_price optional
Hidden minimum sale price - if the highest bid doesn't reach it, the lot stays with you. (Patreon…
countryball optional
Only offer this countryball in the picker.
special optional
Open the picker on this special background (you can switch special from the picker).
sort optional
How the countryballs are ordered in the picker. Can be used to show duplicates.
filter optional
Only offer countryballs matching this filter in the picker.

/auction price <ball> [special] [filter] [days]

See what this countryball has actually sold for in past auctions.

4 options
ball
The countryball to look up past sales for.
special optional
Only count sales of items with this special background. Overrides 'filter'.
filter optional
Whether to count sales of items that had a special background. Defaults to excluding them.
days optional
How far back to look, in days. Defaults to the configured window.

/auction sell <ball> <duration> [special] [unit] [min_bid] [min_increment] [buy_now] [reserve_price]

List one of your countryballs in the global auction house.

8 options
ball
The countryball from your own collection to put up for auction.
duration
How long the auction should run for (30m-24h, Patreon supporters up to 7 days).
special optional
Filter the countryball autocomplete to a specific special background. Ignored afterwards.
unit optional
Whether 'duration' is in minutes, hours or days (default: hours).
min_bid optional
The minimum opening bid (default: 1).
min_increment optional
The minimum raise per bid (default: 1).
buy_now optional
Instant-win price - a bid at or above this ends the auction immediately.
reserve_price optional
Hidden minimum sale price - if the highest bid doesn't reach it, the item stays with you. (Patreon…

/auction stats

See your auction house history - as a seller and as a bidder.

/auction view <auction_id>

See the full details of one auction.

1 option
auction_id
The auction to inspect, e.g. 19C.

/auction watch add [ball] [special] [is_special] [max_price]

Get notified when a new auction matching this is listed.

4 options
ball optional
Notify me when this countryball gets auctioned.
special optional
Notify me when this special background gets auctioned.
is_special optional
Only match items that have any special (True) / that have no special (False). Leave unset to match…
max_price optional
Only notify me when the opening bid is at or below this. Leave unset for any price.

/auction watch list

See what you're currently watching for.

/auction watch remove <watch>

Stop watching for something.

1 option
watch
The watch to remove.

/balls

View and manage your countryballs collection.

/balls bulk_give <user> [countryball] [sort] [special] [filter] [group]

Give multiple countryballs to a user at once.

6 options
user
The user you want to give countryballs to
countryball optional
Filter the selection to a specific countryball
sort optional
Choose how countryballs are sorted. Can be used to show duplicates.
special optional
Filter the selection to a specific special event
filter optional
Filter the selection by a specific filter
group optional
Filter the selection to a specific group

/balls collection [countryball] [filter] [ephemeral]

Show the collection of a specific countryball.

3 options
countryball optional
The countryball you want to see the collection of
filter optional
Filter the collection by a specific filter.
ephemeral optional
Whether or not to send the command ephemerally.

/balls compare <user> [special] [duplicates] [filter] [group] [regime] [economy] [diff_only]

Compare your countryballs with another user.

8 options
user
The user you want to compare with
special optional
Filter the results of the comparison to a special event.
duplicates optional
Whether to compare duplicates.
filter optional
Filter the compared countryballs by a specific filter.
group optional
Filter the results of the comparison to a specific group.
regime optional
Filter the results of the comparison to a specific regime.
economy optional
Filter the results of the comparison to a specific economy.
diff_only optional
Only show what's different between you and the other user, hiding "Both have" and "Neither have" -…

/balls completion [user] [special] [filter] [regime] [economy] [group] [duplicates] [ephemeral]

Show your current completion of the BallsDex.

8 options
user optional
The user whose completion you want to view, if not yours.
special optional
The special you want to see the completion of
filter optional
Filter the list by a specific filter.
regime optional
The regime you want to see the completion of
economy optional
The economy you want to see the completion of
group optional
The group you want to see the completion of
duplicates optional
Show the completion of duplicates.
ephemeral optional
Whether or not to send the command ephemerally.

/balls count [countryball] [special] [filter] [group] [regime] [economy]

Count how many countryballs you have.

6 options
countryball optional
The countryball you want to count
special optional
The special you want to count
filter optional
Filter the count by a specific filter
group optional
The group you want to count
regime optional
The regime you want to count
economy optional
The economy you want to count

/balls drop <countryball> [special]

Drop one of your countryballs back into the wild, to be caught again.

2 options
countryball
The countryball you want to drop
special optional
Filter the results of autocompletion to a special event. Ignored afterwards.

/balls duplicate <type> [sort] [limit] [min_count] [reverse] [group] [special] [regime] [economy] [filter]

Shows your most duplicated countryballs or specials.

10 options
type
Type of duplicate to check (countryballs or specials).
sort optional
Choose how the results are sorted. Defaults to most duplicated first.
limit optional
The amount of countryballs to show (default: all), can only be used with `countryballs`.
min_count optional
Only show results you own at least this many of.
reverse optional
Show your least duplicated countryballs or specials first instead.
group optional
Filter the results by a specific group.
special optional
Filter the results by a specific special event, can only be used with `countryballs`.
regime optional
Filter the results by a specific regime.
economy optional
Filter the results by a specific economy.
filter optional
Filter the results by a specific filter.

/balls favorite <countryball> [special]

Set favorite countryballs.

2 options
countryball
The countryball you want to set/unset as favorite
special optional
Filter the results of autocompletion to a special event. Ignored afterwards.

/balls give <user> <countryball> [special]

Give a countryball to a user.

3 options
user
The user you want to give a countryball to
countryball
The countryball you're giving away
special optional
Filter the results of autocompletion to a special event. Ignored afterwards.

/balls info <countryball> [special] [ephemeral]

Display info from a specific countryball.

3 options
countryball
The countryball you want to inspect
special optional
Filter the results of autocompletion to a special event. Ignored afterwards.
ephemeral optional
Whether or not to send the command ephemerally.

/balls last [user] [countryball] [special] [filter] [group] [index]

Display info of your or another users last caught countryball.

6 options
user optional
The user you would like to see
countryball optional
Only look at a specific countryball.
special optional
Only look at a specific special event.
filter optional
Filter the last caught countryball by a specific filter. Only works if the user has caught at least…
group optional
Only look at a specific group.
index optional
How far back to look. 1 is the most recent catch, 2 the one before that, and so on.

/balls list [user] [sort] [reverse] [countryball] [special] [filter] [group] [regime] [economy] [ephemeral]

List your countryballs.

10 options
user optional
The user whose collection you want to view, if not yours.
sort optional
Choose how countryballs are sorted. Can be used to show duplicates.
reverse optional
Reverse the output of the list.
countryball optional
Filter the list by a specific countryball.
special optional
Filter the list by a specific special event.
filter optional
Filter the list by a specific filter.
group optional
Filter the list by a specific group.
regime optional
Filter the list by a specific regime.
economy optional
Filter the list by a specific economy.
ephemeral optional
Whether or not to send the command ephemerally.

/ballsbux

Currency commands

/ballsbux balance

Check your balance.

/ballsbux daily

Claim your daily reward. Claim on consecutive days to grow your streak.

/ballsbux give <user> <amount>

Give money to a player.

2 options
user
The player you want to give money to.
amount
The amount to give.

/ballsbux history [period] [filter]

See where your ballsbux came from and went.

2 options
period optional
How far back to look. Defaults to the last 30 days.
filter optional
Only show one kind of movement. Defaults to everything.

/ballsbux sell <countryball> [special]

Sell one of your countryballs for currency.

2 options
countryball
The countryball you want to sell.
special optional
Filter the autocomplete to a special event. Ignored afterwards.

/ballsbux selllast [countryball] [special] [filter] [group] [index]

Sell the last countryball you obtained for currency.

5 options
countryball optional
Only look at a specific countryball.
special optional
Only look at a specific special event.
filter optional
Filter the last countryball by a specific filter.
group optional
Only look at a specific group.
index optional
How far back to look. 1 is the most recent, 2 the one before that, and so on.

/ballsbux shop reroll <countryball> [special]

Reroll the stat bonuses of one of your countryballs.

2 options
countryball
The countryball whose ATK/HP bonuses you want to reroll.
special optional
Filter the results of autocompletion to a special event. Ignored afterwards.

/ballsbux shop view

Browse the shop, buy items, and check your balance.

/ballspass

Earn XP from daily and weekly tasks, level up, and claim rewards

/ballspass gift <user>

Redeem a premium gift you bought onto another player

1 option
user
The player who should receive Ballspass premium

/ballspass history

View the Ballspass rewards you've earned this season

/ballspass leaderboard [scope]

View the Ballspass XP leaderboard

1 option
scope optional
Which board to show — defaults to the full season

/ballspass notifications <preference>

Choose where Ballspass reward notifications are sent

1 option
preference
Where to deliver task-complete and reward notifications

/ballspass premium

View Ballspass premium perks and purchase

/ballspass reroll

Premium: swap one of today's daily tasks for a new one

/ballspass rewards

Browse the Ballspass reward track

/ballspass tasks [task]

View your daily and weekly Ballspass tasks

1 option
task optional
Pick one task to see exactly what counts toward it

/ballspass unlock

Unlock this season's Ballspass with ballsbux, so you start earning

/ballspass view [user] [ephemeral]

View your Ballspass level and XP progress

2 options
user optional
View another player's Ballspass (optional)
ephemeral optional
Only show the card to you (default: visible to everyone)

/battle

Battle people in this server in the card game

/battle ai [deck] [level]

Play a card battle against the AI in the Battle activity.

2 options
deck optional
One of your saved 5-ball decks. Leave empty for a random hand from your collection.
level optional
How hard the AI plays. Normal by default.

/battle challenge <opponent> [deck]

Challenge someone to a card game.

2 options
opponent
Who you want to play.
deck optional
One of your saved 5-ball decks. Leave empty for a random hand from your collection.

/battle deck build <name> [special] [countryball] [group] [regime] [economy] [filter] [sort] [reverse]

Build a deck, or open one of yours to edit it.

9 options
name
The deck to build. An existing name opens that deck for editing.
special optional
Start the picker filtered to this special. You can change it in the picker.
countryball optional
Only offer this countryball in the picker.
group optional
Only offer countryballs from this group.
regime optional
Only offer countryballs with this regime.
economy optional
Only offer countryballs with this economy.
filter optional
Only offer balls matching this filter.
sort optional
How the picker's list is sorted.
reverse optional
Reverse the picker's sort order.

/battle deck delete <name>

Delete one of your saved decks.

1 option
name
Which deck to delete.

/battle deck list

See your saved decks and which ones are ready for card battles.

/battle deck view <name>

See the balls and total power of one of your saved decks.

1 option
name
Which deck to view.

/battle start [opponent] [deck]

Start a card battle here in the Battle activity.

2 options
opponent optional
Someone to ping to take you on. Anyone here can still join.
deck optional
One of your saved 5-ball decks to play with. Leave empty to pick in the activity.

/battle stats [user]

Show card battle stats for yourself or someone else.

1 option
user optional
Whose stats to show. Defaults to you.

/claim

Craft Collector, Diamond, and Emerald balls

/claim bronze <ball> [convert_lower_tiers]

Sacrifice 1000 of a ball to create a Bronze ball

2 options
ball
-
convert_lower_tiers optional
Use lower-tier sacrifice balls of this species as material first (none exist below Bronze)

/claim collector <ball> [tier]

Create a tiered collector ball

2 options
ball
-
tier optional
-

/claim diamond <ball>

Create a diamond ball

1 option
ball
-

/claim emerald <ball>

Create an emerald ball

1 option
ball
-

/claim gold <ball> [convert_lower_tiers]

Sacrifice 5000 of a ball to create a Gold ball

2 options
ball
-
convert_lower_tiers optional
Use any Bronze/Silver balls of this species as material first, before regular balls

/claim requirements <ball> [tier]

Show crafting requirements for collector, diamond, and emerald balls

2 options
ball
-
tier optional
-

/claim silver <ball> [convert_lower_tiers]

Sacrifice 3000 of a ball to create a Silver ball

2 options
ball
-
convert_lower_tiers optional
Use any Bronze ball of this species as material first, before regular balls

/config

View and manage your countryballs collection.

/config channel [channel]

Needs Manage server

Set or change the channel where countryballs will spawn.

1 option
channel optional
The channel you want to set, current one if not specified.

/config disable

Needs Manage server

Disable or enable countryballs spawning.

/config status

Needs Manage server

Check the server configuration status.

/config toggledrop

Needs Manage server

Allow or disallow players from using the drop command in this server.

/config toggletips

Needs Manage server

Show or hide the tips displayed below spawn messages in this server.

/decorations

Add decorations to your countryballs!

/decorations apply <decoration> <countryball>

Apply a purchased decoration to a countryball

2 options
decoration
The decoration you want to consume and apply
countryball
The countryball you want to apply this decoration on

/decorations gift <user> <decoration>

Gift a decoration to a user. This is irreversible.

2 options
user
The user you want to gift the decoration to
decoration
The decoration you're gifting

/decorations list

List your purchased decorations.

/hunt

Solve riddles to find hidden codes

/hunt list

List the treasure hunts running now or starting soon.

/hunt progress [hunt]

Show a treasure hunt's riddles and your progress.

1 option
hunt optional
The hunt to show. Can be left out when only one is running.

/hunt solve <code>

Submit a code you found for a treasure hunt clue.

1 option
code
A code you found

/player

Manage your account settings.

/player block add <user>

Block another user.

1 option
user
The user you want to block.

/player block list

View all the users you have blocked.

/player block remove <user>

Unblock a user.

1 option
user
The user you want to unblock.

/player friend add <user>

Add another user as a friend.

1 option
user
The user you want to add as a friend.

/player friend list

View all your friends.

/player friend remove <user>

Remove a friend.

1 option
user
The user you want to remove as a friend.

/player info

Display some of your info in the bot!

/player settings

Edit your player settings

/tournament

/tournament bracket <tournament_id> [source]

Link to a tournament's knockout bracket on the website.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament info <tournament_id> [source]

See a tournament's rules and current status.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament join <tournament_id> [deck1] [deck2] [deck3] [deck4] [deck5] [deck6] [deck7] [source]

Join a tournament. Submit your saved decks, unless it uses random decks.

9 options
tournament_id
The tournament to join.
deck1 optional
First saved deck (skip if this tournament builds decks automatically).
deck2 optional
Second saved deck.
deck3 optional
Third saved deck.
deck4 optional
Fourth saved deck (only if this tournament's format needs it).
deck5 optional
Fifth saved deck.
deck6 optional
Sixth saved deck.
deck7 optional
Seventh saved deck.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament leave <tournament_id> [source]

Leave a tournament before registration closes (refunds your entry fee).

2 options
tournament_id
The tournament to leave.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament list [source]

Browse tournaments open for registration.

1 option
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament me <tournament_id> [source]

Your entry in a tournament: seed, group, record, and next tie.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament predict <tournament_id> [source]

Link to a tournament's prediction page on the website.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament predictions <tournament_id> [source]

Prediction leaderboard for a tournament.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/tournament standings <tournament_id> [source]

Group-stage standings for a tournament.

2 options
tournament_id
Which tournament.
source optional
Show official (staff-hosted), community (player-hosted), or all tournaments.

/trade

/trade add <countryball> [special]

Add a countryball to your trade proposal. You must have a trade open.

2 options
countryball
The countryball you are adding to your trade.
special optional
The special you want to filter the countryball by.

/trade bulk_add [countryball] [sort] [reverse] [special] [filter] [group]

Bulk add countryballs to the ongoing trade, with paramaters to aid with searching.

6 options
countryball optional
The countryball you would like to filter the results to
sort optional
Choose how countryballs are sorted. Can be used to show duplicates.
reverse optional
Reverse the sorted results.
special optional
Filter the results to a special event
filter optional
Filter the results to a specific filter
group optional
Filter the results to a specific group

/trade cancel

Cancel your active trade.

/trade history [sorting] [trade_user] [days] [countryball] [special] [group] [currency] [filter]

Show your trade history.

8 options
sorting optional
The sorting order of your trades.
trade_user optional
The user you want to filter your trade history with.
days optional
Retrieve trade history from the last x days at most.
countryball optional
The countryball you want to filter the trade history by.
special optional
The special you want to filter the trade history by.
group optional
The group you want to filter the trade history by.
currency optional
Only show trades that included ballsbux
filter optional
Only show trades involving countryballs matching a specific filter.

/trade listing browse [offering] [wanting] [special] [user] [framed] [can_fill]

Browse open trade board listings.

6 options
offering optional
Only listings giving this countryball.
wanting optional
Only listings asking for this countryball.
special optional
Only listings giving or asking for this special.
user optional
Only this player's listings.
framed optional
Only listings giving or asking for a framed countryball.
can_fill optional
Only listings you could fill right now with what you own.

/trade listing create [want] [want_special] [want_framed] [want_min_atk] [want_max_atk] [want_min_hp] [want_max_hp] [countryball] [special] [sort]

Post a listing on the trade board: what you give, and what you want for it.

10 options
want optional
A countryball you want. Add more, or other rules, in the listing builder.
want_special optional
Only accept the wanted countryball with this special.
want_framed optional
True to only accept it framed, False to only accept it without a frame.
want_min_atk optional
Only accept it with at least this ATK bonus (%).
want_max_atk optional
Only accept it with at most this ATK bonus (%).
want_min_hp optional
Only accept it with at least this HP bonus (%).
want_max_hp optional
Only accept it with at most this HP bonus (%).
countryball optional
Only list this countryball when picking what you give.
special optional
Only list this special when picking what you give.
sort optional
How your countryballs are sorted in the picker.

/trade listing follow [countryball] [special] [side]

Get notified when a new listing gives or wants something.

3 options
countryball optional
The countryball to follow. Leave empty to follow a special on any countryball.
special optional
Only when it has this special.
side optional
Which side of a listing to follow. Defaults to either.

/trade listing following

See what you follow on the trade board, and unfollow.

/trade listing mine

Show your open trade board listings.

/trade listing offers <listing_id>

See the offers sent on one of your listings, and accept or decline them.

1 option
listing_id
Your listing's ID, like 1F.

/trade listing view <listing_id>

Show one trade board listing.

1 option
listing_id
The listing's ID, like 1F.

/trade offer list

Show the pending trade offers you sent and received.

/trade offer send <user> [countryball] [their_countryball] [special] [sort]

Send a trade offer to someone. They can accept, deny or counter it later.

5 options
user
The user you want to send an offer to. Their inventory must be visible to you.
countryball optional
Only list this countryball when picking your side.
their_countryball optional
Only list this countryball when picking their side.
special optional
Only list this special on both sides.
sort optional
How countryballs are sorted in the pickers.

/trade remove <countryball> [special]

Remove a countryball from your trade proposal. You must have a trade open.

2 options
countryball
The countryball you are removing from your trade.
special optional
The special you want to filter the countryball by.

/trade start <user>

Start trading with someone.

1 option
user
The user you want to trade with.

Other commands

/about

Get information about this bot.

/claimvote

Claim your top.gg vote reward

/craft <ball_one> <ball_two>

Combine two of your countryballs into a new one, following a crafting recipe.

2 options
ball_one
The first countryball to use in the recipe.
ball_two
The second countryball to use in the recipe.

/craftspecial <countryball> <recipe>

Combine copies of a countryball with different specials into a new special version of it.

2 options
countryball
The countryball to craft a special version of.
recipe
The special recipe to follow.

/help

Show the list of commands from the bot.

/notifications

Choose which notifications the bot DMs you about

/recipes [ball_one] [ball_two]

List crafting recipes, optionally narrowed down to ones using the given countryballs.

2 options
ball_one optional
Only show recipes that use this countryball as an ingredient.
ball_two optional
Only show recipes that also use this countryball as an ingredient.

/supporter

See the perks supporters get, and whether you're one.

/vote

Get the link to vote for the bot on top.gg

114 commands, as BallsDex last reported them. In Discord, /help lists them too.