> For the complete documentation index, see [llms.txt](https://xlabs.gitbook.io/zenin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xlabs.gitbook.io/zenin/bolt/super-suite-of-tools/raid-2-earn/bolt-raid-commands.md).
# BOLT⚡ Raid Commands
### General User Commands
{% tabs %}
{% tab title="/user-info" %}
***Features:***\
• Displays an overview of a user's raiding statistics\
\
***Options:***\
`user:` input Discord username and select desired user\
\
**Displayed information includes:**\
\- Twitter Profile redirect\
\- Total Likes/ Retweets/ Replies count\
\- Total Reward points\
\- Giveaways won\
\- Raider profile creation date\
\
*Note:* A raider will NOT be accumulating any reward points or receiving a chance to enter a giveaways without creating their BOLT:zap: profile and linking their Twitter account through the BOLT:zap: Dashboard.
{% endtab %}
{% tab title="/bolt-leaderboards" %}
***Features:***\
• Displays the Top 10 raiders in the project at a glance\
• Discord ID and amount of reward points are featured alongside their ranking position\
• See all raiders within the project by clicking **View Full Leaderboard** button\
\
***Options:*** \[N/A]\
\ **View Full Leaderboard****:** \
\
:warning:waiting for more info
{% endtab %}
{% endtabs %}
Permissions for General User Commands [RAID-2-EARN]
For general users you will want to set these commands listed above to have the permissions appear in the following format. General users can be limited to only holders however if your project is pre-mint, it is recommended to allow **verified members** to access these commands. When the commands above have been used by an individual, they are only visible to those that used the command.
1. Select **Server Settings**.
2. Navigate to **Integrations** under **APPS** (subsection).
3. Select **BOLT** from the list of *Bots and Apps* in the project's Discord server.
4. Add relevant **ROLES AND MEMBERS** that will be handling the **General User Commands** above.
5. Add relevant **CHANNELS** that these commands can be used in.
6. Congratulations! Your holders or members can use these commands in the appropriate channels.
### Administrator Commands
{% tabs %}
{% tab title="/engagement-rewards" %}
***Features:***\
• View current Reward Point allocations for each type of raiding action\
• Configure reward points for users per type of action completed by pressing the **Reward Points** button.\
\
***Options:*** \[N/A]\
\
**Configurable options include:**\
• Likes\
• Replies / Comments\
• Retweets
{% endtab %}
{% tab title="/create-raid" %}
***Features:***\
• Set up a raid for your holders to participate in\
• Customise details to appear in the raid message as well as the type of raid\
\
***Options:***\
`tweet:` input Tweet that you wanted your holders to raid\
`end_time:` type in a numeric value (by default, it is set to minutes) OR select 1 hour, 6 hours, 1 day, 3 days and end of day (UTC)\
`raid_type:` select between "giveaway" or "engagement tracking"\
\
*Note:* Depending on the selection of the final option `raid_type`, a pop-up will show with more entry fields after pressing **ENTER**.\
\
Creating a **Raid** as a `giveaway` will require inputs for:\
• Prize\
• Number of winners\
• Description or caption of the raid\
\
Creating a **Raid** for `engagement_tracking` will require inputs for:\
• Reward Point multiplier (Only integers, max of 3)\
• Description or caption of the raid
{% endtab %}
{% tab title="/raid-status" %}
***Features:***\
• Displays raids that are currently active with a link to the Tweets and end time\
• Review past raids by pressing the **Get Ended Tweets**** ** button\
• All concluded raids will generate a **Raid ID** number\
\
***Options:*** \[N/A]\
\
** ****Get Ended Tweets** : Select the raid ID that you wanted to retrieve data from\
\
**Displayed information includes:**\
\- Raid Start / End Time\
\- Giveaway Type\
\- Points Per Like/ Retweet/ Reply\
\- Raid Message (Redirect to Tweet)\
\- Raider Likes/ Replies
{% endtab %}
{% tab title="/raid-points" %}
***Features:***\
• Allows holders to claim reward points by interacting on specific tweets\
\
***Options:*** \
`tweet:` paste in the Tweet that holders should raid\
`end_time:` select an interval from the options that appear or type in an integer to translate it into minutes (i.e. 61 = 1 hour and 1 minute)\
`description:` type in what the raid should be called\
`multiplier:` input an integer with a maximum of 3\
\
** ****Claim Reply:** Holders can press on this **after** replying to the specified tweet.\ **Claim Like/Retweet:** Holders can press on this **after** liking and/or retweeting the specified tweet to receive reward points.\
\
**Displayed information includes:**\
**-** Points received per interaction \[ Like | Retweet | Reply ]\
**-** Raiding Tweet's URL\
**-** Ending time of the raid\
**-** Raid ID code
*Note:* Holders will be unable to claim their reward points if the Raid timer has elapsed, even if they participated in the official raid.
{% endtab %}
{% tab title="/raid-item" %}
***Features:***\
• Allows server admins to set up a giveaway prize for holders where an entry is gained for each raiding interaction.\
\
***Options:*** \
`tweet:` paste in the Tweet that holders should raid\
`end_time:` select an interval from the options that appear or type in an integer to translate it into minutes (i.e. 61 = 1 hour and 1 minute)\
`description:` type in what the raid should be called\
`multiplier:` input an integer with a maximum of 3
{% endtab %}
{% tab title="/give-user-points" %}
***Features:***\
• Allows server admins to add or remove reward points from users in the server\
\
***Options:*** \
`user:` select a holder by searching their name\
`points:` input a positive integer to give points or add a "-" before the value to subtract points \
\
***Note:*** Holders need to participate in a raid first before reward points can be added or removed.
{% endtab %}
{% tab title="/reset-leaderboard" %}
***Features:***\
• Resets the Reward Point leaderboards\
\
***Options:*** \[N/A]\
\
***Attention!*** Typing this command will reset the leaderboards instantly.
{% endtab %}
{% tab title="/raid-whitelist" %}
***Features:***\
• Allows holders to claim a giveaway entry for a whitelist spot by interacting on a specific tweet. \
\
***Options:*** \
`tweet:` paste in the Tweet that holders should raid\
`end_time:` select an interval from the options that appear or type in an integer to translate it into minutes (i.e. 61 = 1 hour and 1 minute)\
`description:` type in what the raid should be called\
`whitelist:` select the whitelist that should be distributed to holders that win the giveaway\
`number_of_winners:` input an integer to indicate the amount of whitelist spot winners\
\
** ****Claim Reply:** Holders can press on this **after** replying to the specified tweet.\ **Claim Like/Retweet:** Holders can press on this **after** liking and/or retweeting the specified tweet to receive reward points.\
\
**Displayed information** \
\- Discord invite of the server that is distributing whitelist spots\
**-** Giveaway entries received per interaction \[ Like | Retweet | Reply ]\
**-** Raiding Tweet's URL\
**-** Ending time of the raid\
**-** Raid ID code\
|\
After the raid ends, the information includes the winners of the raid by tagging them and applying their whitelist role automatically on the partnered server.
{% endtab %}
{% endtabs %}
Permissions for Administrator Commands [RAID-2-EARN]
If you're a server administrator, you will want to set these commands listed above to have the permissions appear in the following format. Collaboration managers or high-level Discord administrators should be the only users that have access to initiate these commands. The permissions should also be set-up to be used in server channels where your project finds it to be most appropriate to use these commands. For raid-related commands, these should be put in a dedicated raid channel so your holders or users can claim their entries for completing the raid tasks without losing it in a chat that moves dynamically, such as a general chat channel.
1. Select **Server Settings**.
2. Navigate to **Integrations** under **APPS** (subsection).
3. Select **BOLT** from the list of *Bots and Apps* in the project's Discord server.
4. Add relevant **ROLES AND MEMBERS** that will be handling the **Administrator Commands** above.
5. Add relevant **CHANNELS** that these commands can be used in.
6. Congratulations! You can use these Administrator Commands in the appropriate channels.
