Currency System
Each user known to the bot has a currency wallet. Currency is earned in a few ways:
- Each message sent in a channel the bot has access to gives the user a small amount of currency (a cooldown applies, so plain spamming does not earn currency).
- Once a day, using the
/timelycommand. - Every once in a while, reacting to events on the main bot support server.
- Playing with games.
Currency is currently used only for games. More uses are planned but not implemented.
/balance
Command Syntax
/balance [user:{user}] Command Description
Shows how much currency a user has. By default it shows the wallet of the user who runs the command. Provide user to check someone else's wallet.
Permissions Needed
- User: None - open to everyone by default (see the Permissions System)
Examples
/balance /balance user:@cycloptux
/pay
Command Syntax
/pay user:{user} amount:{amount} Command Description
Transfers currency from the user running the command to another user.
Note
amount must be a positive whole number. Specify the exact amount; there is no option to send the whole balance at once.
Permissions Needed
- User: None - open to everyone by default (see the Permissions System)
Examples
/pay user:@cycloptux amount:5000
/timely
Command Syntax
/timely
Command Description
Users can run this command once a day by default, though the bot owner can change the cooldown. It awards 10 currency per run by default.
Permissions Needed
- User: None - open to everyone by default (see the Permissions System)
Examples
/timely
Top.gg Voting
You can vote for GiselleBot on Top.gg to earn extra currency. Clicking the site name opens the bot page.
Any Discord user can vote for each bot once every 12 hours. Each vote for GiselleBot awards 250 currency coins.
Votes count double on the weekend (Friday, Saturday and Sunday), which gives GiselleBot a better chance at the top spots and pays you double the coins.
Users are notified once per vote reset.
Note
You can enable the notification for your next available vote from your account's Preferences page on the dashboard.
Bots on Discord Review Reward
As another way to support GiselleBot, you can leave a review on Bots on Discord (clicking the site name opens the bot page).
After leaving a review, claim the reward from your account's Preferences page on the dashboard. The "BotsOnDiscord Review Reward" card anonymously checks whether a review exists under your name and, if one is found, awards 25,000 currency coins when you click Claim. It cannot tell which review you submitted, or whether the review is positive or negative.
This reward can only be obtained once. The Preferences page also shows whether you have already claimed it.
/leaderboard currency
Command Syntax
/leaderboard currency [page:{page #}] Command Description
Prints the global currency leaderboard.
Permissions Needed
- User: None - open to everyone by default (see the Permissions System)
Examples
/leaderboard currency /leaderboard currency page:3
Custom Currency Emoji
Note
Setting a custom emoji as currency in a server is configured from the server's Settings page on the dashboard.
Stonk Market: Buying and Selling Broccoli
Note
The Stonk Market broccoli minigame has been retired with no replacement and is no longer available.
Bot Owner Reserved Commands
All bot-owner currency tools live under the /owner command tree.
/owner timely reset
Command Syntax
/owner timely reset
Command Description
Resets the /timely countdown for everyone.
Permissions Needed
- User: Bot Owner
Examples
/owner timely reset
Note
The duration options below (/owner timely set, /owner currency event) take the standard time code (e.g. 1d3h2m) described in Time Format Code, or a Discord timestamp mention referring to a future time.
/owner timely set
Command Syntax
/owner timely set [duration:{time code}] [amount:{amount}] Command Description
Sets the global cooldown and/or currency amount for the /timely command. A changed cooldown applies to everyone immediately, but does not reset the cooldowns users already have.
Running the command with no options shows the current settings.
Permissions Needed
- User: Bot Owner
Examples
/owner timely set /owner timely set duration:12h amount:20
/owner currency award
Command Syntax
/owner currency award amount:{amount} [user:{user}] [role:{role}] Command Description
Awards the selected amount of currency to a user, or to every member of a role.
Note
user and role are separate options: provide one to target a specific user or every member of a role. If neither is given, the award goes to you.
Permissions Needed
- User: Bot Owner
Examples
/owner currency award amount:5000 user:@cycloptux /owner currency award amount:1000 role:@Premium
/owner currency take
Command Syntax
/owner currency take [amount:{amount}] [all:{true|false}] [user:{user}] [role:{role}] Command Description
Takes the selected amount of currency from a user, or from every member of a role. Set all:true instead of amount to remove all of the target's currency.
Warning
The currency is permanently lost and is not transferred to the owner.
Permissions Needed
- User: Bot Owner
Examples
/owner currency take amount:500 user:@cycloptux /owner currency take all:true role:@Banned
/owner currency event
Command Syntax
/owner currency event [amount:{amount}] [pot_size:{amount}] [duration:{time code}] Command Description
Starts an event reaction in the current channel. Each user who reacts receives amount currency. Set pot_size to cap the total currency given out across the whole event (e.g. amount:50 pot_size:100 only rewards the first 2 users). duration sets how long the event runs.
Note
Users only receive the gift the first time they react. Reacting more than once awards no extra currency.
Default values on omission:
- Amount: 100
- Pot Size: 0 (= no limit)
- Duration: 1 day
Permissions Needed
- User: Bot Owner
Examples
/owner currency event amount:50 pot_size:500 duration:1h
See also
Full migration mapping for these commands: Migration Guide.