Skip to main content

Search GiselleBot's commands and docs.

Try /ban, or start with / for commands only.

Press Ctrl K anywhere in the dashboard to open this.

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 /timely command.
  • 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

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

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

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

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.