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

config.yml

  1 Main:
  2 
  3   # The amount of experience gained per monster kill.
  4   Experience Gained Per Mob Kill: 2.5
  5 
  6   # The amount of experience gained per player kill.
  7   Experience Gained Per Player Kill: 250
  8 
  9   # The amount of experience lost when a player is killed
 10   # by another player.
 11   Experience lost On Death: 200
 12 
 13   # Allow players to lose experience into negative?
 14   Allow Negative Experience: false
 15 
 16   # Should Players be notified when they kill another player?
 17   Send Message On Player Kill: true
 18 
 19   # Should Players be notified when they kill a mob?
 20   Send Message On Mob Kill: true
 21 
 22   # Should players be notified when killed?
 23   Send Message On Death: true
 24 
 25   # Broadcasts a players death to the whole server.
 26   Send Broadcast On Death: true
 27 
 28   # Broadcasts a players level up to the whole server.
 29   Send Broadcast On Levelup: true
 30 
 31   # Broadcasts a broken killstreak to the whole server.
 32   Send Broadcast On Broken Killstreak: true
 33 
 34   # Should players be notified when a killstreak is broken?
 35   Send Killstreak Broken Message: true
 36 
 37   # Kill streak message and broadcasts will only display if a
 38   # killstreak of this value or greater is reached.
 39   Send Killstreak Alerts After: 5
 40 
 41   # How often should a level up be announced?
 42   # If you enter 5 every 5 levels players will be notified.
 43   Broadcast Levelup Every: 5
 44 
 45   # The maximum allowed level.
 46   # Note that once reached players will still earn experience beyond
 47   # the the maximum level without the ability to level up.
 48   Max Level: 99
 49 
 50   # The maximum allowed experience.
 51   Max Experience: 200000000
 52 
 53   # The amount of experience players start with.
 54   Starting Experience: 0
 55 
 56   # The minimum level required to engage or be engaged with in combat.
 57   Level Required For PVP: 0
 58 
 59   # Worlds that kills are not counted in.
 60   Blacklisted Worlds:
 61   - World1
 62   - World2
 63   - World3
 64 
 65   # The maximum amount of health a player can gain through levels.
 66   Max Extra Health: 10
 67 
 68   # The amount of health a player will gain per level.
 69   # 1 would be half a heart and 20 would be a 10 hearts.
 70   Extra Health Per Level: 0.2
 71 
 72   # The maximum amount of extra damage applied to a players attack
 73   # per level.
 74   Max Extra Damage: 2.0
 75 
 76   # The amount of additional experience applied to a player per
 77   # level.
 78   Extra Damage Per Level: 0.05
 79 
 80   # A player must achieve a multiple of the following number in order for the reward
 81   # script to run.
 82   # You can set this to 1 if you would like the script to be ran with every kill.
 83   Run Killstreaks Reward Every: 3
 84 
 85   # For each kill in a killstreak the following number will be used to boost your
 86   # experience gain (streak * exp).
 87   Killstreak Bonus Experience: 0.2
 88 
 89   # The length of the progress bar in the levels GUI.
 90   Progress Bar Length: 36
 91 
 92   # The length of the progress bar in placeholders.
 93   Progress Bar Length Placeholder: 20
 94 
 95   # Which economy plugin should be used?
 96   # You can choose from "Vault".
 97   Economy: Vault
 98 
 99 Anti Grinder:
100 
101   # Enabling this will enable the anti grinder timeout.
102   # In its default configuration it will prevent a player from killing the same player
103   # more than 3 times in 15 minutes.
104   Enabled: true
105 
106   # How long in seconds should a player have to wait once triggered?
107   Interval: 900
108 
109   # How many kills before trigger?
110   Max Kills Before Trigger: 3
111 
112   # Should we alert the killer when they have reached the threshold?
113   Alert When Triggered: true
114 
115 Formula:
116 
117   # This is the formula used when calculating a players level
118   # 
119   # LINEAR: All levels require the same amount of experience to reach the next level.
120   # EXPONENTIAL: Levels will increasingly require more experience the higher level you are.
121   # CUSTOM: You can enter a custom JavaScript equation here to finely tune your experience gain.
122   Leveling: EXPONENTIAL
123 
124   # The stagnant amount of experience required to level up.
125   Linear Increment: 500
126 
127   # You need to know what you're doing to mess with this, feel
128   # free to put in random values and test around however.
129   Exponential Base: 500
130 
131   # You need to know what you're doing to mess with this, feel
132   # free to put in random values and test around however.
133   Exponential Divisor: 7
134 
135   # This is the custom formula. You can use any JavaScript math functions here.
136   Custom: Math.pow(1.5, level) * Math.sqrt(level) * 2;
137 
138 Interfaces:
139 
140   Glass Type 1: GRAY_STAINED_GLASS_PANE
141 
142   Glass Type 2: BLUE_STAINED_GLASS_PANE
143 
144   Glass Type 3: LIGHT_BLUE_STAINED_GLASS_PANE
145 
146 System:
147 
148   # The enabled language file.
149   # More language files (if available) can be found in the plugins data folder.
150   Language Mode: en_US
151 
152 MySQL:
153 
154   # Set to 'true' to use MySQL instead of SQLite for data storage.
155   Enabled: false
156 
157   Hostname: localhost
158 
159   Port: 3306
160 
161   Database: your-database
162 
163   Username: user
164 
165   Password: pass
166 
167   Use SSL: false

LevelUpRewards.yml

 1 #MSG - Will send the user a message.
 2 #BROADCAST - WIll send everyone on the server a message.
 3 #ITEM - Will send the user an item.
 4 #ECONOMY - Will send the user money.
 5 #CMD - Will run a command as console.
 6 #HEAL - This will heal the player.
 7 #FIREWORK - This will launch a firework.
 8 #SOUND - This will play a sound on level up.
 9 #TITLE - This will show a title
10 #SUBTITLE - This will show a subtitle (Title must be present)
11 #OVERRIDE - Will cause the default options to not run.
12 
13 #Rewards in -1 will happen with every level up.
14 
15 #You can add levels to this file infinitely.
16 
17 -1:
18   - "TITLE &6&lLEVEL UP!"
19   - "SUBTITLE &7You have leveled up to &6level &6%level%&7!"
20   - "ITEM DIAMOND (3 * %level%)"
21   - "HEAL"
22   - "FIREWORK"
23 2:
24   - "MSG You leveled up to level 1!"
25   - "CMD /say HELLO %player%"
26   - "ITEM EMERALD 2"
27   - "ECONOMY $10000"
28 3:
29   - "MSG You leveled up to level 2!"
30 4:
31   - "MSG You leveled up to level 3!"
32 5:
33   - "MSG You leveled up to level 4!"
34 6:
35   - "MSG You leveled up to level 5!"
36 50:
37   - "OVERRIDE"
38   - "MSG Special level up message for hitting 50!"

KillstreaksReward.yml

 1 #MSG - Will send the user a message.
 2 #BROADCAST - WIll send everyone on the server a message.
 3 #ITEM - Will send the user an item.
 4 #ECONOMY - Will send the user money.
 5 #CMD - Will run a command as console.
 6 #HEAL - This will heal the player.
 7 #FIREWORK - This will launch a firework.
 8 #SOUND - This will play a sound on level up.
 9 #TITLE - This will show a title.
10 #SUBTITLE - This will show a subtitle.
11 #OVERRIDE - Will cause the default options to not run.
12 
13 #Rewards in -1 will happen with every level up.
14 
15 #You can add streaks to this file infinitely.
16 
17 -1:
18   - "SUBTITLE &cYou're on a Killstreak of &4%streak%&c!"
19   - "BROADCAST &6%player% &7just reached a killstreak of &6%streak% &7kills!"
20 3:
21   - "MSG Killstreak!"
22   - "CMD /say HELLO %player%"
23   - "ITEM EMERALD 2"
24   - "ECONOMY $10000"

Translations

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

Translations

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

Bonus health and extra damage aren't working in 1.8.8?

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.

What do the different experience function types do?

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.