> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.lootlabs.gg/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to use the LootLabs Discord Bot ?

# LootLabs Discord Bot Documentation

The LootLabs Discord bot allows dynamic Gaming content monetization within discord!

Inviting the bot to your server is done using this link:  [Invite LootLabs Bot](https://discord.com/oauth2/authorize?client_id=1204693168738803792&permissions=10240&scope=bot)

This documentation covers the setup and usage of the LootLabs Discord Bot for dynamic gaming content monetization within Discord servers.



${youtube}[Discord Bot Demo](wR7VhOs4viM)
## Getting Started

**Basic Setup:**

Before using the LootLabs bot, an API token is required.
If you do not have one follow [ this link .](https://help.lootlabs.gg/en/article/how-do-i-get-a-lootlabs-api-key-1ccz7zy/?bust=1707745794779)
 The bot will not perform any actions until it's configured with your API token using the `/api-token` command.

**Commands Overview:**

The LootLabs bot comes with a variety of commands for server customization and management. Below is a table outlining each command, its description, and example usage.

| Command          | Description                                                                 | Example Usage                                             |
|----------------------|-----------------------------------------------------------------------------|-----------------------------------------------------------|
| `/api-token <token>` | Sets the API token for LootLabs.                                            | `/api-token token:f6857924...`                            |
| `/filter-option <option>` | Sets the link filtering option as Blacklist or Whitelist.                  | `/filter-option option:Blacklist`                         |
| `/blacklist <site>`  | Adds or removes a given site from the blacklist.                           | `/blacklist site:youtube.com`                             |
| `/whitelist <site>`  | Adds or removes a given site from the whitelist.                           | `/whitelist site:twitter.com`                             |
| `/role-permissions <role>` | Sets the role with access to certain commands.                             | `/role-permissions role:@Moderator`                       |
| `/restrict-channel <channel>` | Adds or removes a channel from the list where links are not converted.    | `/restrict-channel channel:#photos`                       |
| `/defaults <theme> <tasks> <tier> [thumbnail_url]` | Sets default settings for converting links.  Note: Thumbanil_url has a `none` option to remove it      | `/defaults theme:Space tasks:3 tier:Profit Maximization`  |
| `/settings`          | Displays the bot's current settings.                                       | `/settings`                                                |
| `/help`              | Shows command usages, descriptions, and examples.                          | `/help`                                                    |

**Channel and Role Permissions:**

The bot allows for specific channel restrictions and role-based permissions to tailor its functionality to your server's needs.

## Configuration Commands

### Setting Up Your API Token

1. **Command:** `/api-token`
2. **Description:** Links an API token to your server for the bot's functionality.
3. **Example:** `/api-token token:your_api_token_here`

### Customizing Link Conversion Settings

1. **Commands:** `/whitelist`, `/blacklist`, `/filter-option`, `/defaults`
2. **Description:** These commands allow you to manage which sites are allowed, set default conversion settings, and choose between using a whitelist or blacklist approach.
3. **Defaults:** setting up defaults for links is important, for example `/defaults theme:Classic tasks:1 tier:Profit Maximization` sets 1 classis themed task from the profit max tier for all of the future links, It is recommended to set up a Default fallback `Thumbnail_url` for your server that shows if the bot doesn't find any other thumbnail to use.

### Managing Access and Restrictions

1. **Commands:** `/role-permissions`, `/restrict-channel`
2. **Description:** Set which roles can use certain bot commands and restrict specific channels from link conversion.

## Examples of Command Usage

** Choose filter option: **
This command makes the bot choose either blacklist logic or whitelist logic 
```  /filter-option Blacklist ``` 

**Blacklist a Site:**
This command makes the bot this site and only wrap other links
```  /Blacklist example.com ``` 

**Whitelist a Site:**
This command makes the bot ignore all other sites and only wrap these links
```  /whitelist example.com ```

** Restrict Channel**
This command makes the bot not work ina  certain channel
```  /restrict-channel #general  ``` 

** Check active settings**
This commands checks the bot settings
```  /Settings  ``` 


For more detailed information on each command and additional configurations, use the `/help` command within your Discord server.