# Getting Started

{% hint style="info" %}
If you are having any issues setting up features have a read through [FAQ.](https://litochee.gitbook.io/amaribot/faq)
{% endhint %}

#### This guide will cover the basics you need to do to get started with AmariBot.

### 1. Setup Prefix

If you want the bot to respond to the prefix `?`, you can do so using `:?prefix ?`. The prefix cannot be longer than 6 characters.&#x20;

### 2. Setup Level Roles

Users can earn roles by reaching certain levels, this can be set up using the `:?rlevel` command. We can add roles using `:?rlevel add <level> <@role>`.\
\
When setting up `rlevel` rewards make sure the AmariBot role is above all the roles you are assigning:

<div align="left"><img src="https://1276242721-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLKkkQVRaJwGML-0FGz%2F-MLQ1IcMpQXHUj6nrN-h%2F-MLQ6WM8Njm4-0bXj4T7%2FRoleSetup.png?alt=media&#x26;token=ce495d36-8741-4681-ac20-f67a200d0ca5" alt=""></div>

### 3. Custom Announcements

Server admins can set up custom announcements for when users level up.  Using the `:?announce` command you can set up custom announcements for each level or set up an announcement for all levels. You can use `:?announce custom <text>` to set up the message. The following shows an example of the command to use and the output for the command , `:?announce custom CONGRATS You are now level`\
`{level}!!!`&#x20;

<div align="left"><img src="https://1276242721-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLKkkQVRaJwGML-0FGz%2F-MLyZ7zTinPH5LMiz7m6%2F-MLyZe-rHoYdEjVdwlPV%2FLevel%20up.JPG?alt=media&#x26;token=d51d0573-e8e4-4850-b1a0-9a7505bbcb6c" alt="Announcement example"></div>

Custom announcements can be also used to set up announcements for each level, this will allow you to mention the role the user earns for that level. Example of command, `:?announce level add <level>` `<text>` will allow you to set up the custom announcement for specific levels. You can also check which levels have custom announcements using `:?announce level show`

#### Announce Syntax

`{role}` (Obtained role) (`:?announce level` only) \
`{user}` (AmariBot)\
`{user.tag}` (AmariBot#5150) \
`{user.ping}` (@AmariBot)\
`{level}`(Obtained level)

### 4. Blacklisting Channels & Roles

Everyone has those spam command channels, so you can use the `:?blacklist` command to stop users from gain EXP from all the spam messages. Using `:?blacklist` you can either blacklist channels or roles. To add channels to the blacklist run `:?blacklist add #channel` and to add a role you can run `:?blacklist add @role`

### 5. Weekly Leaderboard

Weekly command can be used to track user activity over a smaller period of time, we usually set this up to give out rewards but you can use it for what ever you want. If you want to set up weekly you can use `:?weekly on` and use `:?weekly winners` to get a nice image of the top 3 winners.&#x20;

<div align="left"><img src="https://1276242721-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MLKkkQVRaJwGML-0FGz%2F-MLybwSDF1aB3BMOZnd0%2F-MLydykAHwQ4cTw-nA5b%2FLbWeekly.png?alt=media&#x26;token=0489aa28-a51d-45ef-889c-594ff3d64268" alt=""></div>

This is just a few of the features AmariBot offers, but this guide allows you to set up the cores features and from here you can [invite](https://discordapp.com/oauth2/authorize?client_id=339254240012664832\&scope=bot\&permissions=268954688) the bot and check out all the other features.
