Rally Creator Coin Bot for Discord

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

While we update this Wiki, you can find the current documentation (includes new features, etc.) here.

Creators! Host a Discord server for your community? You can now offer recognition roles and special access to your Creator Coin holders. You can also tip the creator and send coins to other fans right from Discord!

As you may already know, Discord offers features to create a chat and multimedia server to host a community around a common interest. As many Rally communities use Discord, we saw an opportunity to build a bot to recognize holders of the various Creator Coins so that each community can offer roles and benefits to enhance the Creator Coin experience.

The Creator Coin Discord bot enables you to utilize the Rally API to create new roles and access based on:

  1. the amount in coins of a particular Creator Coin a user holds;

  2. the amount in USD of a particular Creator Coin a user has donated lifetime; and

  3. the amount in USD of a particular Creator Coin a user has donated in a given calendar month (this of this like a subscription).

Process At-a-Glance: Installing Coin Bot and Connecting Fans

Discord Admins

  1. Add the Creator Coin bot (coin_bot) to your Discord server.

  2. Give coin_bot permissions to appropriate channels.

  3. Create 1 or more roles for coin holders.

  4. Configure coin amount needed to access role.

  5. Assign new roles to new or existing channels.

Coin Holders

  1. Link your Discord account to Rally.

  2. Request role/channel access from coin_bot.

Important

Keep Discord DMs Open

