Rally.io
Search…
Rally Creator Coin Bot for Discord
Guide: How to add the Creator Coin bot to your Discord server
This page is under reconstruction.
Setup
Dashboard
Auctions
To invite the Rally Discord Coin Bot to your discord server, navigate to the following link :
Discord - A New Way to Chat with Friends & Communities
Discord
IMPORTANT
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.
Rally.io - Discord bot dashboard
How to use the dashboard
    1.
    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)
    2.
    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.
    3.
    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.
    4.
    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

The dashboard

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.

Setting a new Gated Role

Ensure that the role bot always has a higher hierarchy than any other role that you wish to gate. Discord policy blocks a lower role from granting access to higher role. You must do this in discord manually.
In this example, the coin_bot role is above all other roles in the list.
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:
    Amount
    Gate Type
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

Important

    Once you have gated a role, you cannot change the gate type, unless you delete the gate, and make a new one.

Creating an Auction

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.
Example of a filled out auction form
Once you’ve clicked Create, a card will show up on the page.
Card created to represent an auction
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.
Announcement for the start of an auction
On a shorter auction, it will trigger almost immediately.
Auction ending in less than 5-minute warning message
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.

Bidding on an Auction

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.
Message when someone bids more than they have
Bidding too early will result in an error message.
Message when a bid is placed before the start time
A successful bid will result in a message to the user informing them that they are in the lead.
Leading bid message
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.
Message to bid higher than 1$ in a copy pastable format

Ending an Auction

An auction will conclude at the end date’s indicated time.
If there are no bidders there will a message indicating that.
A message announcing no one has won
However most times there will be a winner and that will result in the winner receiving a message
Message received privately announcing your victory and how to pay
You will receive another message with the winner’s information and payment status.
A message with the winning bid’s information and payment status

Requirements

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

Commands

Anytime you see <value> inside a command, it is meant to be fulfilled without the brackets '<' and '>' when actually using the command in discord.
Command: !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.

Send

Command: !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.

Gates

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.

Donation Gate

Command: !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.

Balance Gate

Command: !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.

Recurring Gate

Command: !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.
Last modified 1mo ago