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 the "Manage Bots page" on the SOL Decoder website. At the top, click the link to invite the Bot to your Discord. Once invited, click "Manage" 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.
Note - once you're done setting it up, please go into our Discord, and either in your tickets or in "decoder-bot-commands", type !post-engage. You'll see how you can announce it to your users, and tweet at us so we can retweet!
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
Link your Twitter
If you wish to have users get XP for liking / retweeting your tweets, then you need to fill out the "Existing DAO Seamless profile". This is seen when you are editing the packages on your Discord, and scrolling to the the bottom of the page. Click the "Click to Show the form (currently only used to enter in your Twitter for the Engage-2-Earn section)" link there.
We need your Twitter account entered, for users to know which Twitter to like & retweet. Note the "Twitter Link" field here.
You will later go onto https://soldecoder.app/quests and link your OWN Twitter account. When on the /quests page later, again make sure to link a separate account, so you can get XP for liking / retweeting your project's Twitter.
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 (this MUST be 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.
Note - once you're done setting it up, please go into our Discord, and either in your tickets or in "decoder-bot-commands", type !post-engage. You'll see how you can announce it to your users, and tweet at us so we can retweet!
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. You can however have only 3 roles, or you can have 100, up to you. You can also edit the names / icons after we create the default 50.
(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 (instructions on the top of the page), 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.
Do you have a in-discord shop for users to spend their XP, or a way to auto send out a SPL token?
We do not offer that feature - we instead give things to the top 5 or 10 each week, or we use the /giveaway_leaderboard command in Discord to run a raffle over a large portion of that week's leaderboard. We've found that others who offer shops aren't very well stocked anyway - as not many projects have enough money to give out dozens of rewards to users each week. Thus giving a small amount of rewards manually isn't too big of a hassle. Plus our tool has no monthly cost (and tons of other bots like AI bots), so saving even more that way!
We also have no way to auto send out a SPL token. We've seen other projects have this ability and it gives pennies for someone raiding a tweet (as again not many projects have enough to give tons to all of their raiders). As such we've not implemented this feature, again relying on only giving 5-10 things out per week manually to people. And again we're otherwise concentrating on adding more features to our AI bots (which can be used by tens of thousands of servers in the future).
How can more features be added?
We are not prioritizing features for the Engage-2-Earn currently. We are instead focusing on our AI bots (https://aidocs.soldecoder.app). If you wanted to add more features, you can always discuss with us and you can directly pay one of the developers to add features at a cheap rate, and implementation is often very quick.
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
Are we able to show leaderboards just for raiding for example, or is the leaderboard cumulative of all XP?
Leaderboards is all XP. If you wanted just raiding, you'd have to disable all of chatting xp
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 type /quests but I get "Sorry, something went wrong..."
You most likely have too many, or too long of the "daily phrases". Trim them down, or delete some.
Remember these are phrases that you want people to type everyday. Not very engaging if people are copy and pasting very long (and multiple) phrases.
People spamming / deleting messages?
If a member sends a message and deletes it, and repeats this every 15 seconds (the default cooldown) - you see who is doing this with the Dyno bot (which can log what messages are deleted, and by whom, to a private channel). You can then easily search within that channel, doing "in:<channel name> <user id> deleted". For example "in:action-logs 450169544250490880 deleted".
This will bring up all of the messages that user deleted. You can then grant them negative XP for all of the messages they deleted, ie. "/grant_xp: <member> -200". And then you can tell them to stop doing that or you'll delete even more XP.
How do I put in "Raid 2 Earn"?
This can be accomplished in a few different ways:
1) Contact us and we'll enable your retweets to count as XP. You can then retweet other people's tweets, and when your members retweet it, they will get XP
2) Look at the bottom of this document at the "More ways for users to get Twitter XP!" section. This is yet another thing we can set on your account, and you can have people either (A) permanently interact with another Twitter account to get XP and/or (B) have them comment on tweets with your Twitter handle (tagging you), and getting XP for doing so
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
- For whitelists you give out, give bonus entries to people in this role
- 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. Once we enable it, go to our dashboard, disable E2E, then enable it.
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 120! If you use a multiplier of 1, then they are getting LESS XP per message. You can however use this to give one of your staff a 1 multiplier - then they won't show up on leaderboards!
More ways for users to get Twitter XP!Currently we support giving XP if a user likes or retweets one of your tweets.
- Interact Handles: Any usernames added here give you exp for interacting with their tweets. (ie. if you add @SolDecoder here - you'll earn exp for liking / RT on their tweets. You can use this if your project has two Twitters and you want users to raid both by default)
Note by default these commands may be 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! Note: it is case sensitive, so make sure to copy / paste your handle from Twitter!
Use on PC if you can't get it to work on mobile.