Default configurationThe default configuration.
Default presetsThe default preset file
Default globalsThe default globals file
Normal 1.3.1Normal 1.3.1 experience.
Emulating 1.2.5Template for emulating 1.2.5 in 1.3
Disabling all experienceTemplate for disabling all experience in 1.3

To start with, look at the default configuration file. It has some examples that you may find useful.

Note that the above is tuned for 2.4.0 or 2.3.0 (or Minecraft 1.3.1). For 2.2.4 and below, use these instead:

Emulating 1.3Template for making the experience system more like 1.3
Experience without smelting (1.3)Like above, only here experience is given directly.
Default configurationThe default configuration in 2.2.4.


Click for a tutorial with examples

Top level settings


This is the global experience multiplier. All experience drops, including the vanilla mob experience, will increase or decrease by this factor. To increase drops by X%, set the multiplier to 1 + X/100. For 50% this is 1 + 50/100 = 1.5

multiplier: 1.5

Default Rewards Disabled

When this is set to TRUE, all mob experience not specified under mobs will be set to zero. This is useful if you want to completely change the experience system.

Reward Type

Select the default method of rewarding players.

experienceSpawn experience orbs near the player.
virtualGive experience directly to the correct player.
economyConvert experience (1:1 ratio) to currency and give it to the player. This requires the Vault plugin.

Economy Drop

Sets the item to drop when awarding currency. Remove it if you want to give currency directly.

Economy Drop Worth

The value of each currency item.

Virtual Scan Radius

When using the VIRTUAL reward type, experience will only be granted automatically for actions that can be directly traced to the player. Mobs that die from traps will instead drop experience orbs if there are other players within this radius.

Default Channels

The default channel(s) to use when sending messages. If you're not using HeroChat, set this to "global".

Maximum Enchant Level

The amount of experience levels needed to receive the highest possible enchantment. The default level is 30.

Maximum Bookcase Count

The amount of books needed for an enchantment table to select the highest possible enchant level at the bottom slot. Default value is 15 bookcases, with a maximum of 255 bookcases. You must continue to build the walls of bookcases upwards for them to count.

Global Settings

These settings can be found in the file global.yml.

Max Blocks in History

This is the maximum number of block changes to store in memory. This history, along with data from LogBlock or HawkEye, is used to prevent players from getting experience illegitimately, i.e. from ore they themselves have placed. Default is 5000 changes.

Max Age in History

This is the maximum number of seconds to keep a block change in memory. The default is 10 minutes - after that, the mod will resort to looking up the block history in a database such as LogBlock.

Use Metrics

Whether or not to transmit anonymous usage data and general statistics. In addition to what MCStats is usually sending, the following is also included:

  • Whether or not ExperienceMod is connected to LogBlock, HawkEye, HeroChat, Vault or ExperienceBridgeMod.
  • The number of errors/warnings encountered since last reload.

You can opt-out from sending this data either by setting "use metrics" to false or setting "opt-out" in PluginMetrics to true.

Use AutoUpdate

Whether or not to automatically check BukkitDev for a new version on server startup, and then every three hours after that.

Use Permissions

Whether or not to use a permissions mod.

If this is disabled, all users will automatically be granted everything but the admin, untouchable and info-permissions, which are reserved for operators (users in ops.txt).

Disable Services

Any service with a name on this list will be disabled.

Mobs Section


  ?: 0
  ?|fall: 5
  zombie: 10

Mobs are matched by attributes using the following syntax (the rule body):


The different mob attributes:

NameIndex .Description
name1Matches a mob by its name or category.
damage cause2Matches a mob by the type of damage that killed it.
size3Matches a slime or magma cube by their size
wither4Matches wither skeletons (WITHER), non-wither skeletons (!WITHER) or both (?)
spawnernoneWhether or not the mob was spawned by a spawner. To match mobs that was NOT spawned, use !spawner.
babynoneWhether or not the mob is in baby form. To match adults, use !baby.
tamednoneWhether or not the mob is tamed. To match wild creatures, use !tamed.
playernoneWhether or not this mob was killed by a player.

An attribute, like name, can either be set to a value, or left blank with a question mark. Some attributes have no index - that means the order they're written in is irrelevant as long as they placed after (to the right) of all the attributes with indexes.

Player Death Section


player death:
  # Special people
  player: 0

  # Groups
  ?|vip: min(TOTAL_EXPERIENCE * 0.5, 255)
  ?|member: min(TOTAL_EXPERIENCE * 0.2, 255)
  ?|guest: [20, 40]

  # Experience reduction from damage types
    multiplier: 0.75
    multiplier: 0.5

  # Don't give experience when killed by the environment
  ?|?|?|!murder: 0

