> 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-fcfs-and-giveaway-commands.md).
# BOLT⚡ FCFS & Giveaway Commands
## FCFS (`list`) Commands
{% tabs %}
{% tab title="/list-item" %}
***Features:***\
• Allows users within your community to claim a specified prize by spending a chosen amount of reward points.\
\
\&#xNAN;***Options:***\
`prize:` input the prize that will be awarded to holders after claiming\
`description:` input some information of the prize\
`number_of_winners:` input an integer to represent the total number of winners\
`price:` input an integer to represent the cost of the prize\
\
\
**Displayed information includes:**\
\- The amount of prizes left in stock\
\- The name of the prize\
\- The cost of the prize
\
Pressing  will allow users to begin the claiming process. The user must successfully complete the captcha to purchase the prize. BOLT:zap: will detect whether the user that is claiming the prize will be able to afford the prize after the captcha is completed.\
\
Participants that were able to claim the listed item in time will receive a message mentioning their Discord ID. They will also receive a custom role which includes the `prize` & **Item ID.**\
\
Project administrators are able to check the members of this role at a later date by accessing **Server Settings** > **Roles** > **Selecting Prize Role** > **Manage Members.** After the prizes have been distributed to the members, the role can be deleted.
{% endtab %}
{% tab title="/edit-listed-item" %}
***Features:***\
• Enables the ability to change the values of previously listed items with the command [#list-item](#list-item "mention").\
\
\&#xNAN;***Options:***\
`item:` select the item number of an existing item listing\
`price:` input a positive or negative number to either increase or decrease the cost of the prize's original cost\
`quantity:` input a positive or negative number to either increase or decrease the total number of the prizes available.\
\
**Displayed information includes:**\
\- Confirmation of the listed item being edited
{% endtab %}
{% tab title="/list-whitelist" %}
***Features:***\
• Allows users within your community to purchase a whitelist prize by spending the displayed amount of reward points.\
\
\&#xNAN;***Options:***\
`description:` enter a description of the whitelist\
`whitelist:` select the whitelists that are available for distribution to the project's community members\
`number_of_winners:` input an integer to represent the total number of winners\
`price:` input an integer to represent the cost of the prize\
\
**Displayed information includes:**\
\- The whitelist that is being offered for purchase via reward points\
\- Amount of whitelist spots remaining\
\- Discord invite of the server that is distributing whitelist spots\
\
After the whitelist is purchased with reward points, the winner(s) will have their whitelist role automatically applied on the partnered server.
{% endtab %}
{% tab title="/fcfs-points" %}
***Features:***\
• Allows users within your community to claim a certain amount of reward points by clicking the 
button.\
\
\&#xNAN;***Options:***\
`description:` enter a description of the point redemption\
`claim_reward:` input an integer to represent the amount of reward points that can be claimed\
`number_of_winners:` input an integer to represent the total number of winners\
\
**Displayed information includes:**\
\- The amount of reward points left to claim\
\- A description of the prize\
\- The amount of reward points that are awarded to those that press the button in time\
\
After claiming the points in this first-come-first-served format, the users that successfully claim reward points will receive a message indicating that they have claimed reward points as well as showing the total balance of reward points the community member owns.
{% endtab %}
{% endtabs %}
## Giveaway (`raffle`) commands
{% tabs %}
{% tab title="/raffle-item" %}
***Features:***\
• Allows users within your community to purchase raffle tickets to have a chance at winning a specified item.\
\
\&#xNAN;***Options:***\
`end_time:` select a time or input an integer ( calculated in minutes) for the raffle to end\
`description:` enter a description of the raffle\
`prize:` specify what your community members will be winning\
`number_of_winners:` input an integer to represent the total number of winners\
`price_per_ticket:` input an integer to represent the cost per raffle entry\
\
**Displayed information includes:**\
\- Total number of winners\
\- Ending time of the raffle\
\- Ticket Price\
\- Buttons to purchase a certain amount of raffle tickets (1, 3, 5 or 10)\
\
\&#xNAN;*Note:* Users can check their reward point balance by using the command `/`
{% endtab %}
{% tab title="/raffle-points" %}
***Features:***\
• Allows users within your community to purchase a whitelist prize by spending the displayed amount of reward points.\
\
\&#xNAN;***Options:***\
`end_time:` select a time or input an integer ( calculated in minutes) for the raffle to end\
`description:` enter a description of the raffle\
`claim_reward:` input an integer to represent the number of reward points that can be won.\
`number_of_winners:` input an integer to represent the total number of winners\
\
**Displayed information includes:**\
\- Total number of winners\
\- Ending time of the raffle\
\- A confetti emoji () that community members can react to for an entry\
\
Once the giveaway is over, the winners will be tagged in the message with the number of reward points that they have earned.
{% endtab %}
{% tab title="/raffle-whitelist" %}
***Features:***\
• Displays an overview of a user's raiding statistics\
\
\&#xNAN;***Options:***\
`end_time:` select a time or input an integer ( calculated in minutes) for the raffle to end\
`description:` input Discord username and select desired user\
`whitelist:` input Discord username and select desired user \
`number_of_winners:` input an integer to represent the total number of winners\
`price_per_ticket:` input an integer to represent the amount of reward point it costs to purchase a single raffle ticket\
\
\&#xNAN;*Note:* If the `price_per_winner` is left blank, it will show a confetti emoji () where holders can react for a single raffle entry at no reward point cost.\
\
**Displayed information includes:**\
\- Total number of winners\
\- Total number of whitelist spots being offered\
\- Ending time of the raffle\
\- Buttons to purchase a certain amount of raffle tickets (1, 3, 5 or 10)
{% endtab %}
{% endtabs %}
Permissions for Administrator Commands [FCFS & Giveaway]
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 members should be the only users that have access to initate these commands. The permissions should also be set-up to be used in server channels where your project finds to be appropriate to use these commands. For giveaway or First-Come-First-Served (FCFS) related commands, these should be set-up in a dedicated raid channel so your holders or users can claim their entries for purchasing raffle entries or entering engagement initiatives.
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 now use these Administrator Commands in the appropriate channels.
