EconXP by Agnate
version: 0.5.0 | craftbukkit: #1.3.1 | Source | Developer API


  • Let players use their experience points to buy things! Since people can already buy Enchantments with experience points, why not buy be able to buy from shops as well!
  • Supported by Vault!
  • Works with Minecraft 1.3.1!
  • Simple config file!
  • No permission system needed (though there are permissions available if you want them)!


EconXP is an economy system that users the player's experience points (the green orbs collected from monsters) as the currency. With the introduction of Enchanting costing experience, it will be interesting to see economies based around the concept of trading experience points, especially since they are already naturally collected and used, thus giving them an inherent value.

EconXP is now supported by Vault, so any shop or currency-related plugin that uses Vault can have EconXP as its currency type! I will also be adding Register support later, allowing EconXP to be used with many existing shop and economy-related plugins.

Minecraft Levels and Experience

Minecraft's levelling system is a bit strange and can be confusing to some people. Here's a quick explanation of how it works.

Players collect experience by slaying monsters, and the experience appears as green orbs on the ground. Upon receiving experience, players gain levels. As of MC 1.3.1, the calculations have changed for levels. I'm too lazy to write out the actual equations, though, so you'll have to check out the Minecraft wiki:

Developer API

Check out the API description here: Developer API

Configuration File

Configuration file can be found after starting the server, under the EconXP folder (inside the plugins folder).

Quote from the Config file:

death-drop-percent: 100 - [0 to 100] By default, all players drop all of their experience (rather than only 60% of the old total). Do NOT use decimals here (or a percent sign). Set this to 0 (zero) if you do not want players to lose their experience points when they die.


Commands are OP-only by default, with the exception of the balance (self-only) command. Therefore, players should not be able to transfer experience unless given permission to use the command. All commands map 1-to-1 with the respective permission (see the Permission section below).

All commands can use abbreviated forms. For example, you may type /exp bal instead of /exp balance. Player names and amounts can not be abbreviated, however (for obvious reasons). Capitalization of player names does not matter, though.

All <amount> and <factor> values must be positive (greater than or equal to zero). All <amount> values must be whole numbers.

Quote from the Command list:

/exp OR /econxp - The base commands (ie. /exp add Agnate 5 ). Either base can be used.

/exp add <player> <amount> - Add experience to the player.
/exp subtract <player> <amount> - Subtract experience from the player.
/exp multiply <player> <factor> - Multiply experience of a player by the factor.
/exp divide <player> <factor> - Divide experience of a player by the factor.
/exp set <player> <amount> - Set the experience of a player.
/exp clear <player> - Clear ALL of the experience of a player.

/exp balance - See your current experience points.
/exp balance <player> - See the current experience of a player.

/exp give <player> <amount> - Give some of your experience to a player.
/exp transfer <giver> <amount> <receiver> - Transfer from Giver to Receiver.


Permissions are required to use any of the commands. Players can receive experience without having any permissions.

Quote from the Permission nodes:

econxp.* - Allows all commands. econxp.add - Allows player to use the add command.
econxp.subtract - Allows player to use the subtract command.
econxp.multiply - Allows player to use the multiply command.
econxp.divide - Allows player to use the divide command.
econxp.set - Allows player to use the set command.
econxp.clear - Allows player to use the clear command.
econxp.balance - Allows player to use balance to check players' balances.
econxp.give - Allows player to give their own experience to a player.
econxp.transfer - Allows player to use the transfer command.

To Do List

My current to-do list:


View the Change Log.


  • Flamers for helping with the banner's screenshot!
  • Nijijokun for posting his iConomy source (and thus helping me figure out JNBT)!
  • garbagemule for inspiration and code help along the way!

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Kalle801 Kalle801 Jan 02, 2016 at 17:03 UTC - 0 likes

    Experience Level would be better than just experience

  • Avatar of PixelPartyTV PixelPartyTV Jul 16, 2014 at 15:32 UTC - 0 likes

    I'm having some trouble with using exp as a currency on [buy] signs, here's what my progress looks like so far. I'm guessing I'm doing something wrong but I don't really know what. [Buy] 1 Wood 5EconXP

  • Avatar of Ekevoo Ekevoo Feb 07, 2014 at 23:51 UTC - 0 likes

    Also please add reload command.

  • Avatar of Ekevoo Ekevoo Jan 27, 2014 at 03:39 UTC - 0 likes

    <<reply 1982401>> …swimmingly! Sir, I am adopting this for my server. :D

    ANYWAY! I'd like to suggest two things!

    1) some sort of player-configurable reminder of their current balance. When someone's hunting for XP, or farming on a mob spawner or whatever, just a message on the chat, or the scoreboard.

    2) ability for server owners to set name and symbol for the currency, for localization purposes.

  • Avatar of Ekevoo Ekevoo Jan 20, 2014 at 16:38 UTC - 0 likes

    How does this plugin deal with offline players receiving payment?

  • Avatar of zifaun zifaun Aug 31, 2013 at 21:32 UTC - 1 like

    Is it possible to remove [EconXP] and change the messages for each command?

  • Avatar of DrakenStark DrakenStark Jan 15, 2013 at 05:12 UTC - 2 likes

    I've haven't gotten any replies from either my ticket or the pm I sent. I hope you're still interested enough to add a bit to the plugin.

    Last edited Jan 15, 2013 by DrakenStark
  • Avatar of Greali Greali Nov 13, 2012 at 23:00 UTC - 0 likes

    Update the plugin to work with factions bank and others pls!!!!

  • Avatar of Nekuroi Nekuroi Oct 08, 2012 at 23:13 UTC - 0 likes

    @AgnateHeartstone: Go

    i really want this

  • Avatar of OtterofDeath OtterofDeath Aug 23, 2012 at 15:14 UTC - 0 likes

    @grevinelveck: Go

    It might be a problem with Minecraft itself. Like when you kill the enderdragon and go back to the main world it often doesn't show the real amount of experience they have until they relog or gain more experience.


Date created
Oct 04, 2011
Last update
Aug 07, 2012
Development stage
  • enUS
All Rights Reserved
Curse link
Reverse relationships
Recent files