Discord Rally Coin Bot

Guide: How to add the Coin bot to your Discord server

Setup

To invite the Rally Discord Coin Bot to your discord server, navigate to the following link:

Discord - A New Way to Chat with Friends & CommunitiesDiscord

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

Setting up your coin is a very important step that will allow many other commands and functionality to work.

Dashboard

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.

Auctions

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.

Key Commands:

Donate

Command: /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 (/donate <qty>). Users must have linked their account at Rally.io with discord for this command to work.

Send

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

Airdrop

Command: /airdrop AMOUNT

A user can airdrop a specific amount of $USD worth of a coin to other eligible users (Discord account connected to Rally) in a Discord server. After using the command, the sender will get a Discord DM from the bot ("coin") asking for them to approve the drop (/approve). The sender and recipient will each get an email receipt for each successful drop. To be eligible to receive a drop, a user must have their Discord account connected to their Rally account.

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. Where you see parentheses () type only the what is inside, leaving out the parentheses. Where you see angle brackets <> type the applicable coin name, role name, or amount of coin leaving out the angle brackets.

Donation Gate

Command: /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: /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 every time 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: / 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.

NFT Gate

Command: /nftGate <role> <NFTTitle> <NFTCreatorCoinSymbol>

Select a Discord role that can be joined for users with the right NFT.

Interactive Coin Giveaway

Command: /giveaway

Creators can set up a giveaway claim button for their Discord members to claim their Coins.

Creators can customize the giveaway based on:

• The roles they want to be eligible to claim

• The duration of the claim window

• Add a personalize note USD amount of Coin for the giveaway pool (the limit is 10 million USD)

• Max number of claimants

The command is already set up so its only one claim per account - the user will see an error message if they try to claim multiple times.

Other Commands List

airdrop Type (/airdrop people <Optional amount of people <= 75> role <Optional role, you can append another role> memo ) to send an even amount of coin in USD to all active, online users in a channel. Will reward a maximum of 75 users.

balance Type (/balance) to see how much coin you currently have.

balanceGate Type (/balancegate role "" amount ) to set the amount coin required to gain a specific role on this server.

bid Type (/bid name amount ) to bid on an ongoing auction. You will find the with the original auction post.

display Type (/display) to add a category to your server displaying your coin name and current price. Type the command again to remove the category. Only roles with admin permissions will see the category until you add a channel to it.

donate Type (/donate memo <message (optional)>) to send a qty of coin in USD to the creator coin of this server.

donation Type (/donation) to see your donations informations.

donationGate Type (/donationgate role @role amount ) to set the amount of donation dollars required to gain a specific role on this server based on users lifetime donations.

help Type (/help) to see this list again.

join Type (/join) to acquire new roles based on your coin balance.

list Type (/list) to see all the roles that can be gained by holding this server's coin.

lookup Type (/lookup <@DISCORD USERNAME>) to see a Discord user's Rally ID.

notifications Type (/notifications channel ) Add's a notification handler for new creators to a designated channel.

setup Type (/setup ) to set the default coin for the server.

recurringGate Type (/recurringGate role "" amount ) to set a monthly recurring gate from donations that will add or remove a specific role to a user from this server.

send Type (/send @discordHandle memo <message (optional)>) to send a qty of coin in USD to the specified user.

summary Type (/summary) to see a summary of info about this server's coin.

ungate Type (/ungate role "") to remove a specific gate required to gain a specific role.