Epic Levels

Implement a new way to reward, test, and challenge your most dedicated players with a creative leveling and rewards system.
Part of the Epic Series.

Getting Started

To install Epic Levels you will need to:

1. Turn your server off.
2. Add the required dependencies: Vault, Economy Management Plugin.
3. Add in the latest version of Epic Levels which you can find in our marketplace.
4. Turn your server back on.

Plugin Files

Main:

  # The amount of experience gained per monster kill.
  Experience Gained Per Mob Kill: 2.5

  # The amount of experience gained per player kill.
  Experience Gained Per Player Kill: 250

  # The amount of experience lost when a player is killed
  # by another player.
  Experience lost On Death: 200

  # Allow players to lose experience into negative?
  Allow Negative Experience: false

  # Should Players be notified when they kill another player?
  Send Message On Player Kill: true

  # Should Players be notified when they kill a mob?
  Send Message On Mob Kill: true

  # Should players be notified when killed?
  Send Message On Death: true

  # Broadcasts a players death to the whole server.
  Send Broadcast On Death: true

  # Broadcasts a players level up to the whole server.
  Send Broadcast On Levelup: true

  # Broadcasts a broken killstreak to the whole server.
  Send Broadcast On Broken Killstreak: true

  # Should players be notified when a killstreak is broken?
  Send Killstreak Broken Message: true

  # Kill streak message and broadcasts will only display if a
  # killstreak of this value or greater is reached.
  Send Killstreak Alerts After: 5

  # How often should a level up be announced?
  # If you enter 5 every 5 levels players will be notified.
  Broadcast Levelup Every: 5

  # The maximum allowed level.
  # Note that once reached players will still earn experience beyond
  # the the maximum level without the ability to level up.
  Max Level: 99

  # The maximum allowed experience.
  Max Experience: 200000000

  # The amount of experience players start with.
  Starting Experience: 0

  # The minimum level required to engage or be engaged with in combat.
  Level Required For PVP: 0

  # Worlds that kills are not counted in.
  Blacklisted Worlds:
  - World1
  - World2
  - World3

  # The maximum amount of health a player can gain through levels.
  Max Extra Health: 10

  # The amount of health a player will gain per level.
  # 1 would be half a heart and 20 would be a 10 hearts.
  Extra Health Per Level: 0.2

  # The maximum amount of extra damage applied to a players attack
  # per level.
  Max Extra Damage: 2.0

  # The amount of additional experience applied to a player per
  # level.
  Extra Damage Per Level: 0.05

  # A player must achieve a multiple of the following number in order for the reward
  # script to run.
  # You can set this to 1 if you would like the script to be ran with every kill.
  Run Killstreaks Reward Every: 3

  # For each kill in a killstreak the following number will be used to boost your
  # experience gain (streak * exp).
  Killstreak Bonus Experience: 0.2

  # The length of the progress bar in the levels GUI.
  Progress Bar Length: 36

  # The length of the progress bar in placeholders.
  Progress Bar Length Placeholder: 20

  # Which economy plugin should be used?
  # You can choose from "Vault".
  Economy: Vault

Anti Grinder:

  # Enabling this will enable the anti grinder timeout.
  # In its default configuration it will prevent a player from killing the same player
  # more than 3 times in 15 minutes.
  Enabled: true

  # How long in seconds should a player have to wait once triggered?
  Interval: 900

  # How many kills before trigger?
  Max Kills Before Trigger: 3

  # Should we alert the killer when they have reached the threshold?
  Alert When Triggered: true

Formula:

  # This is the formula used when calculating a players level
  # 
  # LINEAR: All levels require the same amount of experience to reach the next level.
  # EXPONENTIAL: Levels will increasingly require more experience the higher level you are.
  # CUSTOM: You can enter a custom JavaScript equation here to finely tune your experience gain.
  Leveling: EXPONENTIAL

  # The stagnant amount of experience required to level up.
  Linear Increment: 500

  # You need to know what you're doing to mess with this, feel
  # free to put in random values and test around however.
  Exponential Base: 500

  # You need to know what you're doing to mess with this, feel
  # free to put in random values and test around however.
  Exponential Divisor: 7

  # This is the custom formula. You can use any JavaScript math functions here.
  Custom: Math.pow(1.5, level) * Math.sqrt(level) * 2;

Interfaces:

  Glass Type 1: GRAY_STAINED_GLASS_PANE

  Glass Type 2: BLUE_STAINED_GLASS_PANE

  Glass Type 3: LIGHT_BLUE_STAINED_GLASS_PANE

System:

  # The enabled language file.
  # More language files (if available) can be found in the plugins data folder.
  Language Mode: en_US

MySQL:

  # Set to 'true' to use MySQL instead of SQLite for data storage.
  Enabled: false

  Hostname: localhost

  Port: 3306

  Database: your-database

  Username: user

  Password: pass

  Use SSL: false