Players are matched with a syntax that's similar to mobs:


The different attributes are as follows:

NameIndex .Description
name1Matches a player by name(s).
group2Matches a player by permission groups.
damage cause3Matches a player the damage type that killed him or her.
murdernoneWhether or not the player was killed by another player. To match environmental deaths, use !murder.

In addition, you may use the following variables when defining the amount of resources awarded:

TOTAL_EXPERIENCEReplaced by the total amount of experience points that belonged to the killed player.
LEVEL_EXPERIENCEReplaced by the amount of experience points gained since the killed player last leveled up.
CURRENCYReplaced by the amount of currency belonging to the killed player.

You can also define the rewards with arbitrary mathematical expressions (+, -, *, /, ^) - for instance, in the example above, I multiplied the TOTAL_EXPERIENCE by 0.5 for VIPs, making them drop half their total experience when they're killed. In addition, I used the "min"-function to limit the experience drop to 255.

A full list of every available function can be found on this page.

Items Section


  coal ore:
    block source: 5
  redstone ore:
    block source: 20
  glowing redstone ore:
    block source: 20
  diamond ore:
    block source: 150
  mob spawner:
      first: 250
      last: 1000
  iron ingot:
    smelting result: [3, 9]

The syntax for matching regular items are as follows:

name|data value:

The different mob attributes:

NameIndex .Description
name1Matches a block or an item by its name or ID.
data value2Matches by data/damage value. See below for more details.
playernoneWhether or not this block was placed by a player previously.

However, name can also be a block ID, such as 46 for TNT. This is necessary if you want to match non-standard blocks, such as custom blocks from Technic Pack.

Multiple triggers for the same block type MUST be placed within the same query:

    block source: 1
    smelting result: 1

A list of every item and its name can be found here. For certain items it is possible to use a name instead of a number to match certain data values:

Item nameData values
Wood, Leaves, Wooden Steps, Wooden Double StepsTree species
Wool, Wool DyesDye colors
GrassGrass species
Step, Double StepStep materials
SandstoneSandstone types
Stone Bricks, Stone Brick StairsStone Brick Types
Monster Eggs (Silverfish Block)Monster Egg Types
CoalCoal Types

Notice that you must specify the experience on the result of the smelting, ect. an iron ingot, whilst mined blocks must be specified on the block type, not the dropped material.

The different actions (or triggers) are as follows:

block sourceInvoked when a block has been mined (without silk touch).
bonusInvoked when a block has been destroyed, regardless of silk touch.
smelting resultInvoked when an item or items have been smelted. The given experience is granted for every produced item.
crafting resultInvoked when an item has been crafted.
brewing resultInvoked when a potion has been brewed.
placing resultInvoked when a block has been placed. Note, this can easily be abused.

These rewards are triggered regardless of the history of a particular block or item. Generally, players will be able to gain experience from blocks they have placed themselves, but it's easy to prevent for ore blocks. Just use block instead of bonus, which disables experience from silk-touch pickaxes, or smelting if this doesn't make a difference (for iron or gold ores).


The amount of experience is either an integer, a real number or a range of numbers:

  diamond ore:
    block source: 10
    block source: 0.1 #  10% probability of giving 1 experience
  coal ore:
    block source: [3, 5]  # Range

You can also use first and last to set a range. The difference is only in esthetics:

  coal ore:
    block source:
      first: 3
      last: 5

Cost or Penalty

If you're using the virtual or economy reward types, it's also possible to make certain actions cost resources. For instance, you can make placing TNT cost 5 experience:

    placing result: -5

You could also refund this cost if the player picks up the TNT instead of blowing it up

    placing result: -5
    bonus source: 5

Item Drops

You can also add to the list of items that are usually dropped from blocks or mobs. This is acheived by using the drops reward:

# Simulate the gold rush!
    block source:
        gold nugget: 0.1

Currently, this will only add additional items to the default drop list, and never replace it. Preventing gravel from dropping flint, for instance, is thus not yet possible, but it's on the TODO list for a future version.



    brewing result: 20
  potion|instant heal|1|!splash|!extended:
    brewing result: 50

The syntax is as follows:

  brewing result:

The different potion type attributes that can be matched:

