BallsDex

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
Only offer countryballs with this special background in 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]

Give multiple countryballs to a user at once.

5 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

/balls collection [countryball] [ephemeral]

Show the collection of a specific countryball.

2 options
countryball optional
The countryball you want to see the collection of
ephemeral optional
Whether or not to send the command ephemerally.

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

Compare your countryballs with another user.

5 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.
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]

Count how many countryballs you have.

3 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

/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] [reverse] [group] [filter]

Shows your most duplicated countryballs or specials.

6 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`.
reverse optional
Show your least duplicated countryballs or specials first instead.
group optional
Filter the results by a specific group.
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] [filter] [index]

Display info of your or another users last caught countryball.

3 options
user optional
The user you would like to see
filter optional
Filter the last caught countryball by a specific filter. Only works if the user has caught at least…
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] [ephemeral]

List your countryballs.

8 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.
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 shop catchphrase <phrase>

Buy a custom catch phrase, shown under your catch messages.

1 option
phrase
Your new catch phrase. Buying again replaces the old one.

/ballsbux shop favoriteslot

Buy extra favorite countryball slots. Stackable.

/ballsbux shop guaranteedspecial

Guarantee your next catch has a special background.

/ballsbux shop mytraderdiscount

Buy a personal discount on your own wandering tradesman purchases.

/ballsbux shop rarespawn

Make the next spawn in this server a rare one.

/ballsbux shop rarityboost

Boost the chance of rare specials for the whole server.

/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 spawnboost

Boost countryball spawns for the whole server.

/ballsbux shop specialboost

Boost your own chance of rare specials for a while.

/ballsbux shop streakfreeze

Buy a streak freeze that protects your daily streak in advance.

/ballsbux shop streaksaver

Rescue a daily streak you just broke by missing a day.

/ballsbux shop traderdiscount

Discount the wandering tradesman's wares in this server for a while.

/ballsbux shop traderrarity

Make the wandering tradesman favour rarer countryballs in this server for a while.

/ballsbux shop traderspawnboost

Boost the wandering tradesman's own chance to appear in this server.

/ballsbux shop view

See what the shop sells and 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]

View your Ballspass level and XP progress

1 option
user optional
View another player's battlepass (optional)

/battle

Battle countryballs with other players

/battle abilities <countryball>

See a countryball's battle abilities.

1 option
countryball
The countryball whose battle abilities you want to see.

/battle add <countryball> [special]

Add a countryball to the battle plan.

2 options
countryball
The countryball you want to add to your proposal
special optional
-

/battle ai [difficulty] [amount] [deck] [buffs] [special] [manpower]

Battle Ballsdex itself. It builds its team after seeing yours, and picks counters.

6 options
difficulty optional
How hard Ballsdex tries to counter your deck.
amount optional
How many countryballs each side fields. Minimum is 3, maximum is 10.
deck optional
Start from one of your saved decks instead of picking from scratch.
buffs optional
Whether special buffs apply to your team.
special optional
Start the picker filtered to this special. You can change it in the picker.
manpower optional
Manpower each side gets to spend on abilities. Leave blank for the default.

/battle ai_history [difficulty]

Show your record against Ballsdex.

1 option
difficulty optional
Only show battles at this difficulty.

/battle cancel

Cancel your ongoing battle in this channel.

/battle challenge accept <challenge_id> <deck>

Accept an open challenge with one of your saved decks.

2 options
challenge_id
The challenge number (see /battle challenge list).
deck
Your saved deck to battle with.

/battle challenge cancel [challenge_id]

Cancel one of your open challenges and refund the wager.

1 option
challenge_id optional
The challenge to cancel. Omit to cancel your most recent open one.

/battle challenge create <deck> [wager] [buffs] [duplicates] [abilities] [manpower]

Post an open challenge anyone can accept.

6 options
deck
The saved deck to battle with (also sets the team size).
wager optional
Currency each side stakes; the winner takes the pot. 0 = friendly.
buffs optional
Allow special buffs.
duplicates optional
Allow duplicate countries.
abilities optional
Enable ball abilities (if allowed by the bot admins).
manpower optional
Manpower each side gets to spend on abilities. Leave blank for the default.

/battle challenge list [size] [max_wager] [abilities]

Browse open challenges anyone can accept.

3 options
size optional
Only show challenges of this team size.
max_wager optional
Only show challenges whose wager is at or below this.
abilities optional
Only show challenges with abilities on (true) or off (false).

/battle challenge mine

See the challenges you've posted.

/battle deck build <name> [special]

Put a deck together without starting a battle.

2 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.

/battle deck delete <name>

Delete one of your saved decks.

1 option
name
Which deck to delete.

/battle deck list

See your saved battle decks.

/battle deck load <name>

Load one of your saved decks into your current battle.

1 option
name
Which saved deck to load.

/battle deck save <name>

Save your current battle team as a reusable deck.

1 option
name
A name for this deck. Reusing a name overwrites it.

/battle deck view <name>

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

1 option
name
Which deck to view.

/battle history [sorting] [opponent] [days]

Show your battle history.

3 options
sorting optional
The sorting order of your battles.
opponent optional
The user you want to filter your battle history with.
days optional
Retrieve battle history from the last x days at most.

/battle leaderboard

Show the top 10 players by battle wins, across all servers the bot is in.

/battle random <user> [wager] [special]

Battle someone with every setting and both teams picked at random - just confirm.

3 options
user
The user you want to battle with
wager optional
Currency each player stakes; the winner takes the pot. Refunded on a draw. 0 = friendly.
special optional
Draw both teams from this special only. Both players need enough of them.

/battle remove <countryball> [special]

Remove a countryball from what you proposed in the ongoing battle plan.

2 options
countryball
The countryball you want to remove from your proposal
special optional
-

/battle start <user> [duplicates] [buffs] [amount] [abilities] [wager] [manpower]

Begin a battle with the chosen user.

7 options
user
The user you want to battle with
duplicates optional
Whether or not you want to allow duplicates in your battle
buffs optional
Whether or not you want to allow buffs in your battle
amount optional
The amount of countryballs needed for the battle. Minimum is 3, maximum is 10.
abilities optional
Whether or not ball abilities are enabled for this battle (if allowed by the bot admins).
wager optional
Currency each player stakes; the winner takes the pot. Refunded on a draw. 0 = friendly.
manpower optional
Manpower each side gets to spend on abilities. Leave blank for the default.

/battle stats [user]

Show battle stats for yourself or another user.

1 option
user optional
The user whose stats you want to see. Defaults to yourself.

/birthday

BallsDex birthday fragment hunt

/birthday progress

Show your birthday fragment hunt progress.

/birthday solve <code>

Redeem a code you found hidden somewhere for a birthday fragment.

1 option
code
The code you found

/birthday view <fragment>

Look at a birthday fragment's artwork again.

1 option
fragment
A fragment you've already found

/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.

/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 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

/help

Show the list of commands from the bot.

/vote

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

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