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 will give a small amount of currency to the user (a cooldown is applied to avoid plain spamming just to 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.

Currently, the main goal of currency is playing with games. More uses are planned, but still not implemented.

/balance

Command Syntax

/balance [user:{user}]

Command Description

Shows the current amount of currency of a user. By default, it will show the currency wallet info of the user that 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 a certain amount of currency from the user running the command to the target/receiving user.

Note

amount must be a positive whole number. There's no shortcut to transfer your entire balance in one command - specify the exact amount.

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

Once a day (by default, but the cooldown can be configured by the bot owner) users can earn a specified amount of currency by running this command. The default amount of currency earned is 10 per command run.

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

Examples

/timely

Top.gg Voting

As an additional source of income for bot currency, and as a way to show your appreciation to GiselleBot, you can vote for GiselleBot on Top.gg (click on the website name to be sent to the bot page).

Any Discord user can vote for each bot once every 12 hours. Each vote for GiselleBot will award you with 250 currency coins.

To help give GiselleBot a better chance to fight for the top spots, votes will count double on the weekend (Fridays, Saturdays and Sundays). This also means double the amount of coins!

Users will only be notified once per vote reset.

Note

Enabling the notification for when your vote is available again is done from your account's Preferences page on the dashboard.

Bots on Discord Review Reward

As an additional source of income for bot currency, and as a way to show your appreciation to GiselleBot, you can leave a review for GiselleBot on Bots on Discord (click on the website name to be sent to the bot page).

/validatereview

Command Syntax

/validatereview

Command Description

This command will anonymously validate your Bots on Discord review within the bot. GiselleBot will check for the existence of a review on your name, and will award 25,000 currency coins if found.

It will not know which specific review was submitted, nor its positive or negative state.

This reward can only be obtained once!

Note

Whether you've already claimed this reward is also shown on your account's Preferences page.

Permissions Needed

User: None - open to everyone by default (see the Permissions System)

Examples

/validatereview

/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 now 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) - or a Discord timestamp mention referring to a future time - described in Time Format Code.

/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. Modified cooldown applies to everyone immediately, but doesn't reset users' cooldown.

Running the command with no options will show 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. It's 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 reacting user will be gifted with 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

Checks are in place to ensure that users will only receive their gift the first time they react. Reacting more than once will not assign any 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