Leveling Configuration

Information regarding how to setup the Leveling module

General Setup Walk through

See the command table below to learn about the commands more

  1. Make sure Play has the appropriate permissions to run leveling properly

  2. Enabling Leveling >module leveling

  3. Configure your leveling settings with >levelset

  4. Setup your reward roles with >reward

  5. Ignore any text/vc channels you don't want people to get XP from with >ignore

  6. Enjoy!

Have any questions or concerns? Maybe a bug? Drop by our support server and we'll be happy to assist you as soon as we can!

Setup Commands

Command

Description

>module leveling

Enable/Disable the module

>help leveling

Displays all the commands for leveling

>levelset

Base command for configuring leveling

>levelset ?

Learn how to configure the leveling settings

>levelset ping

Enable/Disable pings on levelup

>levelset levels

Displays all levels and the XP needed for them

>levelset autoremove

Enable/Disable remove previous role on levelup

>debug roles

Displays all roles Gaius can manage

>reward

Base command for configuring level rewards

>reward add/rem @rolename or Rolename

Example of adding a new reward role

>allow award role Mod

Allows people with the Mod role to use the >award command

>rebuild

Every user gets their XP set to the highest role they have. If the highest reward role is Hero which requires 60000 XP, then anyone with the role will be set to 60k XP

Setup Variables

The base command to configure leveling settings is >levelset

Example: >levelset texttime 20

Variable

Description

reset

Resets the entire xp system - irreversible

texttime

Every x minutes the person will earn XP

Example: One XP every 5 minutes when talking

voicetime

Every x minutes of talking in VC the person will earn XP

Example: One XP every 5 minutes of talking in VC

base

Sets the initial cost for level one

modifier

Multiplies the rank cost every level by this to increase the difficulty overtime

Recommended: 80 - Good challenge overtime

amount

How much XP they get everytime they auto receive it for their activity

channel

Where users will get notified when they level up

Options: #channel or dm

question

If a user levels up and can rankup to more than one role the bot will ask them which role they want in your configured location.

Options: #channel or dm

How does BASE and MODIFIER work?

Alright so this is going to be a very popular question, we'll try to explain it as easily and simple as possible for you here!

The MODIFIER is the percentage of the base cost to add per level. So let's say the MODIFIER is set to 75, that means Play is adding 75% of the base for every level gained alongside some other additions. In the end every level will get harder for people to obtain overtime.

Reward message variables

Use these to automatically input certain data in your reward messages.

Variable

Description

%level

Posts the relevant level number to the level up

%user

The users name

%guild

The guild name

%role

The rewarded role name