#MSG - Will send the user a message.
#BROADCAST - WIll send everyone on the server a message.
#ITEM - Will send the user an item.
#ECONOMY - Will send the user money.
#CMD - Will run a command as console.
#HEAL - This will heal the player.
#FIREWORK - This will launch a firework.
#SOUND - This will play a sound on level up.
#TITLE - This will show a title
#SUBTITLE - This will show a subtitle (Title must be present)
#OVERRIDE - Will cause the default options to not run.

#Rewards in -1 will happen with every level up.

#You can add levels to this file infinitely.

-1:
  - "TITLE &6&lLEVEL UP!"
  - "SUBTITLE &7You have leveled up to &6level &6%level%&7!"
  - "ITEM DIAMOND (3 * %level%)"
  - "HEAL"
  - "FIREWORK"
2:
  - "MSG You leveled up to level 1!"
  - "CMD /say HELLO %player%"
  - "ITEM EMERALD 2"
  - "ECONOMY $10000"
3:
  - "MSG You leveled up to level 2!"
4:
  - "MSG You leveled up to level 3!"
5:
  - "MSG You leveled up to level 4!"
6:
  - "MSG You leveled up to level 5!"
50:
  - "OVERRIDE"
  - "MSG Special level up message for hitting 50!"

#MSG - Will send the user a message.
#BROADCAST - WIll send everyone on the server a message.
#ITEM - Will send the user an item.
#ECONOMY - Will send the user money.
#CMD - Will run a command as console.
#HEAL - This will heal the player.
#FIREWORK - This will launch a firework.
#SOUND - This will play a sound on level up.
#TITLE - This will show a title.
#SUBTITLE - This will show a subtitle.
#OVERRIDE - Will cause the default options to not run.

#Rewards in -1 will happen with every level up.

#You can add streaks to this file infinitely.

-1:
  - "SUBTITLE &cYou're on a Killstreak of &4%streak%&c!"
  - "BROADCAST &6%player% &7just reached a killstreak of &6%streak% &7kills!"
3:
  - "MSG Killstreak!"
  - "CMD /say HELLO %player%"
  - "ITEM EMERALD 2"
  - "ECONOMY $10000"

Translations

We offer translated versions of this plugin! In order to use them, enter the corresponding Language Code into your config.yml.

Language	Language code
German	de_DE
English	en_US
Spanish	es_ES
French	fr_FR
Italian	it_IT
Polish	pl_PL
Russian	ru_RU
Swedish	sv_SE
Turkish	tr_TR

Commands and Permissions

Command	Description	Permission Node
/levels help	Display information and commands for EpicLevels.	Default
/levels settings	Open the in-game settings editor.	epiclevels.admin
/levels reload	Reload the Configuration and Language files for EpicLevels.
/levels	Display a list of top levels.	epiclevels.menu
/levels show <player>	Look up information on a specified player.	epiclevels.show
/levels addexp <player> <amount>	Add experience to a player.	epiclevels.addexp
/levels takeexp <player> <amount>	Take experience away from a player.	epiclevels.takeexp
/levels boost <player> <multiplier> <time>	Boost a player's experience gained by a certain multiplier for a limited amount of time.	epiclevels.boost
/levels removeboost <player>	Remove a boost from a player.
/levels globalboost <multiplier> <time>	Boost the experience gained by all players on the server by a certain multiplier for a limited amount of time.
/levels removeglobalboost	Remove a global boost from the server.
/levels reset <Player>	Resets all stats for a player.	epiclevels.reset
A bonus experience multiplier. Replace # with an integer to multiply gained experience by.		epiclevels.multiplier.#

Placeholders

Placeholder	Description
%epiclevels_level%	Returns the player's level.
%epiclevels_experience%	Returns the player's amount of experience.
%epiclevels_kills%	Returns the player's number of kills.
%epiclevels_deaths%	Returns the player's number of deaths.
%epiclevels_killstreak%	Returns the player's current killstreak.
%epiclevels_bestkillstreak%	Returns the player's best killstreak.
%epiclevels_kdr%	Returns the player's kills-to-deaths ratio.
%epiclevels_nextlevel%	Returns the player's next level.
%epiclevels_neededfornextlevel%	Returns the amount of experience the player needs for the next level.
%epiclevels_boosterenabled%	Returns an enabled/disabled value as defined in the language file if a player has a booster applied.
%epiclevels_booster%	Returns the player's current booster multiplier, or 1 if there is none.
%epiclevels_globalboosterenabled%	Returns an enabled/disabled value as defined in the language file if there is a global booster applied.
%epiclevels_globalbooster%	Returns the server's global booster multiplier, or 1 if there is none.
%epiclevels_progressbar%	Returns the player's progress bar.
%epiclevels_playerkills%	Returns the player's amount of kills on other players.
%epiclevels_mobkills%	Returns the player's amount of mob kills.

Frequently Asked Questions

The Spigot API for 1.8.8 doesn't allow for easily adding bonus hearts and extra damage. If you want these two features, you'll have to upgrade your server.

LINEAR: All levels require the same amount of experience to reach the next level.

EXPONENTIAL: Levels will increasingly require more experience the higher level you are.

CUSTOM: You can enter a custom JavaScript equation here to finely tune your experience gain.