> For the complete documentation index, see [llms.txt](https://utility-ape-docs.gitbook.io/ua-engagement-bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://utility-ape-docs.gitbook.io/ua-engagement-bot/engagement-tools-setup/raffle-system.md).

# Raffle System

Adding raffles to your server is a great way to get more of your community involved.

The Raffle System is optional but recommended. To get started type .ah and look for the <mark style="color:orange;">**Admin Raffle Commands**</mark> section where you will see:\
\
`.create-raffle` - Create a raffle \
`.delete-raffle` - Delete the added raffle \
`.raffle-channel` - Set a channel for bot to announce raffle winners \
`.raffle-ui` - Raffle UI for buying raffle tickets

1. Getting started you will want to create a 'Raffles' category with two channels in it. In this example I created the <mark style="color:green;">#🧮-buy-raffle</mark> and <mark style="color:blue;">#🥑-raffle-winners</mark> channels. Make sure you set the permissions for this category with the same default settings you used for the <mark style="color:purple;">Engage to Earn</mark> category. You <mark style="color:red;">**don't**</mark> want your community to be able to <mark style="color:red;">Send</mark> messages in these two channels, but you **want** them to have <mark style="color:green;">viewer</mark> access only.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2F4hXbLbP99rB65TkLLfaC%2Fraffle%20category%20and%20channels.PNG?alt=media&amp;token=41f1342c-adff-46cd-9ed3-3f5bc7515b27" alt=""><figcaption></figcaption></figure></div>

2\. Next step is to set the Raffle Winners channel by using the `.raffle-channel` command. This channel will be populated whenever someone wins a <mark style="color:yellow;">Raffle</mark>. You will see a message congratulating the winner. &#x20;

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FzN20pQK1pafebcfiO2SK%2Fraffle%20winners.PNG?alt=media&amp;token=ec357127-339c-4735-8d4c-ead719a0531f" alt=""><figcaption></figcaption></figure></div>

3\. Now you can assign the UI to your <mark style="color:green;">#🧮-buy-raffle</mark> channel with the `.raffle-ui` command.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FX4XcX6Q2woo3oO1WPhJ0%2Fraffle%20ui.PNG?alt=media&amp;token=4e7fb30c-f2d9-4619-bafa-2c8a5a1c1e36" alt=""><figcaption></figcaption></figure></div>

4\. Now that you've setup all your channels and done the back-end settings, it's time to create your first <mark style="color:yellow;">Raffle</mark>. Use the `.create-raffle` command to initiate the interface for creating your <mark style="color:yellow;">Raffle</mark>. Click the '<mark style="color:green;">Create Raffle</mark>' button and you'll be prompted with a new box where you can enter in your Raffle details.

<div><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FCsIIzv0OMhHFYOszvWlz%2Fcreate%20raffle%20command.PNG?alt=media&amp;token=698f538a-774a-4cb3-8050-5a5f3886b29c" alt=""><figcaption><p>After the Raffle command is sent, you need to click the 'Create Raffle' button.</p></figcaption></figure> <figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FnjAYULPeGaDUTAE5a3kg%2Fcreate%20raffle.PNG?alt=media&amp;token=a16ddfff-fa7d-4057-a343-0a935ee800cb" alt=""><figcaption><p>Upload the image of your Raffle to imgur so it's in a PNG format.</p></figcaption></figure></div>

5\. Once you press '<mark style="color:blue;">Submit</mark>' after entering in all your details for the <mark style="color:yellow;">Raffle</mark>, you will be shown the 'Raffle Successfully Created' message with the details of your <mark style="color:yellow;">Raffle</mark>.\
\
Visit the <mark style="color:green;">#🧮-buy-raffle</mark> channel or whichever channel you designated for your Raffle UI to view the '<mark style="color:red;">Currently Active Raffles</mark>', pressing that button will present a user in your server with the options to spend their currency to buy 1, 3, or 5 <mark style="color:yellow;">Raffle</mark> tickets.

<div><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FZSJfc4nTCn078hIPtVD0%2Fbuy-raffle.PNG?alt=media&amp;token=52b1cecc-e3e3-4ac7-a63f-2c4599efcaf9" alt=""><figcaption></figcaption></figure> <figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FPxDUzbT2rutQzuQwUODJ%2Fraffle%20is%20created%20confirmation.PNG?alt=media&amp;token=df90a0ca-ae12-4cf0-b86e-027a0cfd1a9b" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Important to note that only 1 Raffle can be active at a time.
{% endhint %}