VEGAS2 provides a complex and customizable way to give members experience. VEGAS2 provides a passive XP system by default. The XP system works roughly like this:

When a Member sends a message VEGAS2 will check the Ignored Channels If the message is not in Ignored Channels VEGAS2 will check if the Member is on a Base Timeout. If a Base Timeout is not active for that Member VEGAS2 will award the Member XP passively and without any messages. XP Message Rewards are calculated by VEGAS2 choosing a random number between the Base Minimum and Base Maximum. VEGAS2 then multiplies the random number by the members set XP Multiplier and applies it to that Member.

Example:

If you run /xp set_base_reward minimum:5 max:10, VEGAS2 will reward at minimum 5 xp and at maximum 10 xp (not considering multipliers) on every message. By default every Members multiplier will be set to 1. So a member without an XP Multiplier would look like this:

Message -> Random number between 5 - 10 -> 7 -> XP Multiplier = 1 -> 7 * 1 = 7 -> Member receives 7xp

Now if a member received a 2 xp multiplier for an event, etc; that would look like this:

Message -> Random number between 5 -10 -> 7 -> XP Multiplier = 2 -> 7 * 2 = 14 -> Member receives 14xp

XP Multipliers can also be used as punishments or challenges if set below 1, assume 0.5:

Message -> Random number between 5 -10 -> 7 -> XP Multiplier = 0.5 -> 7 * 0.5 = 3 -> Member receives 3xp

/xp add member:<member> amount:<number>

Requires: Moderation Permission

Adds the given number to the Members experience.

/xp remove member:<member> amount:<amount>

Requires: Moderation Permission

Removes the given number from the Members experience.

/xp set_multiplier member:<member> multiplier:<number> [expires:<time>]

Requires: Moderation Permission

Set's a members XP Multiplier.

If expires is provided, the multiplier will change back to 1 after that time. Time can be in the following formats:

• Xm - the letter m preceded by any number will expire the multiplier in X minutes.
• Xh - the letter h preceded by any number will expire the multiplier in X hours.
• Xd - the letter d preceded by any number will expire the multiplier in X days.
• XM - the letter Uppercase M preceded by any number will expire the multiplier in X months.

/xp set_base_reward minimum:<number> [max:<number>]

Requires: Moderation Permission

Set the Base Minimum and Base Maximum for every members XP reward on messages.

/xp set_timeout time:<time>

Requires: Moderation Permission

Set the time for Base Timeout on Messages. Base Timeouts will be applied after a Member is rewarded XP for a Message (/xp add does not cause this). While a Member has a Base Timeout active they will not be able to gain XP from other Messages.

/xp ignore_channel list

/xp ignore_channel add channel:<channel>

/xp ignore_channel remove channel:<channel>

Requires: Moderation Permission

Provides a suite of functions to control what channels members will and will not receive XP in.

/xp prune

Removes all Members from your Servers Scoreboard that are no longer in your Server.

/xp user member:<member>

Displays an Embed with the provided Members current XP, Timeout and Multiplier.

/xp scoreboard [show_me:False]

Displays an Embed with the Servers Scoreboard. You can use the Buttons to navigate pages of the scoreboard.

If show_me is set to True, the Embed will show the Members spot on the scoreboard instead.

With the future Premium option VEGAS2 will also provide a subdomain website for your Servers Scoreboard! All members will be able to go to <your-guild-name>.veags2.com and see statistics about your Server, like the XP scoreboard.

VEGAS2 can automatically reward your server Members with Roles too! Once you setup a Leveled Role List VEGAS2 will automatically start awarding Leveled Roles when a Member reaches the corresponding XP Amount.

Example:

Assuming you have run the following:

/xp leveled_roles add `role:Level 1` `xp_amount:20`

/xp leveled_roles add `role:Level 2` `xp_amount:40`

When a Member in your server reaches 20 or more XP VEGAS2 will automatically add Level 1 to them. When a Member reaches 40 XP or more, Level 1 will be removed and Level 2 will be applied. The Leveled Role with the highest XP the Member qualifies for will always be applied (if not present) and all lower Leveled Roles will be removed. VEGAS2 processes Member Messages, XP and Leveled Roles as follows;

Member Message -> XP Processed -> XP Awarded* -> Member Leveled Roles Checked -> Member Leveled Roles Updated* -> Member Congrats*

*if applicable

/xp leveled_roles list

Display an Embed with the current Leveled Roles List for this server.

/xp leveled_roles add role:<role> xp_amount:<number>

Adds the provided role to the Leveled Role List for this server set to the XP Amount.

/xp leveled_roles remove role:<role>

Removes the provided Leveled Role from VEGAS2. VEGAS2 will no longer give or remove this Leveled Role.