Bukkit.org

EconXP

Banner

Overview

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


Features

  • 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)!


Description

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: MinecraftWiki.net


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

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

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:


Changelog

View the Change Log.


Credits

  • 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 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.

  • Avatar of grevinelveck grevinelveck Aug 15, 2012 at 20:31 UTC - 0 likes

    I'm not sure if this is a common problem or just due to the plugins I have but I have it set to 60% when the player dies they do not drop and exp and you have to exit and log back in to see your new exp total. This is the same for any percentage that's just what I have set. running CharonsFerry, Citizens2, CommandBook, CompatNoCheatPlus, CookMe, CraftIRC, Denizen, DurabilityNotify, EconXP, Enchanter, Herochat, Infected, MagicBookshelf, Monster Apocalypse, NoCheatPlus, NodeGuard, Orebfuscator, PermissionsBukkit, PorteCoulissante, RetractableBridge, SignShop, StarterKit, TravelPad, VanishNoPacket, VoxelSniper, WorldEdit, WorldGuard, iChat, ijmh, mcMMO, and uIRCBridge

  • Avatar of AgnateHeartstone AgnateHeartstone Aug 13, 2012 at 00:18 UTC - 0 likes

    @EDawg878: Go Its because EconXP still doesn't support banks. I really need to add this, as I'm tired of seeing it as a comment, haha!

    My Plugins: EconXP, RepairDispenser

  • Avatar of EDawg878 EDawg878 Aug 12, 2012 at 22:54 UTC - 0 likes

    @AgnateHeartstone: Go

    Econxp doesn't seem to be working with Vault and/or Factions When depositing money in a faction's bank, the bank balance is still stuck at -1 However, with other vault supported economies it seems to work fine. Im using Factions 1.6.9 Vault 1.2.17 Econxp 0.5.0 Any ideas on how to fix this?

  • Avatar of AgnateHeartstone AgnateHeartstone Aug 10, 2012 at 18:06 UTC - 0 likes

    @sleite: Go Yeah, I can add those in on the next update. :)

  • Avatar of sleite sleite Aug 10, 2012 at 18:04 UTC - 0 likes

    Any chance of adding an alias of /money instead of /exp?  And while we're on the topic, I'm sure many out there might appreciate /xp instead of /exp.

    Thanks

  • Avatar of AgnateHeartstone AgnateHeartstone Aug 09, 2012 at 22:56 UTC - 0 likes

    @fjutte: Go Offline players still receive the appropriate experience and levels. :)

Table of contents

  1. 1 Overview
  2. 2 Features
  3. 3 Description
  4. 4 Minecraft Levels and Experience
  5. 5 Developer API
  6. 6 Configuration File
  7. 7 Commands
  8. 8 Permissions
  9. 9 To Do List
  10. 10 Changelog
  11. 11 Credits

Facts

Date created
Oct 04, 2011
Categories
Last update
Aug 07, 2012
Development stage
Release
Language
  • enUS
License
All Rights Reserved
Curse link
EconXP
Downloads
4,471
Recent files

Authors