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. After enabling, Please click the Sol Decoder bot link with additional permissions, on the bottom of the page, to update the Bot with additional permissions (circled below).

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.

Click "Manage Discord Roles".
- You can either create roles of your choosing (so enter the Role Name and XP for each role - and we recommend the max role have 30,000 XP+). You can use an existing role, but it is recommended to not use one of your existing whitelist roles, 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 to give your actual whitelist role, to everyone with the 'Claim whitelist' role
- Or leave roles empty to generate roles automatically (50 roles based on Military Ranks).
Once you've created the roles, make sure they all show up in your Discord.

Note the icons won't work unless your server is boosted to level 2. Also, make sure the roles are moved higher than other roles with icons in the Discord list, so that they will show up when people chat. People like leveling up and showing off roles!

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.

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.

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.

What to do if I encounter "You don't have enough NFT" 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.

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.