Documentation / Gaius Play / Leveling

Leveling

Members earn XP for chatting and time in voice, level up and unlock reward roles.

>level

EveryonePrefix + SlashModule: leveling

Check your current level, your current amount of xp, as well as whether you have any upcoming rewards once you get to a new level. You can also check someone else's level or force a level up if you are missing rewards.

Usage

>level up
>level [member]

Examples

>level up
>level @Member
Slash command /level
OptionTypeDescription
upTrue / FalseManually run through the level up system
targetUserOther member to check the level status of

“Your vanity knows no bounds, just spam the command already.”

>leaderboard

EveryonePrefix + SlashModule: leveling

Check the leaderboard of this server. You can check either the full leaderboard, the voice xp leaderboard, or the text xp leaderboard. You may also check how you are doing on the leaderboard or even how someone else is doing.

Usage

>leaderboard [text/voice] [member]
>leaderboard me
>leaderboard [amount]
>leaderboard [start-end]

Examples

>leaderboard text @Member
>leaderboard me
>leaderboard 25
>leaderboard 10-15
Slash command /leaderboard
OptionTypeDescription
type requiredTextView the leaderboard for all, text, or voice xp
Choices: all text voice
amountNumberAmount of the leaderboard to view
startatNumberPoint at which to view the leaderboard
targetUserThe member to view the leaderboard in relation to

“Come on... you want that gold medal, I know you do.”

>listrewards

ModeratorPrefix + SlashModule: leveling

List all the rewards for your reward system. If you have too many rewards a page system will be generated to look through. You may also get specifics about a single reward by providing a role.

Usage

>listrewards [role]

Examples

>listrewards @Role
Slash command /listrewards
OptionTypeDescription
roleRoleView data specific to this rewards

“For those with too much time and too little memory, just download more ram.”

>listboosts

ModeratorPrefix + SlashModule: leveling

List out the currently running boosts or future boosts to be applied. Will provide all the details such as start time end time, duration, and repetition.

Usage

>listboosts

Examples

>listboosts
Slash command /listboosts

No options.

“Since when did I turn into a calendar of reminders!?.”

>restart

EveryonePrefix + SlashModule: leveling

Restart your own roles or experience on the server. You provide either 'roles' to remove all your reward roles, or 'xp' to remove your experience and roles. An admin may also provide 'server' to restart the entire server's roles or xp.

The server option needs Admin.

Usage

>restart xp/roles
>restart server xp/roles

Examples

>restart xp
>restart server roles
Slash command /restart

/restart xp Remove all of your xp and reward roles

/restart roles Remove all of your reward roles

/restart server Restart the xp or reward roles of the entire server

OptionTypeDescription
type requiredTextWhether to restart the server's xp or reward roles
Choices: xp roles

“Instead of making the staff do it, just make me do it instead. *cries*”

>configure

AdminPrefix + SlashModule: leveling

Configure the leveling system or list out the current settings, you can configure almost every aspect of the system. Valid editable properties are, texttime, voicetime, textamount, voiceamount, base, modifier, autoremove, random, probation, usebuttons, channel, questionchannel, questionmessage, message, equation, vcrequirement, characterlimit, and autoreclaim. You can also provide 'showlevels' as well as an amount to get a snapshot of your level system. Furthermore you can provide 'explain' as well as a property to get an explanation of each property.

Usage

