> 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/user-guide.md).

# User Guide

Hello! This guide will walk you through the Utility APE tools setup process. These steps will show you how to configure and setup the UA tools in your server.

## Getting Started

<mark style="color:green;">**Installing the bot**</mark><mark style="color:green;">:</mark>\
\
**1.** You've received your bot invite link - clicking this will prompt you to add the <mark style="color:purple;">UA bot</mark> to your server and the bot will join as 'Your Server Name Rewards'. You can freely change the name of the bot as needed.\
\
**2.** Create a new role that has the <mark style="color:blue;">Administrator</mark> permission and assign that role to the new bot. If you have an existing role that has this permission you can assign the bot that role instead. The bot only needs this permission to do the <mark style="color:orange;">quick-setup</mark>, so you can remove the admin role after that is completed if you need to.

<figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FjCCcDs9NQqtxGKFXCs7M%2FRewards%20Bot%20Admin%20permission.PNG?alt=media&amp;token=da6a19f2-775f-4ddb-ba18-e6337fcb3f00" alt=""><figcaption><p>Create a role with the Administrator Permission enabled for your bot to run the .quick-setup command. Ensure you Save Changes at the bottom after editing permissions.</p></figcaption></figure>

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FEZIlFv3oAMmOrH43m3qu%2Frewards%20bot%20role%20assign.PNG?alt=media&amp;token=db3a6353-60ab-471a-8fe2-50b17ad59dae" alt=""><figcaption><p>Assign your new admin role to the Rewards bot.</p></figcaption></figure></div>

\
\
**3.** Time to run the `.quick-setup` command which will prompt you with a <mark style="color:green;">YES</mark> or <mark style="color:red;">NO</mark> questions to initiate automated channel creation. We highly recommend you press <mark style="color:green;">YES</mark> and allow the bot to setup the default channels for you.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2Fhl75uvdmkm9ZflaWpHkp%2Fquick%20setup%20yes.PNG?alt=media&amp;token=24a27b6e-3d33-4990-ba16-0eab3493ff94" alt=""><figcaption><p>Run the .quick-setup and type yes to confirm.</p></figcaption></figure></div>

<figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2Fq4CPUB18rJxWyiXtVD20%2Fquick%20setup%20details.PNG?alt=media&amp;token=06c8d680-6a33-4950-9a32-d515f8494ed9" alt=""><figcaption><p>Now all the channels are created!</p></figcaption></figure>

\
\
**4.** With the <mark style="color:orange;">quick-setup</mark> completed you can move on to setting up the [permissions ](/ua-engagement-bot/engagement-tools-setup/permissions.md)for those channels created and move any admin channels to your own admin category.

<div align="left"><figure><img src="https://45384882-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzP6DlWzbPBZHhSwoPx3%2Fuploads%2FuIc2Gy3qYfnNFkjpOwMb%2Fquick%20setup%20channels.PNG?alt=media&amp;token=7c166be6-4ff5-409c-808c-7aa47f667c44" alt=""><figcaption></figcaption></figure></div>

<br>
