ENGAGE 2 EARN - DAO Setup
Setting Up the Bot
This will install the engage 2 earn package in your Discord - you can read more about it here - https://medium.com/@sol-decoder/engage-2-earn-d0726ebc27c0.
To use this, you must:
1) Have the role in the SOL Decoder Discord, with you holding the right number of NFTs
2) In your Discord, have manage server or admin permission
Start by going to "our Add Bots page" on the SOL Decoder website. At the top, click the link to invite the Bot to your Discord. Click "Add" underneath your server. It is recommended that you then setup the rest of our Alpha Discord bots, as seen here.
You can then enable the "Engage 2 Earn" package
Add the bot to each channel
You must also add the SOL Decoder bot to each of the channels it will use, having read only permission for announcement / chat channels. For the channel where users will use the bot commands, add it their with (1) the SOL Decoder role having send message / embed links permission, and (2) Regular users having "Application Commands" permission
If you wish to have users get XP for liking / retweeting your tweets, then you need to fill out the Existing DAO Seamless profile, seen on the top of the page. We need your Twitter account linked, for users to know which Twitter to like & retweet.
Discord XP Channels
Lets start setting it all up now! Start by clicking the "Manage Discord XP Channels" button, on the top of the "Engage 2 Earn" setup panel. Channels you select here will make your users gain XP when chatting.
XP amounts
You can change the amount of XP users get for liking a tweet and retweeting a tweet (we recommend 10 XP for liking, and 10 XP for retweeting).
You can also customize the amoutn of XP each quest gives. We recommend 5 XP here.
Note that they will get 1 XP per chat message.
Quests
These will be daily quests that users can complete once a day (reset at midnight EST). Enable whichever you want, and tap on "Configure" and "Manage" to set the channels / phrases where needed.
Note for twitter quests: you must make a new tweet and wait 15 minutes. Any old tweets (from before you set it up) will NOT work if you claim XP. Additionally, only new tweets are claimable - not retweets, not quote retweets, not comments by default. Ask us if you want ALL tweets to be claimable.
Also note that while the quest for liking / retweeting can only be done once a day - you can still like / retweet as many tweets as you want per day, to get XP for them. And liking / retweeting isn't enough - you must use the /claim command within your Discord to claim the XP for your twitter actions.
You can also have a quest for a user to say a phrase within chat (such as "gm", "wgmi", or whatever you want). We recommend not putting in more than 2 phrases, however.
Discord Roles
Chatting, raiding tweets, and doing quests will give you XP within the Discord. After getting enough XP - you can advance to new levels (roles). You will receive a new role, and lose the old role.
Steps:
Click "Manage Discord Roles".
Option A) The easiest thing is to use the Discord roles we came up with, along with their icons (50 roles based on Military Ranks). Just click "Save changes" and you're done! Make sure the roles show up in your Discord.
Option B) If you want to create your own roles, enter the Role Name and XP for each role. Click the "+" to lock that role in, and add another role if you wish. See the "Tips on Roles" in the FAQ below for more information.
Deleting roles:
Want to delete all of the roles it created? Sure thing, ask us how and we'll show you. We don't publicly show this, in the chance that you accidentally delete an existing role such as a whitelist role.
Sync Discord Roles
To sync the roles of all your guild members, use the "Sync Levels" button. You can also use this if you've edited / deleted / added new roles while your users have been gaining XP. It will be very rare that you should have to click this button.
Set Notifying Channel
As discussed above, you should have a "Bot Commands" channel, that users can type in to, and interact with the bot. When users level up - you can have that channel tell the user they leveled up, by setting it here within the website.
Make sure to also follow the "Add the bot to each channel" section above! This new channel must have the SOL Decoder bot added to it, with 'View/Send message' permissions.
Message Cooldown
By default, chatting only gives XP to each user every 15 seconds, to prevent spam. If you want an even greater cooldown (hyped new mints should use 8 hours+), then set that here.
Reward your Top Engagers
Use can also a command to pick a winner from a past week's leaderboard. Each weekly leaderboard resets on Sunday night, so on Monday you can use the following command: /giveaway_leaderboard
- Select how many winners it will choose to win the raffle (ie. 1 or 3 people)
- Choose how many people in the leaderboard will enter the drawing (ie. top 500 of the leaderboard)
- Choose which week ending date to search on (if you chose 10-08, it will draw the previous week of 10-1 to 10-07)
You can use this to give out a larger amount of SOL to a person as a raffle, or give out one of your NFTs, for example. It will also give more entries to those that are higher up in the leaderboard, to try and reward those more engaged. The breakdown looks like this:
- If in top 1% of the drawing, get 50 entries
- Top 5% - 30 entries
- Top 10% - 20 entries
- Top 30% 10 entries
- Top 50% - 3 entries
Using the Website for additional features
We'll go over some of the features that you'll use on the SOL Decoder website. Note for an expanded overview (tailored for a user) - please read this.
Start by clicking on the "Engage-2-Earn / Quests" on the sidebar. You'll need to first login with your Twitter account (we recommend your personal Twitter account, so you can like / retweet both your tweets and tweets from other peoples Discords if you are participating in their Engage 2 Earn). This is the account the bot will check to see if you've liked / retweeted things, when completing your own quests.
Once logged in, you'll see your server, and you can click "view quests" under your Discord to view the active quests for it. And at the top you can click "Claim tweet XP" (something need to do once a day to claim your like / retweet actions) and a link to the Leaderboard.
Click the Leaderboard to see a list of all Discords, and then search for your Discord and click on it. You can use these leaderboards to rewards your users each week. Note that weekly leaderboards reset on Sunday at midnight EST.
On the top right you'll see a drop down to choose past weeks data. Given the weekly leaderboard resets Sunday at midnight EST - you can log on Monday morning, and view last week's leaderboard. If you wanted to tag a certain amount of them that they won something - you can do the following:
- Expand the number of rows shown by default, on the bottom of the table
- Copy / paste however many people from the top of the leaderboard, that won something
- Paste it into Excel
- In the last cell, paste this formula
="<@"&C2&">"
- It should look like the image below, in column F. You can copy column F into Discord, and it will automatically ping people. You could, for example, ping everyone in your Giveaways channel, then make a thread off that message, and within there ask everyone for their wallets to give something to
Below is an example of how you can use the Leaderboard to give out rewards, plus of how you can teach your community what engage-2-earn is.
Bot Commands
/quests
You can check the status of all your quests with this command.
/claim
Use this command when the Twitter account linked to this Discord has tweeted, so that you can claim the XP.
/xp
See how much XP you have within the Discord.
/leaderboard
See who's on top of the weekly leaderboard.
FAQs
Okay everything is setup, how can I test it, before sending it to users? Here are steps to help you on that!
1) To make things easier, go to https://soldecoder.app/dao, then look for your Discord, then click "Add" and update the "Existing Seamless Profile" to be personal twitter account. Note: Once all the tests are done and successful, you can just do this again and replace it with your official twitter.
2) Make a tweet. Then just like and RT your own tweet.
3) The tweet won't be tracked for 15 minutes, so go do the other quests first
4) Type /xp in a channel meant for bot commands, note your XP
4) Type any message in your chat channel that you chose to track chat XP
5) Now type /xp again and make sure it went up by 1
6) React to an announcement (given you enabled this quest and set it to your announcements channel). Make sure your /xp went up appropriately
5) Type /quests - once you see the ✓ it means it's completed
6) Type /claim once the 15 mins have passed since you tweeted, as now your new tweet is ready to be claimed
7) Type /quests and make sure the like & retweet twitter quests showed up with a ✓ mark
8) Type /xp to make sure everything went up appropriately
9) If you received enough XP to be level one, check the channel where it alerts users of level ups (if you had set this Notifying Channel). Make sure it said it leveled you up
10) Make sure you have the Discord role for your new level (if you don't, make sure the SOL Decoder bot is higher on the list than other roles)
11) Once all quests are checked off, you can go back to the Seamless profile page and change it to your official Twitter
12) You can then announce this to your users (example way above)
13) You may also tweet about this, and tell us and we'll retweet it :)
You can then announce this to your users, and here is an example announcement from the SOL Decoder Discord - https://discord.com/channels/925207817923743794/927623074650656798/1021531460328505406
You can also include this link for them to read - https://docs.soldecoder.app/books/intro/page/engage-2-earn-user-overview
What is the purpose of the Discord roles?
People like leveling up and competing against one another, with how engaged they are. If your Discord roles also have icons on them, people like unlocking those new icons and seeing it within chat. All of the roles are given out automatically as the user gains XP through various actions.
Tips on Roles?
When creating your own roles, we recommend the max role have 30,000 XP+. This will take your most active user a few - several months to achieve. We balance the XP out across 50 levels to do this.
(For new mint servers) When creating your own roles, you can use an existing role, but it is recommended to not use one of your existing whitelist roles. This is in case you accidentally delete it, or people level up so lose it. Instead, give a new 'Claim whitelist' role, and then use a bot like Unbelievaboat or Dyno. These bots can give everyone with the "Claim whitelist" role your actual whitelist role.
Note role icons won't work unless your server is boosted to level 2.
Also make sure the newly created roles are moved higher than other existing roles with icons in the Discord list. This is so they will show up when people chat. People like leveling up and showing off roles!
How to connect your twitter on Engage 2 Earn?
First, you need to create a seamless existing DAO profile, and link your Twitter there. Once that's done the quest from likes and retweets are under the twitter that you registered.
Why are the like and retweet quests not working?
You must make a new tweet AFTER enabling the engage-2-earn package. As written in the first step of the FAQ - we recommend using your own personal twitter so you can freely tweet to test this.
After tweeting, you have to wait 15 minutes for that tweet to be tracked. After waiting you may use the /claim command to get your XP and complete the quests.
Note: By default, quote tweets / retweets / comments don't gain XP. Let us know if you want this enabled for your Discord
Note: if still having trouble, (1) tell us which Twitter is linked to your https://soldecoder.app/quests page, (2) show us a screenshot of you liking / retweeting a tweet that you linked to the "Existing Seamless profile" page, and (3) in a SOL Decoder Discord ticket, type /claim and ask us about it
What to do about the Wick bot?
If you're using the wick bot, it will quarantine SOL Decoder after it creates numerous roles. You can try to whitelist the bot to allow creation of those roles - though easiest if you make it a trusted admin.
If you want to unquarantine the bot, an admin can type within Discord: w!uq 927008889092857898
Channels are showing as N/A in my quests list
Make sure to add the SOL Decoder bot role to your channels. Instructions near the top of this page.
I completed all the quests, but the website shows all are done but the "complete all quests" quest
In your Discord type /quests. See if it shows any extra quests that may have N/A in them. If it does, see above question
I'm getting a "Could not get your server..." error
Make sure to invite the Bot to your Discord! The link is on the "Add bots/seamless" page on the sidebar. You will later update the bot with a new permission, when on the engage-2-earn page.
How do I see the leaderboard from last week?
- Go to https://soldecoder.app/quests
- On the top right, click "View Leaderboards"
- Search for your server on the top right
- Click on your server (and then delete the search you did on the top right)
- On the top right, click "Live Data". Now click one of the dates to see a past week. Note if you click on 10-08, then you are viewing 10-1 to 10-7
How come commands like /quests work for me, but not others?
- Edit the channel
- Permissions
- Advanced Permissions
- Click "@everyone"
- Scroll to the bottom
- Enable the "Use Application Commands" permission
- Click "Save Changes"
I leveled up, but my role icon wasn't updated?
You have three options:
1) drag any existing roles below the new roles that were created
2) drag the new roles above your existing roles (that have icons)
3) remove icons from any existing roles
Looking at the below as an example, this user would have the "1 - Private" role icon show up, because that icon is higher than "4-nft" which has its own icon.
What to do if I encounter "You don't have enough NFTs" error?
Click "Add bots/seamless" on the sidebar, and scroll down until you can see the "Enable NFT Check for your Discord Server" section. Find your Discord server and click enable. This should claim your Discord server to only check your Discord account, which should have the right number of NFTs.
What to do if you encounter this error?
Make sure you invited the bot from the Engage-2-Earn page - instructions at the very top of this page.
How to make the most use out of Engage 2 Earn
Make sure you:
- Create weekly announcements & tweets, showing the past week's winners and showing what upcoming week's rewards are
- Enable the daily quests for tweet likes / RTs ... and tweet at least once a day
- Have the custom roles created (either use ours, or make your own). Make sure as people level up - an icon is shown next to their name. This gives people something to work towards, in the months / years they will be in your server
- Have some sort of rewards, examples (cheapest to most expensive):
- Whoever gets top 10 in the leaderboard gets a new role, with a new chat color. Remove the next week if they don't get top 10
- Give out whitelists for upcoming projects to the top 20
- Give out the $DCODE token, that you get for staking
- Give out SOL / NFTs / Discord Nitro. Either to the top places, or use the weight raffled command that is built in
- Work with another NFT to have them "Sponsor" a week of your engage-2-earn - they will give you whitelists / SOL / NFTs, and in return you announce / tweet about them
Also if you are giving rewards out to the top of your leaderboard (ie. top 5), and you see a few members of your community spamming your chat - you can contact us to have their chat XP slowed down in two ways:
- longer time it takes between messages, to gain XP
- very short messages no longer count for XP
This will slow down XP gain for the strict top 5 of your leaderboard for a given week (with the list dynamically updating).
Customer Service
If you are encountering bugs or having trouble installing "Engage 2 Earn", please reach out to us. Just go to https://discord.gg/sol-decoder and create a ticket and one of us will assist you immediately.
Want even more features?
Tell us, and we can enable the below features for your Discord:
Give certain roles an XP multiplier! For example - users that hold 3 of your NFTs can get a 20% multiplier across all engage-2-earn XP earnings.
NOTE -- if you want to give someone a 20% boost, then use a multiplier of 1.2! If you use a multiplier of 0.2, then they are getting LESS XP per message. You can however use this to give one of your staff a 0.001 multiplier - then they won't show up on leaderboards!
Currently we support giving XP if a user likes or retweets one of your tweets.
You can also add a list of twitter handles, that you would like a user to tag in a tweet. They will then get XP for tagging those handles.
Note by default these commands are hidden from everyone. Go to server settings -> integrations -> SOL Decoder -> then enable those commands for the roles of your choice. Be careful not to enable them for everyone - only trusted roles that should be able to manage portions of your server!
Use on PC if you can't get it to work on mobile.