The bot will send some system messages as DMs from a Discord user named “coin” (coin#1724) with the Rally logo as avatar.

Polling Frequency

The coin_bot frequently polls Creator Coin totals. For example, if a user donates or redeems enough coins to fall below the amount required for a role, coin_bot will send a message to that user notifying the user of the role removal.

HowTo For Discord Admins

Add the Creator Coin Bot (coin_bot) to Your Discord Server

  1. Go here to add the Creator Coin bot to your server. This also adds a role named “coin_bot” to your Discord server.

  2. Make sure the coin_bot role is added to any channels where you want coin_bot to monitor commands and access.

  3. After adding coin_bot to your server and channels, set up your coin in your server using the following command:

Syntax: !coin setup COINSYMBOL

NOTE: COINSYMBOL should be replaced with the actual symbol of your Creator Coin, usually in all capital letters, such as: KSK, STANZ, ROFF, MOON, etc.

!coin setup DTQ

Create Roles, Access Rules, and Channels for Creator Coin Holders

Using existing Discord features, you can create new roles to recognize and provide special access to Creator Coin holders and spenders. Once you have one or more new roles created, you can assign those roles to public or private channels.

When a user requests to join (!coin join) coin-based roles, the user will receive any roles the user qualifies for at that time. A user may need to try to join again in the future should they be eligible for a role that is new or a role they were not previously eligible for.

If a user drops below the requirement for a role, the role is removed immediately.

Configuring Role Access for Coin Holders

Here’s the syntax and an example for setting the amount of coins a user needs to hold to attain a holding based role.

Having a role for coin holders is a good way to gate basic membership in Discord. You can set a relatively low coin amount to make it inexpensive for people to join and keep membership as long as they hold at least the specified number of coins.

Syntax: !coin balanceGate --role "ROLENAME" --amount AMOUNT

Note: The ROLENAME should be replaced with the actual role name and must have quotes around it and should not start with @.

Example

  • Role: QuestCrypto 5 (ROLENAME is case sensitive.)

  • Amount in coins: 5 DTQ coins (AMOUNT must be a numeric value.)

!coin balanceGate --role "QuestCrypto 5" --amount 5

Configuring Role Access for Lifetime Donators/Spenders

You can set up a role for people who have donated/spent a minimum amount in USD over their lifetime in your coin.

A lifetime coin donated/spent role is a great way to recognize those people who have regularly supported you by being active users of your Creator Coin. This is a great role to give a very high ranking in your Discord for maximum visibility and prestige.

Syntax: !coin donationGate --role "ROLENAME" --amount AMOUNT

Note: The ROLENAME should be replaced with the actual role name and must have quotes around it and should not start with @.

Example

  • Role (case sensitive): MOON Coin VIP

  • Amount in USD (AMOUNT must be a numeric value): 100 = $100 USD value.

!coin donationGate --role "MOON Coin VIP" --amount 100

Configuring Role Access for Monthly Donators/Spenders

You can set up a role for people who have donated/spent a minimum amount in USD in a given calendar month in your coin. If a user reaches the donation minimum in the last two days of the month, the user receives the current month and the following month. The role expiration grace period is three days into the following month.

A monthly coin donated/spent role can be used in a variety of ways. We think this is a great way to define a subscription type offering where you as the creator offers month based benefits for achieving the minimum monthly donation amount.

Syntax: !coin recurringGate --role "ROLENAME" --amount AMOUNT

Note: The ROLENAME should be replaced with the actual role name and must have quotes around it and should not start with @.

Example

  • Role (case sensitive): ALLIE Coin Monthly

  • Amount in USD (AMOUNT must be a numeric value): 5 = $5 USD value.

!coin recurringGate --role "ALLIE Coin Monthly" --amount 5

HowTo for Coin Holders and Spenders

  1. Log in to your account on Rally.io.

  2. Under Integrations, click Link by the Discord option.

Join a Creator Coin Role

(You must first link your Discord account to Rally before entering this command.)

In an appropriate channel on the Discord server, request to join any Creator Coin based roles:

!coin join

Command Reference

COMMAND

DESCRIPTION

ALL USERS

!coin join

Connect to the bot to join any roles and channels based on the amount of the corresponding coin you hold.

!coin balance

The amount of coin you hold in the set Creator Coin.

!coin donation

The amount in USD value you have donated in the set Creator Coin.

!coin summary

For the corresponding coin, returns the current amounts for:

  • total supporters

  • total transactions

  • total support volume

  • total amount of coin distributed

!coin list

The list of channels that have gates and the coin amount required.

!coin help

The list of commands for the bot. List returns commands based on server role (Admin vs non-Admin).

!coin donate AMOUNT

The amount in USD value to send to a creator as a donation, or tip.

!coin send @discordusername AMOUNT

The amount in USD value to send to another user. Both the sender and the receiver need to have previously connected their Discord accounts to their Rally accounts.

MIXED USE

!coin lookup @discordusername

Non-Admins: Look up your own Rally ID via Discord name.

Admins: Look up any user’s Rally ID via Discord name.

ADMINS ONLY

!coin setup COINSYMBOL

Set up your coin in your Discord server by telling coin_bot which coin to monitor. COINSYMBOL must be entered in all caps.

!coin balanceGate --role "ROLENAME" --amount AMOUNT

Set the minimum amount of coins required to attain a particular role. ROLENAME is case sensitive and must include any punctuation (eg, spaces, hyphens) used in the role name. Must be enclosed in quotes.

AMOUNT is a numeric value representing a number of coins. Example: 5 equals 5 coins in the set Creator Coin.

!coin donationGate --role "ROLENAME" --amount AMOUNT

Set the minimum amount in USD required to attain a lifetime donation role. ROLENAME is case sensitive and must include any punctuation (eg, spaces, hyphens) used in the role name. Must be enclosed in quotes.

AMOUNT is a numeric value representing a number of coins. Example: 100 equals $100 USD in value of the set Creator Coin.

!coin recurringGate --role "ROLENAME" --amount AMOUNT

Set the minimum amount in USD required to attain a monthly donation role. ROLENAME is case sensitive and must include any punctuation (eg, spaces, hyphens) used in the role name. Must be enclosed in quotes.

AMOUNT is a numeric value representing a number of coins. Example: 5 equals $5 USD in value of the set Creator Coin.

!coin ungate --role "ROLENAME" --amount AMOUNT

Remove a previous role configuration.