To invite the Rally Discord Coin Bot to your discord server, navigate to the following link :
After you have invited the bot to your server, make sure it has a higher permission order than any role you wish to gate. The bot will not be able to grant a role to a user if the role is higher in the hierarchy than the bot role.
Setup your coin
As the server owner, you will need to setup your coin. To do so, simply go to the server that has the bot installed, and type in the chat
!coin setup <coinname>
(An example would be
!coin setup SKOT)
Setting up your coin is a very important step that will allow many other commands and functionality to work.
As the server owner, it is possible to use the dashboard to manage your gates.
How to use the dashboard
Navigate to the link above and login with your discord admin account. (It is important that you use the right account. Many users don't realise that they log-in to a different discord account when on their browser. You can validate this by ensuring you Username + tag is the same, eg: user#1234)
Once Logged in, you will see your list of servers under the category (Servers) on the left menu. Select the server you wish to use.
If you have not installed the bot yet on your server, you will see a window prompting you to install it. Simply click on the discord Icon at that point and It will bring you to the right page to grant access to the discord bot to your server.
Prior to be able to use the dashboard, ensure that you have setup a coin on your server. Currently you have to manually do this step by going in discord and typing
!coin setup MYCOIN
Once you have selected a server on the left menu, you will be able to visualize quick information about the coin setup on your server using the Dashboard page. In this example, GGSC was used. You can see the coin price at the top, with some other coin information and graphics about them.
The coin summary details of GGSC is available in the cards. More features with the creator coin will be added on this dashboard as it evolves.
You can navigate to the Gates page to manage your server gated role accesses.
Two sections are going to be shown on the page (Active, Inactive).
You will have the full list of roles available in your server shown in the Inactive section. Those are the roles that have not yet been registered with a Gated access.
You can gate the role simply by pressing the Edit button as the end of the row. Doing so will reveal two new fields which you need to fulfill:
The gate types follow the same structure as mentioned below in this documentation.
Once you are done you will be able to monitor how many users have subscribed to the role
You can navigate to the Auction page to manage your server’s auctions.
You will be greeted by a blank page with a Create button to the right.
Click Create to begin creating an Auction.
Required fields are marked with an asterisk (*).
Name: The name of what you are auctioning (e.g. RallyBase Logo Painting)
Unique Command Name: What your fans will enter or paste into the discord chat (e.g. RallyBase Logo Painting-01 )
Channel Name: The name of the channel you wish to hold the auction (e.g. general)
Starting Bid: The USD minimum you’re willing to let the item go (e.g. 20)
Fulfillment Fee: How much you estimate postage or gas fees to be (e.g. 5)
Description: A summary of what your fans are bidding on (e.g. Painting of the Rallybase logo)
Once that’s filled out, click Create. Doing so will start the auction in about one minute and end in one hour.
Changing the Start and End times will change this behavior.
You can select time and date by clicking in either the Start time or End time fields.
Once you’ve clicked Create, a card will show up on the page.
It will also create in the designated Discord text channel an announcement for your fans.
There are several components to this message such as Start Time in UTC.
The associated command to bid on the auction with your minimum bid amount in USD.
If you’ve placed a fulfillment fee it will be mentioned in the message.
The End Date and time are also present.
There will be a follow-up announcement when it starts that will be
Another for when the auction will end soon, it will attempt to trigger 5 minutes before.
On a shorter auction, it will trigger almost immediately.
There are additional options in the form but they are optional.
Adding a picture will make it appear in the announcement message.
The Link field is meant for the item so that your Discord members can view what you are auctioning perhaps a great description and additional pictures than what you could provide.
The last field, the message for the auction winner, is for you to either send them details on the item’s delivery or congratulate them. Or anything else you’d like to tell the winner.
You will notice that in the auction cards their status will change depending on what point the auction is in.
Scheduled: The auction has not yet started
Active: The auction has started
Ending: The auction will end within 5 minutes.
Completed: The auction has ended.
Canceled: The auction was deleted or canceled.
Your fans will be able to bid using the !coin bid --name <name> --amount <number> command.
It will check that they have the proper balance to pay the amount they wish to bid + the fulfillment fee.
Bidding too early will result in an error message.
A successful bid will result in a message to the user informing them that they are in the lead.
A successful bid also announces to the channel that they will need a bid higher than the previously successful bid and suggest a 1$ USD increment.
An auction will conclude at the end date’s indicated time.
If there are no bidders there will a message indicating that.
However most times there will be a winner and that will result in the winner receiving a message
You will receive another message with the winner’s information and payment status.
You must be a Creator in the Rally network and have your own creator coin
The Discord Coin Bot requires you have a Discord server
You must link your Rally.io account with Discord. (https://www.rally.io/settings/)
!coin donate <qty>
A user can directly donate to the specified server coin setup. This simplifies the process for a fan to donate directly to the creator by using the discord bot command (
!coin donate <qty>). Users must have linked their account at Rally.io with discord for this command to work.
!coin send @DiscordUserName <qty>
A user can directly interact with other users inside the discord server by trading the specified server coin setup. This allows for a simplified transaction without the need to go at Rally.io. Users must have linked their account at Rally.io with discord for this command to work.
There are three types of gates available with the bot, which will allow users to grant themselves a role based on certain criteria's. This allows creator to give special access to content, events or rooms based on their needs.
!coin donationGate --role "<Role Name>" --amount <AMOUNT>
The Donation Gate will grant a role based on a user lifetime donations in USD to the server coin setup.
This is a once valid, forever valid gate. If the user has reached the threshold, he will keep indefinitely the role.
!coin balanceGate --role "<Role Name>" --amount <AMOUNT>
The balance gate will grant a role based on a user current coin balance he's holding.
The balance of the user is checked everytime he performs a transaction. If his balance drop belows the requirement for the gate, the user will be removed from the role. He can regain it again by obtaining the right quantity and join again.
!coin recurringGate --role "<Role Name>" --amount <AMOUNT>
The recurring gate will automatically validate a user monthly donations in USD and renew his right to keep the role for another month, or remove it.
The recurring gate has a grace period of 3 days. At the beginning of a new month, if a user has not provided the specified donation quantity, he will be messaged to renew in the next 3 days. After 3 days, the user loses the role, unless he donated the amount by then.
The recurring gate starts accepting donations for the next month 2 days in advance, to give enough time to users to renew their commitment to the recurring gate.