>configure current
>configure showlevels [#startingfrom]
>configure explain property
>configure property value

Examples

>configure current
>configure showlevels 20
>configure explain questionmessage
>configure texttime 1
Slash command /configure

/configure current View the current leveling settings

/configure showlevels Get a snapshot of the xp required for each level

OptionTypeDescription
startWhole numberThe level to start the snapshot from

/configure explain Get an explanation of a leveling property

OptionTypeDescription
property requiredTextThe property to explain
Choices: characterlimit autoremove showlevels texttime voicetime textamount voiceamount base message modifier channel questionchannel equation random questionmessage vcrequirement autoreclaim usebuttons probation

/configure texttime Set the minutes between messages before text xp is tracked, 0 turns it off

OptionTypeDescription
minutes requiredNumberThe amount of minutes, 0 to turn off

/configure voicetime Set the minutes in voice required before voice xp is given, 0 turns it off

OptionTypeDescription
minutes requiredNumberThe amount of minutes, 0 to turn off

/configure textamount Set the amount of xp given per text trigger

OptionTypeDescription
amount requiredWhole numberThe amount of xp to give
maximumWhole numberIf provided, a random amount between the first amount and this maximum is given

/configure voiceamount Set the amount of xp given per voice trigger

OptionTypeDescription
amount requiredWhole numberThe amount of xp to give
maximumWhole numberIf provided, a random amount between the first amount and this maximum is given

/configure base Set the base cost of a level

OptionTypeDescription
amount requiredWhole numberThe new base amount

/configure modifier Set the modifier applied to the base level cost

OptionTypeDescription
amount requiredWhole numberThe new modifier amount

/configure equation Set the equation used to calculate levels

OptionTypeDescription
equation requiredWhole numberThe equation number to use

/configure vcrequirement Set how many members must be in voice for voice xp to be tracked

OptionTypeDescription
amount requiredWhole numberThe amount of members required

/configure characterlimit Set how many characters a message needs to count towards xp, 0 turns it off

OptionTypeDescription
amount requiredWhole numberThe amount of characters, 0 to turn off

/configure autoremove Toggle removing the previous reward when a member receives the next one

OptionTypeDescription
valueTrue / FalseTurn this setting on or off, leave blank to flip the current value

/configure random Toggle assigning a random reward when a member fails to choose one

OptionTypeDescription
valueTrue / FalseTurn this setting on or off, leave blank to flip the current value

/configure probation Toggle putting returning members on probation

OptionTypeDescription
valueTrue / FalseTurn this setting on or off, leave blank to flip the current value

/configure usebuttons Toggle using buttons for question messages

OptionTypeDescription
valueTrue / FalseTurn this setting on or off, leave blank to flip the current value

/configure autoreclaim Toggle reclaiming points when a member leaves the server

OptionTypeDescription
valueTrue / FalseTurn this setting on or off, leave blank to flip the current value

/configure message Set the default level up message, 'none' turns it off

OptionTypeDescription
message requiredTextThe new level up message

/configure questionmessage Set the message asked when a member has multiple reward choices

OptionTypeDescription
message requiredTextThe new question message

/configure channel Set where level up messages are sent

OptionTypeDescription
channelChannelThe channel to post the messages in
locationTextSend the messages by 'dm' or in the 'message' channel instead of a set channel
Choices: dm message

/configure questionchannel Set where reward choice questions are asked

OptionTypeDescription
channelChannelThe channel to post the messages in
locationTextSend the messages by 'dm' or in the 'message' channel instead of a set channel
Choices: dm message

“Here's a wrench, you get to provide the monkey.”

>testvc

AdminPrefix + Slash

Test voice channel xp for a specific member or yourself. Go through the voice xp process yourself to get notifications in the channel you run the command in. Useful if you are unusure if you are gaining xp or how much xp is being gained.

Usage

>testvc member

Examples

>testvc @Member
Slash command /testvc
OptionTypeDescription
member requiredUser or roleMember to test voice xp on

“Lol, as if I would ever tell you the correct information anyways.”

>ignore

AdminPrefix + SlashModule: leveling

Set a channel, member, or role, to be ignored by the leveling system for xp gain. You can specify whether you wish to ignore text xp, voice xp, or all xp, if you do not specify I will ignore all xp. You may all provide 'list' to get a list of current ignores.

Usage

>ignore [text/voice/all] role/channel/member
>ignore list

Examples

>ignore text @Role
>ignore list
Slash command /ignore

/ignore channel Ignore a channel for xp gain

OptionTypeDescription
channel requiredChannelThe channel to ignore
xptypeTextThe type of xp to ignore, defaults to all
Choices: text voice all

/ignore role Ignore a role for xp gain

OptionTypeDescription
role requiredRoleThe role to ignore
xptypeTextThe type of xp to ignore, defaults to all
Choices: text voice all

/ignore member Ignore a member for xp gain

OptionTypeDescription
member requiredUserThe member to ignore
xptypeTextThe type of xp to ignore, defaults to all
Choices: text voice all

/ignore list List all the current ignores

“Lalalalalalalalalalalala. I'm not listening!”

>recog

AdminPrefix + SlashModule: leveling

Remove an experience ignore from a member, channel, or role. You can also list all ignores with 'list'.

Usage

>recog list
>recog member/role/channel

Examples

>recog list
>recog ChannelName
Slash command /recog

/recog channel Remove the ignore from a channel

OptionTypeDescription
channel requiredChannelThe channel to recognize again

/recog role Remove the ignore from a role

OptionTypeDescription
role requiredRoleThe role to recognize again

/recog member Remove the ignore from a member

OptionTypeDescription
member requiredUserThe member to recognize again

/recog list List all the current ignores

“If I had my way this command would not work, less for me to do.”

>award

AdminPrefix + SlashModule: leveling

Give or set a member or role text or voice xp. You can supply either level with an amount of levels. You can set a members xp through the use of the word 'set'.

Usage

>award member/role #xp [text/voice]
>award member/role level #level [text/voice]
>award member/role set #xp [text/voice]
>award member/role set level #level [text/voice]

Examples

>award @Member 10
>award @Member level 5 voice
>award @Rolename set 500 text
>award Rolename set level 5
Slash command /award
OptionTypeDescription
target requiredUser or roleThe role or member to award xp to.
setTrue / FalseWhether to 'set' the xp to the given value
levelTrue / FalseWhether to interpret the input as the level to set the xp to
amountNumberAmount of xp, or the level, to add
typeTextThe type of xp to add
Choices: text voice

“Lots of points for good little boys and girls.”

>reclaim

AdminPrefix + SlashModule: leveling

Remove experience from a member, you can remove all experience, a specific amount of experience, and/or a specific type of experience. You can also provide 'left' to attempt to remove all the experience from members who are no longer in the server. Role reclaim must be an id, mention, or single word.

Usage

>reclaim all/#xp amount [text/voice/all] member/role
>reclaim left

Examples

>reclaim all @member
>reclaim all Role
>reclaim 500 voice 1234567890
>reclaim left
Slash command /reclaim

/reclaim left Remove all xp from members no longer in the server

/reclaim all Remove all xp from the target

OptionTypeDescription
target requiredUser or roleTarget member or role to remove xp from
xptypeTextWhat type of xp to remove
Choices: text voice all

/reclaim amount Remove a specific amount of xp from the target

OptionTypeDescription
amount requiredNumberAmount of xp to remove
target requiredUser or roleTarget member or role to remove xp from
xptypeTextWhat type of xp to remove
Choices: text voice all

“Just remove all the xp from everyone, I'm sure they wont mind.”

>addreward

AdminPrefix + SlashModule: leveling

Add rewards to be given in the reward system. You can provide 'none' or 'global' for the previous. Leave message blank for no message, defaulting to whatever message is set in 'configure'.

Usage

>addreward role level list of % previous roles %% response

Examples

>addreward Rolename 10 none %% Congrats you got the first role!
Slash command /addreward
OptionTypeDescription
role requiredRoleThe role to add as a reward
level requiredNumberThe level to set the reward at
previousTextThe previous roles required to have get this reward, seperated by %, can be 'none'
messageTextThe message to post when a member gets this reward

“Useless rewards for useless points, it's fun though.”

>editreward

AdminPrefix + SlashModule: leveling

Edit a reward tied to the leveling system. Each part is edited individually by it's property.

Usage

>editreward role level #
>editreward role message new message
>editreward role global
>editreward role previous roles%list
>editreward role specials
>editreward role autoremove role/none/all

Examples

>editreward @Role level 10
>editreward @Role message New Message Here
>editreward @Role global
>editreward @Role previous @NewRole%@OtherRole
>editreward @Role specials
>editreward @Role autoremove @Role
Slash command /editreward

/editreward level Edit the level of the reward

OptionTypeDescription
role requiredRoleThe reward role to edit
level requiredNumberThe new level to set the reward to

/editreward message Edit the levelup message of the reward

OptionTypeDescription
role requiredRoleThe reward role to edit
message requiredTextThe new level up message to set

/editreward previous Edit the required roles of the reward

OptionTypeDescription
role requiredRoleThe reward role to edit
rolelist requiredTextThe new required roles separated by %

/editreward global Set a role as a 'global' reward

OptionTypeDescription
role requiredRoleThe reward role to edit

/editreward specials Edit complex tree leveling for a reward

OptionTypeDescription
role requiredRoleThe reward role to edit

/editreward autoremove Configure specific roles to autoremove

OptionTypeDescription
role requiredRoleThe reward role to edit
input requiredTextRoles to autoremove, or 'all', or 'none'.

“Do not think I did not notice your typo before, I knew you'd be back.”

>delreward

AdminPrefix + SlashModule: leveling

Delete a reward role from the system. No further modifications to your system will be done and any gaps must be filled by your usage of the 'editreward' command.

Usage

>delreward role/id

Examples

>delreward @Role
Slash command /delreward
OptionTypeDescription
roleRoleThe reward role to delete
roleidTextThe ID of the reward role, for when the role no longer exists

“Meh, you did not need that reward anyways.”

>setboost

AdminPrefix + SlashModule: leveling

Set a boost for channels, members, roles, or the entire server. You must specify a start date, but you can specify duration, expiration, or repetition. The boost amount will be added to the total xp, eg a boost amount of .8 will result in 1.8x xp gained. Here are the list of flags: %start %expire %duration %repeat.
You use w/d/h/m/s format for all flags. For 'start' and 'expire' you may use time and date in the format hh:mm tzTimezone dd/mm OR dd/mm/yyyy

Timezone list: GMT : -0; UTC : +0; ECT : +1; EET : +2; ART : +2; EAT : +3; ET : +3.5; NET : +4; PLT : +5; IST : +5.5; BST : +6; VST : +7; CTT : +8; JST : +9; ACT : +9.5; AET : +10; SST : +11; NST : +12; MIT : -11; HST : -10; AST : -9; PST : -8; PNT : -7; MST : -7; CST : -6; EST : -5; IET : -5; PRT : -4; CNT : -3.5; AGT : -3; BET : -3; CAT : -1

Usage

>setboost channel amount cumulative/minimum flags
>setboost role amount cumulative/minimum flags
>setboost member amount cumulative/minimum flags
>setboost guild amount cumulative/minimum flags

Examples

>setboost #Channel 1 minimum %start 1m 1h 2w
>setboost @Role .5 cumulative %start 12:00 pm tzest 12/05 %expire 1w 2m 3h
>setboost @Member 1.6 minimum %start now %expire 15:00 tzest 7/09/2021 %repeat 1w
>setboost guild 2 cumulative %start 10:00 am tzest 01/07/2021 %duration 3h
Slash command /setboost

/setboost channel Set a boost for a channel

OptionTypeDescription
channel requiredChannelThe channel to boost
amount requiredNumberThe boost multiplier, eg 0.8 results in 1.8x xp gained
type requiredTextWhether this sets a minimum boost amount or is added on top of other boosts
Choices: minimum cumulative
start requiredTextWhen the boost starts, 'now', w/d/h/m/s format, or hh:mm tzTimezone dd/mm
expireTextWhen the boost expires, w/d/h/m/s format, or hh:mm tzTimezone dd/mm
durationTextHow long each boost lasts, w/d/h/m/s format
repeatTextHow often the boost repeats, w/d/h/m/s format

/setboost role Set a boost for a role

OptionTypeDescription
role requiredRoleThe role to boost
amount requiredNumberThe boost multiplier, eg 0.8 results in 1.8x xp gained
type requiredTextWhether this sets a minimum boost amount or is added on top of other boosts
Choices: minimum cumulative
start requiredTextWhen the boost starts, 'now', w/d/h/m/s format, or hh:mm tzTimezone dd/mm
expireTextWhen the boost expires, w/d/h/m/s format, or hh:mm tzTimezone dd/mm
durationTextHow long each boost lasts, w/d/h/m/s format
repeatTextHow often the boost repeats, w/d/h/m/s format

/setboost member Set a boost for a member

OptionTypeDescription
member requiredUserThe member to boost
amount requiredNumberThe boost multiplier, eg 0.8 results in 1.8x xp gained
type requiredTextWhether this sets a minimum boost amount or is added on top of other boosts
Choices: minimum cumulative
start requiredTextWhen the boost starts, 'now', w/d/h/m/s format, or hh:mm tzTimezone dd/mm
expireTextWhen the boost expires, w/d/h/m/s format, or hh:mm tzTimezone dd/mm
durationTextHow long each boost lasts, w/d/h/m/s format
repeatTextHow often the boost repeats, w/d/h/m/s format

/setboost guild Set a boost for the entire server

OptionTypeDescription
amount requiredNumberThe boost multiplier, eg 0.8 results in 1.8x xp gained
type requiredTextWhether this sets a minimum boost amount or is added on top of other boosts
Choices: minimum cumulative
start requiredTextWhen the boost starts, 'now', w/d/h/m/s format, or hh:mm tzTimezone dd/mm
expireTextWhen the boost expires, w/d/h/m/s format, or hh:mm tzTimezone dd/mm
durationTextHow long each boost lasts, w/d/h/m/s format
repeatTextHow often the boost repeats, w/d/h/m/s format

“For good boys and girls, of which there are none.”

>delboost

AdminPrefix + SlashModule: leveling

Delete a registered boost. This takes a channel, role, member, or 'guild'.

Usage

>delboost channel/role/member
>delboost guild

Examples

>delboost #Channel
>delboost guild
Slash command /delboost

/delboost channel Delete the boost on a channel

OptionTypeDescription
channel requiredChannelThe channel to delete the boost from

/delboost role Delete the boost on a role

OptionTypeDescription
role requiredRoleThe role to delete the boost from

/delboost member Delete the boost on a member

OptionTypeDescription
member requiredUserThe member to delete the boost from

/delboost guild Delete the server wide boost

“See, what did I tell you, there are none.”

>levelsync

AdminPrefix + SlashModule: leveling

Synchronize the level system of this server with other servers. Only the server owner may use this command and it is a premium feature. The server being synchronized to must first approve the server that wishes to sync to it.
'current' lists the current level sync settings, 'approve' pre-approves a server to sync to this one, 'unapprove' removes that approval, 'add' synchronizes this server to a server that has approved it, 'rem' removes a synchronization, and 'clear' removes all synchronizations and approvals.

Only the server owner can use this command, and it is a premium feature.

Usage

>levelsync [current]
>levelsync approve serverid
>levelsync unapprove serverid
>levelsync add serverid
>levelsync rem serverid
>levelsync clear

Examples

>levelsync current
>levelsync approve 270438133584232449
>levelsync add 270438133584232449
>levelsync clear
Slash command /levelsync

/levelsync current View the current level sync settings

/levelsync approve Pre-approve a server to sync to this server

OptionTypeDescription
server requiredTextThe ID of the server to approve

/levelsync unapprove Remove the pre-approval of a server

OptionTypeDescription
server requiredTextThe ID of the server to unapprove

/levelsync add Synchronize this server to a server that has approved it

OptionTypeDescription
server requiredTextThe ID of the server to sync to

/levelsync rem Remove a level sync

OptionTypeDescription
server requiredTextThe ID of the server to desynchronize from

/levelsync clear Clear all level syncs and approvals

“Sharing is caring, as long as you're paying.”

>importmee6

AdminPrefix + SlashModule: leveling

Import in Mee6 leveling data and switch to a comparable leveling equation. Operation may take a minute depending on the size of the server.

Usage

>importmee6

Examples

>importmee6
Slash command /importmee6

No options.

“We used to be pen pals, that's how I know his address.”

>importamari

AdminPrefix + SlashModule: leveling

Import in Amari leveling data. Operation may take a minute depending on the size of the server. This will create reward roles but not switch to a particular equation. You must provide your own Amari apikey in order for this to work.

Usage

>importamari

Examples

>importamari
Slash command /importamari
OptionTypeDescription
apikey requiredTextApikey for Amari bot

“Pet the adorable kitty, don't mess up the bow. I will hurt you.”

>importtatsu

AdminPrefix + SlashModule: leveling

Import in Tatsu leveling data. Operation may take a minute depending on the size of the server. This does not create any reward roles or switch to a particular equation. You must provide your own tatsu apikey in order for this to work.

Usage

>importtatsu apikey

Examples

>importtatsu 1234567890-1234567890-1234567890
Slash command /importtatsu
OptionTypeDescription
apikey requiredTextApikey for Tatsu bot

“I would get a tatsugotchi, but my developer is enough work to take care of already.”