NameIndex .Description
potion1Required. Should just be potion.
potion type2Matches potions by their potion types.
level3Matches potions by their level or tier. Is never higher than two.
extended4Whether or not the potion duration has been extended. Use !extended for non-extended potions.
splash5Whether or not the potion is a splash potion. Use !splash for normal potions.

Matching Multiple Attributes

You can match multiple attributes at once with comma:

  glowing redstone ore, redstone ore::
    block source: 20

This also works for potions:

  potion|instant heal, instant damage, regen, speed|1|!splash|!extended:
    brewing result: 50

Player Section

This section contains reward for activities that doesn't fit anywhere else, such as fishing.

Fishing Success

The amount of experience to grant when a player successfully catches a fish.

  fishing success: [3, 5]

Fishing failure

The amount of experience to be awarded even when a player fails to catch a fish.

  fishing failure: 0

Multiple Rewards

You can have multiple reward types at the same time. The following will give 10 exp and 10 currency for mining redstone ore.

  redstone ore:
    block source:
      virtual: 10
      economy: 10
      message: '{player} has found redstone!'
      channels: [global]

Sending Messages

Starting from 2.0.0, it's possible to set a message that will be broadcasted when a player is awarded experience. Alternatively, the message can be transmitted on a set channel (like local), to not unnecessarily spam the server when someone is mining coal. Note that currently this is only possible if your server is using HeroChat, but that might change in the future.

The syntax is relatively simple. Add the message (and an optional channel list) to everywhere you award experience and want to broadcast a message:

    block source:
      experience: [100, 150]
      economy: 50
      message: '{player} has found a diamond and got {experience} experience and currency!'
      channels: [global]
  coal ore:
    block source:
      default: 10
      message: '{player} mined some coal.'
      channels: [local]

In the above example we've decided to broadcast the diamond find to the entire server, while coal is simply sent to the local channel (which might have a range of say 100 meters). We've also given 50 currency in addition to the experience. Note that coal uses a default reward - this means you can easily change the reward type of every item by setting "reward type" at the root.

The possible properties for item and mob rewards is as follows:

defaultSets how much to award of the default reward type.
experienceSets how much experience to spawn.
virtualSets how much experience to give directly.
dropsSets which items to drop on the ground.
messageThe message to send.
channelsList of channels this message will be sent.

Channels are either referring to HeroChat channels, if HeroChat is enabled, or the following built-in channels:

globalAny player on the server.
worldAny player in the current world (overworld, nether or the end).
privateThe current player.

It's also possible to reference certain values in the message:

{player}Will be replaced by the name of the relevant player.
{experience}Will be replaced by the total amount of experience awarded (experience + virtual).
{currency}Will be replaced by the total amount of currency awarded.
{items}Will be replaced by the new items that are dropped on the ground.
{count}The number of times this message has been combined.


Presets allow you to set a different configuration file per user. The following is an example of a presets.yml file:

# default for all worlds
    multiplier: 1
        block source: 5   
# default for every user in world1
  file: defaultForWorld1.yml
# preset for every VIP member
  file: vip.yml
# you can also combine files
  file: vip.yml
  file: admins.yml

After that, you can associate each preset with a particular user or group. Here using PremissionsEx:

    # ect.
      experiencePreset: vipPreset
      - '*'
      experiencePreset: adminPreset

In 2.5.0, it's also possible to use a more specific multiplier that only applies to certain blocks. The following preset uses the "vip.yml" preset for all users in world 2, but with every block source reward increased by 300%. Every other reward is untouched.

        block source:
          multiplier: 4
   - vip.yml


This section allows you to alter the amount of experience required to level up to the next level. For instance, to recreate the experience system in 1.2.5. in 1.3, use the following:

  0 - Infinity: floor(7 + 3.5*level)

If you instead want to use something similar to 1.3, start by modifying these formulas:

  0 - 15: 17
  16 - 29: 17 + (level - 15) * 3
  30 - Infinity: 62 + (level - 30) * 7

Or just set each level directly:

  # Level - Experience needed to level
  0: 17
  1: 17
  2: 17
  3: 17
  4: 17 
  5: 17
  6: 17
  7: 17
  8: 17
  9: 17
  10: 17
  11: 17
  12: 17
  13: 17
  14: 17 
  15: 17
  16: 20
  17: 23
  18: 26
  19: 29
  20: 32
  21: 35
  22: 38
  23: 41
  24: 44
  25: 47
  26: 50
  27: 53
  28: 56
  29: 59
  30 - Infinity: 62 + (level - 30) * 7


Posts Quoted:
Clear All Quotes