# Eventcord Bot

{% hint style="warning" %}
Eventcord now only uses slash commands. [Slash Commands](/using-the-bot/slash-commands)
{% endhint %}

{% hint style="info" %}
Need help getting started? Check out the [getting started](/using-the-bot/getting-started) documentation.
{% endhint %}

Multi-language support is available, but these docs are not yet translated. See [Languages](/languages).

{% hint style="info" %}
By default, Eventcord uses **English**
{% endhint %}

## Using These Docs

Here is how the formatting works on these docs:

| Formatting  | Description of Use                                |
| ----------- | ------------------------------------------------- |
| Code Block  | Indicates command used in chat                    |
| \<argument> | Indicates a placeholder for a required argument.  |
| \[argument] | Indicates a placeholder for an optional argument. |
| @user       | Indicates a placeholder for a mentioned user      |

**Vote for Eventcord:**

{% content-ref url="/pages/-LPj-r29CHUrw4WEIBJc" %}
[Broken mention](broken://pages/-LPj-r29CHUrw4WEIBJc)
{% endcontent-ref %}


# FAQ

Answers to basic questions about the bot.

## Does this bot play music?

This bot does not play music. Eventcord manages the queue for karaoke and can automatically mute and unmute users to ensure a clear voice channel while someone is preforming. However, if you do want to play music during karaoke, Eventcord can work in conjunction with other bots, such as [Rythm](https://rythmbot.co/), to play music. Eventcord will not mute bots in the voice channel.

## What is up with this Event Admin role?

See [troubleshooting ](/using-the-bot/troubleshooting#when-i-try-to-start-a-session-i-am-told-i-need-the-queue-admin-role)for more detail.

## Does Eventcord support slash commands?

Yes!  Visit the page below for more information.

{% content-ref url="/pages/-MgsXe-y3V6u8hcdnuSZ" %}
[Slash Commands](/using-the-bot/slash-commands)
{% endcontent-ref %}

## Can I change an event's message?

You can set your own event message by typing your message after the start command. Here is an example: /`start message:Join to have some fun!`

{% hint style="info" %}
Your event message can be up to 280 characters.
{% endhint %}

## How can I invite Eventcord to my server?

Visit [eventcord.xyz/invite](https://eventcord.xyz/invite) to invite Eventcord to your server!

{% content-ref url="/pages/-LTl7pud\_J\_2DBC9Zhqa" %}
[Broken mention](broken://pages/-LTl7pud_J_2DBC9Zhqa)
{% endcontent-ref %}

## Where can I find a list of commands?

You can find a list of commands here:

{% content-ref url="/pages/-LPPtdkEz\_TCUBXINEy9" %}
[Command List](/command-list)
{% endcontent-ref %}

## Where can I get support or report bugs?

Our Discord server provides quick, reliable support. Join the server [here](https://go.kariari.xyz/discord). Just join, ask a question, wait for a response.

{% content-ref url="/pages/-LQRGscuBGoXGgebOkpl" %}
[Broken mention](broken://pages/-LQRGscuBGoXGgebOkpl)
{% endcontent-ref %}

## What languages are supported?

Click the link below to see the available languages:&#x20;

{% content-ref url="/pages/-LTQrU6f9mUruwrx0ylz" %}
[Languages](/languages)
{% endcontent-ref %}

To change your guild or user language, see [configuration](/using-the-bot/configuration).

## Why does Eventcord require the permissions listed?

What do these mean and why does Eventcord want them? You can find out below!

| Permission           | Description                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------- |
| Read Messages        | Needed for Eventcord to see your commands!                                                          |
| Send Messages        | Needed for Eventcord to respond to your commands!                                                   |
| Embed Links          | Most responses Eventcord sends are in the form of embeds, which requires this permission to show up |
| Attach Files         | To show pictures in messages!                                                                       |
| Read Message History | So some commands such as setup are streamlined!                                                     |
| Add Reactions        | So Eventcord can wait for reactions                                                                 |
| Mute Members         | Required for our automatic muting in karaoke to work!                                               |
| Use External Emojis  | Eventcord wants to send visually pleasing messages 😊                                               |

{% hint style="info" %}
In the last step of the setup command, the bot will check for the permissions listed above (see [assisted setup](/using-the-bot/getting-started#assisted-setup))
{% endhint %}

Have questions about these permissions? Ask in our [Discord server.](https://go.eventcord.xyz/discord)


# Command List

List of commands

{% hint style="warning" %}
Eventcord now only uses slash commands. [Slash Commands](/using-the-bot/slash-commands)
{% endhint %}

## Slash Commands

With slash commands, inputs will appear as options after typing in the main command. Placeholders represent these options.

## Placeholders

| Placeholder  | What it does                         |
| ------------ | ------------------------------------ |
| `<argument>` | Placeholder for a required argument  |
| `[argument]` | Placeholder for an optional argument |

## Config Commands

| **Command**             | **Description**                                                                            | **Example**    |
| ----------------------- | ------------------------------------------------------------------------------------------ | -------------- |
| /config \<server, user> | Allows you to configure the bot as you please (see [config](/using-the-bot/configuration)) | /config server |
| /setup                  | Get the bot up and running!                                                                |                |

## Event Commands

| **Command**      | **Description**                                                           | **Example**    |
| ---------------- | ------------------------------------------------------------------------- | -------------- |
| /positions       | Shows the current positions for an event                                  |                |
| /join \[@friend] | Adds you to the event. You can mention your friend to group up with them. | /join @danclay |
| /leave           | Removes you from the event                                                |                |
| /cycle           | Cycles the event                                                          |                |
| /events          | Lists all events on this server                                           |                |
| /votekick        | Start a vote to kick members from the event.                              |                |

## Event Management Commands

| **Command**                                                                               | **Description**                                                                                        | **Example**                         |
| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------- |
| /start \[optional event message] \[optional mentioned text channel to start the event in] | Starts an event                                                                                        | /start Hello everyone! #events-chat |
| /end                                                                                      | Ends an event                                                                                          |                                     |
| /lock                                                                                     | Locks or unlocks the event                                                                             |                                     |
| /push <@member> \<position> \[new]                                                        | Push a member into an event position. Type "new" at the end as a shortcut to push into a new position. | /push @danclay 3                    |
| /remove <@user>                                                                           | Removes a member from the event                                                                        | /remove @danclay                    |
| /autocycle \<time between cycles (e.g. 1m 30s) or disable>                                | Automatically cycle the event based on time.                                                           | /autocycle 5m                       |
| /groupsize \<max group size>                                                              | Set the maximum size for groups in the event.                                                          | /groupsize 1                        |
| /oneround                                                                                 | *(Demo command)* Automatically removes members after the event is cycled                               |                                     |

## Info Commands

| **Command**        | **Description**                            | **Example**        |
| ------------------ | ------------------------------------------ | ------------------ |
| /help              | Shows the commands for the bot             |                    |
| /about             | About the bot and provides the invite link |                    |
| /ping              | Returns the bot's ping                     |                    |
| /shards            | Shows the status of the shards             |                    |
| /stats             | The bot's statistics                       |                    |
| /userinfo \[@user] | Shows information about a user             | /userinfo @danclay |
| /serverinfo        | Shows information about the server         |                    |
| /upvote            | Tells you how to upvote the bot            |                    |

## Karaoke Commands

| **Command** | **Description**                                     | **Example** |
| ----------- | --------------------------------------------------- | ----------- |
| /ready      | Mutes users in the voice channel for karaoke events |             |

## Leveling Commands

| **Command**         | **Description**                                                                  | **Example**     |
| ------------------- | -------------------------------------------------------------------------------- | --------------- |
| /profile \[@member] | View your server profile                                                         | /profile @gamer |
| /xp                 | Manage XP of the members on the server (see [leveling](/using-the-bot/leveling)) |                 |

## Other Commands

| **Command**               | **Description**                                                                |
| ------------------------- | ------------------------------------------------------------------------------ |
| /weeb                     | Shows a random image from weeb accounts on Twitter                             |
| /stars \[star key]        | View the Eventcord premium level of the server or manage your Eventcord stars. |
| /uwuify \<text to uwuify> | Uwuifys the provided text.                                                     |

{% hint style="info" %}
**Note about the boot command:** You can only redeem keys in the bot's DMs
{% endhint %}


# Languages

The languages Eventcord supports

You can see which languages Eventcord supports by using **/config server locale** or **/config user locale**. To set your guild or user language, see [Configuration](/using-the-bot/configuration).

## Contributing

You can help translate Eventcord more easily than ever! Visit [this form](https://go.eventcord.xyz/langform) to help out.

{% hint style="info" %}
You **must** be in the Evencord support server to contribute
{% endhint %}


# Getting Started

How to get started using Eventcord

## Let's get started!

For karaoke to work, it requires you create a role you can assign to users you trust to run karaoke on your server. This role is referred to as the *master role*.&#x20;

### Inviting Eventcord to your server

To invite Eventcord to your server, go to [eventcord.xyz/invite](https://eventcord.xyz/invite). Confused on any permissions Eventcord is asking for? Check out [permissions](/faq#why-does-kariari-require-the-permissions-listed) on the [FAQ](/faq). For the bot to work optimally and to future proof your server, please provide it with all of those permissions.

## Before we get started

If you intend on using karaoke, please ensure to following to avoid members being left with server mutes outside of events:

### Checking Permissions

Make sure Eventcord has the **Mute Members** permission in all voice channels. This may not be the case if you have fancy role hierarchies. Use **/setup** or visit the dashboard to have the bot list out the channels it does not have the **Mute Members** permission.

## Assisted Setup

Eventcord features a setup wizard via command. Use **/setup.**

## **Manual Setup**

If you would prefer to manually set up the bot, check out [this page](/using-the-bot/configuration) on our documentation. Manual setup will still automatically check if you have configured the bot correctly.


# Configuration

Manual configuration for bot

Eventcord can be customized for your server.

## Server Configuration

### Dashboard

The easiest way to configure your server is via the dashboard. Visit the dashboard's config page to configure your server.

{% content-ref url="/pages/-MUcDLoG5s1XX\_\_2Gth8" %}
[Broken mention](broken://pages/-MUcDLoG5s1XX__2Gth8)
{% endcontent-ref %}

{% hint style="info" %}
Server configuration requires that you have the **Manage Server** permission
{% endhint %}

### Change Server Prefix

{% hint style="warning" %}
Calling the bot via prefix is no longer supported. Use slash commands. [Slash Commands](/using-the-bot/slash-commands)
{% endhint %}

### Change Server Locale

The server locale can be changed using the following command:

| **Command**           | **Function**               | **Requires you have** |
| --------------------- | -------------------------- | --------------------- |
| /config server locale | Changes the guild language | Manage Server         |

{% hint style="info" %}
The guild language is only used on **guild based commands**. This includes [queue](/using-the-bot/events) commands, but doesn't include user based commands like ;help or ;userinfo.
{% endhint %}

### Change Role

You can set a custom queue admin role using the following command:

| **Command**                          | **Function**                 | **Requires you have** |
| ------------------------------------ | ---------------------------- | --------------------- |
| /config server role \<new role name> | Changes the queue admin role | Manage Server         |

### Event Settings

Use this to change the settings for events on your server.

#### Mute Event Admins

You can toggle whether members with the event admin role will be muted during karaoke when the ready command is used. This can be done using **/config server events mute\_event\_admins**

### Disable Commands

You can remove commands from user view using **/config server disabled\_commands**. For instance, if you do not want NSFW commands to show up, disable them to hide them.

### Change NSFW Tolerance

As a server manager, you can customize the NSFW tolerance in your server (within reason).&#x20;

#### Change the Minimum NSFW Level

If you don't want to see SFW content when using commands that contain NSFW content, you can customize the minimum NSFW level by using **/config server nsfw min \<value between 0 (least NSFW) and 1 (most NSFW)>**.&#x20;

#### Change the Maximum NSFW Level

If you want to adjust the upper limit of NSFW content on your server, use **/config server nsfw max \<value between 0 (least NSFW) and 1 (most NSFW)>**.

#### Reporting Concerns with NSFW Content

If you notice weird content or inaccurate NSFW ratings, report it on our support server in the #human-help channel. Be sure to include the content's ID (this is in the footer of the embed when content is shown).

{% content-ref url="/pages/-LQRGscuBGoXGgebOkpl" %}
[Broken mention](broken://pages/-LQRGscuBGoXGgebOkpl)
{% endcontent-ref %}

### Enable/Disable Vote Kick

You can toggle whether vote kick is enabled using **/config server events votekick**.

### Reset Custom Guild Configuration

Use **/config server reset** to **COMPLETELY RESET** the configurations you have set.

## User Configuration

Users can change their own settings that are universal between servers, and are attached to your user. All user configuration commands start with **/config user**. User configuration can only be set using this, and not setup command.

### Change User Locale

To change what language Eventcord uses to interact with you, use the following command:

| **Command**                        | **Function**            | **Example**                                                                                   |
| ---------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------- |
| /config user locale \<locale code> | Changes the user locale | If I wanted to change my user language to English US, I would use /config user locale EN\_US. |

{% hint style="info" %}
The user language is only used on **user based commands**. This includes commands like userinfo and help, but does not include commands such as [queue commands](/using-the-bot/events).
{% endhint %}

### Tips

Tips are messages sent occasionally when using a command with useful information about the command used. Each tip will only be shown to you once every few weeks. To toggle whether tips are disabled, use **/config user tips**

### Reset Custom User Configuration

Use **/config user reset** to **COMPLETELY RESET** the configurations you have set.


# Events

Describes how to use Eventcord's event commands for various events, such as karaoke

## Prerequisites

To use events, you must have an understanding of the event admin role. See [Changing Role](/using-the-bot/configuration#change-role) for more help.

### What are Event Admin Roles?

The event admin role is the role you give to people who you trust to run your events. Eventcord checks the role using the role name. event admin roles do **NOT** identify who can join the event, only the people who start, stop, or manage the event.

## Event Types

There are currently two types of events: karaoke and general. They are described below.

{% tabs %}
{% tab title="Karaoke" %}
Karaoke events work in regular voice channels and stage channels. In stage channels, the bot will invite members to speak and remove them as needed. In voice channels, the bot will mute everyone who is not singing and unmute them when the singer is done.

{% hint style="info" %}
The bot requires the **mute members** permission for karaoke events to work as intended
{% endhint %}
{% endtab %}

{% tab title="General" %}
General events are for events on your server that require a basic queue. Utilizing the same code as the karaoke queue, but with the removal of the voice channel aspect. Some uses are gaming events that have a specific list of players (may include a bracket system in the future), but you can use it for almost anything!
{% endtab %}
{% endtabs %}

## Event Scopes

Events work on a text channel basis. Each event requires a text channel not being used by another event. Karaoke events require a voice channel not being used by another event in addition to the text channel.

## Groups

People can group up into groups of up to 4 within an event. This allows for squads, or duets/trios in karaoke

### Max Group Size

The maximum group size for an event can be set using **/groupsize** followed by a value between 1 and 4.

| **Command**                  | **Function**                        | **Event Admin Role Needed?** |
| ---------------------------- | ----------------------------------- | ---------------------------- |
| /groupsize \<max group size> | Set the max group size for an event | Yes                          |

## Starting and Ending Events

Events are started and ended to manage when people can add themselves to the event. These commands can only be used by people with the [event admin role.](/using-the-bot/events#what-are-event-admin-roles)

### Starting Events

To start an event, simply use **/start** in the text channel you want to start an event in. You can set a custom event message by typing your message after the command (e.g. **/start Hello guys!**). You can mention a channel to start an event in another text channel (e.g. **/start #events-zone**).

### Ending Events

To end an event, simply use **/end** in the text channel which is being used by an active event. You can mention a channel to end an event in another text channel (e.g. **/end #events-zone**).

{% hint style="info" %}
The event admin role can be changed at anytime (see[ changing roles](/using-the-bot/configuration#change-role))
{% endhint %}

## Joining and Leaving the Event

### Joining Events

To join an event, use **/join** in a text channel being used by an event. To join a friend in a group, you can mention them while using the join command (e.g. **/join @danclay**).

### Leaving Events

To leave an event, use **/leave**. If you are in a group, this will only take you out of the event, not your friends.

## Viewing the Event Positions

To view the queue, use **/positions**.

| **Command** | **Function**                    | **Event Admin Role Needed?** |
| ----------- | ------------------------------- | ---------------------------- |
| /positions  | Shows you the event's positions | No                           |

## Cycling The Event

The person who is currently up can cycle the event using **/cycle**. In karaoke events, this will also unmute all members who were muted. People with the event admin role can always use this command to skip the person who is currently up.

| **Command** | **Function**                      | **Event Admin Role Needed?**                          |
| ----------- | --------------------------------- | ----------------------------------------------------- |
| /cycle      | Cycles the event one step forward | No, but Event Admins can use this command at anytime. |

### Auto Cycle

Eventcord can automatically cycle your event with a simple command. This is useful if you want to set a time limit on how long a member can be in event position 0.

| **Command**                                                | **Function**                  | **Event Admin Role Needed?** |
| ---------------------------------------------------------- | ----------------------------- | ---------------------------- |
| /autocycle \<time between cycles (e.g. 1m 30s) or disable> | Automatically cycle the event | Yes                          |

## Managing the Event

People with the event admin role can manage the queues effortlessly using simple commands.

{% hint style="info" %}
Some event management functions are available via the [bot dashboard](https://d.eventcord.xyz)
{% endhint %}

| **Command**                           | **Function**                                                                                                                                                            | **Example**                                                                                                                                     | **Event Admin Role Needed?** |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| /push <@user>\<queue position> \[new] | Pushes the mentioned member  to the queue spot placed in the placeholder.                                                                                               | If I wanted to move @danclay to queue spot 2, I would use **/push @danclay 2** Type "new" at the end as a shortcut to push into a new position. | Yes                          |
| /remove <@user>                       | Removes the mentioned member from the queue                                                                                                                             | If I wanted to remove @danclay from the queue, I would use **/remove @danclay**                                                                 | Yes                          |
| /cycle                                | Cycles the queue                                                                                                                                                        |                                                                                                                                                 | Yes (unless you are up)      |
| /lock                                 | Lock and unlocks the queue                                                                                                                                              |                                                                                                                                                 | Yes                          |
| /autocycle \<time or event position>  | Automatically cycles the event on the interval specified unless the event is cycled manually. This is useful to set time limits or cycle if the event becomes inactive. | ;autocycle 1m 30s                                                                                                                               | Yes                          |
| /groupsize \<max group size>          | Set the maximum size of groups for this event. This defaults to 4.                                                                                                      | ;groupsize 1                                                                                                                                    | Yes                          |
| /oneround                             | *(Demo command)* Automatically removes members after the event is cycled                                                                                                |                                                                                                                                                 | Yes                          |

## Vote Kick

Anyone in an event may start a vote to kick other members from the event. The members will only be kicked if a certain threshold of votes is met. This command is meant to help the event to self moderate.

### Starting a Vote Kick

You can either start a vote kick for kicking a list of members or a certain event position.

{% tabs %}
{% tab title="Kick specific members" %}
Use **/votekick** followed by mentions of the member you wish to start a vote to kick.
{% endtab %}

{% tab title="Kick everyone from an event position" %}
Use **`/votekick`** followed by the number of the position you wish to kick.

**Examples**

* /votekick 1
* /votekick 0
  {% endtab %}
  {% endtabs %}

### Disabling Vote Kick

If members of your server are abusing the vote kick feature, you can disable it using **/config server votekick**

## Karaoke Events

Karaoke queues have special features and commands that cannot be used during event queues.

### Using Stage Channels

If you have a very large server, stage channels may be easier to use when running events on the server. Stage channels work very similarly to regular events except the bot invites users who are ready to sing and removed them when they indicate they are done. It is suggested you make your event admin role the stage moderator role in the stage channel so they can manage the event and speak in the stage channel. Read more about stage channels on the [official Discord helpdesk](https://support.discord.com/hc/en-us/articles/1500005513722-Stage-Channels-FAQ)

{% embed url="<https://eventcord.xyz/i/aGvWBt.mp4>" %}
Video showing the creation of a stage channel
{% endembed %}

### Auto Mute

Auto mute will automatically mute users who are not singing in the channel designated upon the starting of the session. To mute the users, the person who is up can use **/ready**. It may take a little bit of time for Eventcord to mute everyone in the channel if the channel has a large number of people. Users will be unmuted upon the **/cycle** command being used. Eventcord will also manage muting of people who join or leave the channel while someone is singing.

| **Command** | **Function**                                                                                 | **Event Admin Role Needed?**                          |
| ----------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| /ready      | Mutes users in the channel who are not up to sing                                            | No                                                    |
| /cycle      | Unmutes users in the channel and [cycles the queue](/using-the-bot/events#cycling-the-queue) | No, but Queue Admins can use this command at anytime. |

Eventcord also manages the muting of people who join or leave the channel. Here is what Eventcord will do:

{% tabs %}
{% tab title="Join Voice Channel" %}
Eventcord will mute the user who joins the voice channel while someone is singing.
{% endtab %}

{% tab title="Change Voice Channel" %}
Eventcord will unmute people who change voice channels if it has permission.&#x20;
{% endtab %}

{% tab title="Disconnect from Voice" %}
Kariari cannot unmute people at the moment to disconnect directly from the channel. To get around this, Eventcord will keep note of who is put into this situation and will unmute them once they join **ANY** voice channel on your guild where Eventcord has permission to unmute.
{% endtab %}
{% endtabs %}

Eventcord will also respect server mutes made by staff, and will not remove them. Eventcord will keep tabs of who was server muted before muting people. Upon unmuting, these people will not be unmuted, and will stay muted until staff unmutes them.

{% hint style="warning" %}
Auto mute requires the **Mute Members** permission (see [permissions](/faq#why-does-kariari-require-the-permissions-listed))
{% endhint %}


# Leveling

## Prerequisites

In order to use leveling, make sure the bot has the **manage roles** permission.

## What is Leveling?

The leveling module of Eventcord allows your members to earn XP and rank up based on how they interact with the server. How much they earn and what activities they earn from are highly customizable. Leveling currently uses various factors (see [below](/using-the-bot/leveling#xp-factors)) to reward active and meaningful participation in a server.&#x20;

### XP Factors

Eventcord uses different interactions with the server and rewards XP. Each of the factors listed below are rate limited to prevent spam and abuse of the system.

{% tabs %}
{% tab title="Messages" %}
Members can earn XP for actively messaging in a server. XP will be rewarded for each minute a message is sent (similar to MEE6).
{% endtab %}

{% tab title="Replies" %}
Members can receive XP when their messages are replied to. Members who send a reply will receive message XP.
{% endtab %}

{% tab title="Reactions" %}
Members can receive XP for earning reactions. This is similar to upvotes on Reddit.
{% endtab %}

{% tab title="Voice Channels" %}
Members can receive XP for every minute they spend in a voice channel. It is recommended that you set an AFK channel through Discord to prevent abuse. If you have an AFK channel, you should add it to the voice channel blacklist on the dashboard.
{% endtab %}

{% tab title="Given XP" %}
Members can receive XP from server managers using the **xp** command.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
If you notice the leveling system acting strange, a way to abuse the system, or have any suggestions; join the support server.
{% endhint %}

### How Levels are Calculated from XP

You can view XP to level conversions using this tool: <https://go.eventcord.xyz/calculate-level>. For the base equation, see below.

{% embed url="<https://go.eventcord.xyz/calculate-level>" %}

#### Equation

Levels are calculated using a leveling constant for each server, which we'll label the variable *k*. This is used in the simple equation below, which is rounded down to the nearest whole number. This gives the level based on *x* xp.

$$
L(x) = (k/10) \* \sqrt{x}
$$

{% hint style="info" %}
Currently the leveling constant cannot be configured manually by server. It is set at 1 by default on all servers. A future update may allow for manual configuration of this.
{% endhint %}

## Using Leveling

### Enabling the Module

Leveling is an addon to Eventcord's base functionality. Visit the [dashboard](https://d.eventcord.xyz), select your server, click leveling in the menu, and click the switch to enable the module. Only members with the **manage server** permission can enable/disable this module.

### Customization

Customization of the leveling module requires the **manage server** permission.

#### Factors

Each of the [factors ](/using-the-bot/leveling#xp-factors)can be either disabled or given a new XP value per interaction by the member.

#### Level Up Notifications

Level up notifications can either be sent in a specific channel on your server or in direct messages.

#### Reward Roles

Reward roles can be assigned when a member reaches a certain level. [Troubleshoot issues with reward roles.](https://docs.eventcord.xyz/using-the-bot/troubleshooting#the-bot-wont-assign-leveling-rewards)

{% hint style="info" %}
Currently, only a certain number of reward roles can be created. If you need more please ask for more information on the support server
{% endhint %}

### Manage XP

You may use the **/xp** command to manage XP for members. You must have the **manage server** permission to use this command. You may also delete members from the leaderboard or reset the whole server's XP using the leaderboard if signed in with the manage server permission.

### Member Profiles

You can check your profile using **/profile** and someone else's by using the command followed by mentioning the other member (**/profile @friend**). The profile shows the progress you have to the next level, your rank, level, and bot badges.

#### Customizing Your Profile

Currently, only chosen users can customize their profile backgrounds. This is not available publicly.

#### Bot Badges

You can receive badges on your Eventcord profile by meeting certain requirements. Currently, badges are not customizable.

{% tabs %}
{% tab title="Medal" %}
![Medal badge](https://eventcord.xyz/i/aMq4vk.svg)

This badge is rewarded when you are rank 1 on the server
{% endtab %}

{% tab title="Crown" %}
![Crown badge](https://eventcord.xyz/i/OxaAKf.svg)

This badge is rewarded to the owner of the server
{% endtab %}

{% tab title="Booster" %}
![Boost badge](https://eventcord.xyz/i/Nvw1Of.png)

Rewarded to those who provided a Nitro Server Boost to the server
{% endtab %}
{% endtabs %}

### Leaderboard

You can find your server's leaderboard using the **/leaderboard** command. Members can have the same rank as other members if they have the exact same amount of XP.

{% hint style="info" %}
Members who have been kicked or have left the server will be hidden from the leaderboard. When they return, XP data will be retained unless the server XP has been reset or the bot was kicked.
{% endhint %}

{% hint style="info" %}
Currently, leaderboards are not public and require you to log in to the dashboard and be a member of the selected server
{% endhint %}

###


# Troubleshooting

Solutions to common problems

This page contains solutions to common issues. If this page doesn't help you, [join our Discord server to report an issue or to ask for help.](https://go.eventcord.xyz/discord)

{% hint style="danger" %}
Starting at the end of August 2022, Discord will only allow bot commands to be called by slash commands. [Slash Commands](/using-the-bot/slash-commands)
{% endhint %}

## Eventcord won't respond to my commands!

To respond to commands, Eventcord requires the following permissions in the channel you are sending the commands:

* Read messages
* Send messages
* Use embeds

Without these three permissions, Eventcord can't respond to you at all. Eventcord also has other recommended permissions which can be seen in the [FAQ](/faq#why-does-eventcord-require-the-permissions-listed). Additionally, Eventcord does not support threads currently. Use a text channel or a voice chat for commands.

## When I try to start a session, I am told I need the "Event Admin" role.

![](/files/-MYTBNxVw4upKNa83QVq)

Eventcord uses a role to figure out who has permission to start, stop, or manage a queue. Eventcord checks whether a member has the role based on the name of the role. By default, the role Eventcord looks for is a role named "Event Admin" (case sensitive). You can customize the role which Eventcord looks for by using the **/setup** command or by using the **/config** command (see [changing roles](/using-the-bot/configuration#change-role)). If you need help creating roles, check out [this Discord article](https://support.discordapp.com/hc/en-us/articles/206029707-How-do-I-set-up-Permissions-). If you need help managing roles, check out [Role Management 101](https://support.discordapp.com/hc/en-us/articles/214836687-Role-Management-101). For help getting started with Eventcord or customizing Eventcord, check out these pages:

{% content-ref url="/pages/-LPiqG59tCKVE\_MAY6K6" %}
[Getting Started](/using-the-bot/getting-started)
{% endcontent-ref %}

{% content-ref url="/pages/-LPPto6D-5Q3hv77G6jy" %}
[Configuration](/using-the-bot/configuration)
{% endcontent-ref %}

## The bot won't assign leveling rewards

This is likely due to a permissions issue. First, make sure the bot has the **manage roles** permission. Then, make sure the bot's role is listed above the reward roles in your server's role hierarchy.

{% embed url="<https://eventcord.xyz/i/hyyh82.mp4>" %}
Video showing how to fix role hierarchy issues. The bot's role is being placed above the reward roles.
{% endembed %}

## I am told I am being rate limited

![](/files/-MYTBGpJ1LUvCkFxdDOU)

Wait a few seconds. If you continue to receive this error for seemingly no reason, join our [Discord server for help.](https://go.eventcord.xyz/discord)

## The bot isn't doing anything!

Be sure to check you are using the correct prefix. If you are, there is always the possibility that Eventcord or a service Eventcord uses has experienced a fatal error. If the bot doesn't come back online within a few minutes, [please report the issue on our Discord server](https://go.eventcord.xyz/discord).![Discord Bots](https://top.gg/api/widget/status/480889253165793290.svg)

{% content-ref url="/pages/-MSq7dSHADZT1FdNmdJU" %}
[Broken mention](broken://pages/-MSq7dSHADZT1FdNmdJU)
{% endcontent-ref %}

{% hint style="info" %}
If you couldn't find what you are looking for, you can get help on [our Discord server](https://go.kariari.xyz/discord).
{% endhint %}

## The bot keeps leaving my server.

Your server may have been blacklisted for Eventcord's safety. [Please join the support server](https://go.eventcord.xyz/discord) for help with this.


# Slash Commands

{% hint style="danger" %}
Starting at the end of August 2022, Discord will only allow bot commands to be called by slash commands.
{% endhint %}

## What are Slash Commands?

Slash commands are a new way to interact with bots on Discord. Simply type "/" in your text box to view available commands.

{% embed url="<https://www.youtube.com/watch?v=4XxcpBxSCiU>" %}
Discord Slash Command promo video
{% endembed %}

## How do I enable Slash Commands for Eventcord on my server?

When the Slash Command update for Eventcord was published, the bot attempted to generate commands for every server. Eventcord uses guild-based slash command instead of global commands to allow for localization. If you do not see any slash commands, try using **<@480889253165793290>setup slash**. If you receive an error, try reauthorizing the bot by using the invite link.

## Slash Commands are not responding

Eventcord started using slash commands before Discord created a multi-lingual feature for them. As such, Eventcord uses server slash command which only work for your server in your specified language. There may be a disagreement between the generated slash commands and what Eventcord accepts due to this. Use **<@480889253165793290>setup slash** to regenerate commands for your server.

{% content-ref url="/pages/-LTl7pud\_J\_2DBC9Zhqa" %}
[Broken mention](broken://pages/-LTl7pud_J_2DBC9Zhqa)
{% endcontent-ref %}


# Kariari Becomes Eventcord

## What is happening?

Kariari is being renamed as Eventcord (unofficially officially). No functionality will change.

## The bot is still named "Kariari" on Discord

Since this bot is verified, the username on Discord cannot currently be changed. Hopefully this will change in the future, but for now the name change is unofficial and official at the same time.

## Why?

Kariari was not descriptive of the bot's purpose and had a "weeby" (if I may) connotation, which may have distanced some users. Eventcord encompasses the bot's purpose in a simple manner.

## What will happen to the site?

All official Eventcord websites use [eventcord.xyz](https://eventcord.xyz). **Only use** [**eventcord.xyz**](https://eventcord.xyz)**.** Any other sites claiming to be Eventcord or Kariari are phishing.


# Changelog

Releases that impact the end user

## Kariari is now Eventcord

Kariari's name is now Eventcord! All the bot's functions are the same, just under a new name. In addition, all domain traffic has been changed to [eventcord.xyz](https://eventcord.xyz).

{% content-ref url="/pages/-MHaE0K1qNmgc5uIUuGE" %}
[Kariari Becomes Eventcord](/bot-info/kariari-becomes-eventcord)
{% endcontent-ref %}

## 3.5.4 - Jan 5, 2023

* Added support for voice text channels
* Fixed lyrics command not showing all pages

## 3.5.3 - Jan 1, 2023

* All commands are now slash commands
* Added new /setup command

## 3.5 - Aug 11, 2021

* Added Slash Command support
* Replaced reactions with buttons and dropdowns

## 3.4 - May 29, 2021

* Karaoke events now work with stage channels
* Members can now earn XP for each minute they spend in a voice channel

## 3.3 - April 16, 2021

* New leveling system ([docs page](/using-the-bot/leveling))
* Can limit the group size of events
* Fixed issue with members being stuck as muted if an error occurs during muting
* Bot now changes its nickname to "Eventcord" when it joins a guild and it has permission to do so. This prevents confusion with the bot naming.

## 3.2 - March 6, 2021

* Eventcord now features a dashboard at [d.eventcord.xyz](https://d.eventcord.xyz)
* Can now remove the group in event position 0 after a cycle

## 3.1 - August 21, 2020

* Events will now timeout after a certain period of time (2 hours at release)
* Automatically cycle your event using **;autocycle**!
* Vote to kick bad members from an event using **;votekick**&#x20;
* You can try allowing an event to self moderate and run using **;autocycle** and **;votekick**!
* ;uwuify
* Renamed "boosts" to stars to avoid confusion with Discord boosting

## 3.0 - July 7, 2020

What changed:

* Migration to [eris-fleet](https://github.com/danclay/eris-fleet) for shard, cluster, and service management
* Changed naming conventions
  * Queues and sessions have become events
  * A queue is a part of an event
* Multiple events are now allowed in each server
  * You can only have one event per text channel and per voice channel if using a karaoke event
  * New command `;events` which lists all events running on the server
  * Ability to start events in other channels by mentioning the channel in the end of your start command (`;start [event message] [mentioned channel to start the event])` The channel defaults to the channel the command was used in
  * Ability to end events in other channels (`;end`)
* Join in the queue with friends in the same event position as them
  * Done by mentioning the friend in the event you want to join when using the join command (`;join [@friend]`)
  * In the karaoke event, this allows for duets, trios, etc.

## 2.1 - April 28, 2020

What changed:

* Added [NSFW configuration](/using-the-bot/configuration#change-nsfw-tolerance) (currently only used for the `;weeb` command)
* Updated `;coronavirus` command with the [CDC's updated symptom list](https://www.cdc.gov/coronavirus/2019-ncov/symptoms-testing/symptoms.html) and [CDC's new cloth mask recommendation](https://www.cdc.gov/coronavirus/2019-ncov/prevent-getting-sick/diy-cloth-face-coverings.html).

## 2.0.2 - March 30, 2020

What changed:

* New basic Coronavirus (COVID-19) command
* Fixed some bugs

## 2.0.1 - March 27, 2020

New error reporting system. What changed:

* Kariari switch error logging software from GCP Error Reporting to Sentry
* New error code generation which actually provide context when debugging

## 2.0.0 - March 18, 2020

The revamp! What changed:

* Bot moved to Eris from Discord.js
* Master role changed to Queue Admin
* Master roles (now called queue admin roles) are now case-sensitive
* Better stability and performance
* Config command completely redone
* Everything recoded
* Database issues fixed
* All strings revamped to make the bot easier to understand
* Translating the bot is not easier than ever! Translations are now on [POEditor](https://go.kariari.xyz/locale).

{% hint style="info" %}
Roles who used the non-case-sensitive functionality before will automatically be updated in the bot's database without any effort from the end user. This will occur when a command is used which needs the Queue Admin Role. A message will be sent when this happens.
{% endhint %}

## 1.6.1 - Apr 5, 2019

### Added

* lock command (see [command list](/command-list#queue-commands))

### Fixed

* Attempted fix on issue where bot goes offline for seemingly no reason

## 1.6 - Nov 15, 2018

### Added

* Multi Language support (see available languages [here](/languages))
* revamped commands
* **Contribute to multi language support:** [go.kariari.xyz/langsubmit](https://go.kariari.xyz/langsubmit)

### Removed

* On using any command, Kariari would mention you. This no longer is the case.

## 1.5.3 - Nov 01, 2018

### Added

* [General event queues](broken://pages/-LQH5lu2TKolpkwvDAvP)

### Removed

* Halloween event/features

## 1.5.1 - Oct 25, 2018

### Added

* [setup](/using-the-bot/getting-started#assisted-setup) command
* [push](broken://pages/-LPPtxviOxcsFgy5OokQ#managing-the-queue) command

## 1.5 - Oct 22, 2018

### Changed

* Bot framework

### Added

* New bot framework
* guildinfo command
* about command
* invite command
* privacy policy
* help command generator
* docs


# Privacy

What data is kept

## Data Collected

### Using a command

When you use a command, some data is collected and stored in order to detect spam, errors, and collect analytics. The following information is collected:

* Command used
* The arguments used with the command
* The time the command was used
* Guild ID
* User ID
* Channel ID
* Message ID

### Using the events module

* User IDs of the members in the event
* User IDs of members in the event's voice channel (if using karaoke)
* User IDs of members who disconnected while muted (if using karaoke)
* Options set when using the events module

### Using the leveling module

* User IDs and Guild IDs to identify members
* Options set when using the leveling module

### Using the bot in a server

* Guild ID
* Options set for customizing the bot in the server

### Using the dashboard

* User ID
* Guilds you are in and basic information about them (partial guild object provided by Discord)

## Data Deletion

### User Data/Dashboard Data

If you would like to request your user data to be deleted, join the support server and ask in the #human-help channel. Note that if you use any bot command your data will be collected again.

### Server Data

Eventcord will automatically delete your server data once it is kicked from your server.

{% hint style="info" %}
Backups of the bot's database are stored for a few months
{% endhint %}


# Terms

By using this bot and/or it's website, you agree to the data in the [privacy policy](/bot-info/privacy) being stored. In addition, you accept any disfunction of the bot.


# Translation

How to translate

## What is POEditor?

POEditor is the software used by Eventcord for translations. The bot pulls data from this software to update its languages every few minutes. If languages dip under a certain percentage of the language being translated, the language will be disabled from the bot until the percentage increases.

## How do I use POEditor?

Visit [https://poeditor.com/kb/how-do-you-use-poeditor-contributor ](https://poeditor.com/kb/how-do-you-use-poeditor-contributor)for an introduction to using POEditor. Note that some of the features described in the article are not enabled.

## Considerations when Translating

* Please leave Discord markdown text (e.g. \*\*, \_\_, \`, etc.)
* Please leave placeholders. A placeholder is text wrapped by curly brackets (e.g. {url}). If you mess up a placeholder POEditor will notify you.