XP to Emerald
This is a simple plugin to convert from XP to Emeralds and back again. Other items may be used instead of Emeralds, if desired (XP to Dirt, anyone?). The item to use and the scale of conversion may be customized on a per-world (or global) basis.
Version 1.1.0 is considered feature-complete. While suggestions (or pull requests!) are welcome, the only planned work is bug fixes, and keeping it up to date.
While the jarfile is built against 1.4.6, it has been confirmed to be compatible through 1.7. Future updates will be built against the current stable or beta of Bukkit.
Commands
This section uses the following format:
- /command
- Description here.
- usage: /command <required_argument> [optional_argument]
- /xptoemerald
- Convert some XP to Emeralds.
- usage: /xptoemerald [player] [amount]
- /xptoemerald setscale
- Set the scale of conversion.
- usage: /xptoemerald setscale <scale> [world]
- /xptoemerald setmaterial
- Set the material to use.
- usage: /xptoemerald setmaterial <material> [world]
- /xptoemerald reload
- Reload values from the configuration file.
- usage: /xptoemerald reload
- /emeraldtoxp
- Convert some Emeralds to XP.
- usage: /emeraldtoxp [player] [amount]
- /xp2em
- Alias of
/xptoemerald
- /em2xp
- Alias of
/emeraldtoxp
Signs
Signs may be set up as follows.
[xptoemerald]
<conversion_type>
<amount>
<blank line>
The <conversion_type>
should be xte
or etx
, the former meaning the sign converts XP to Emeralds, the latter Emeralds to XP. The <amount>
is the amount of resources that should be converted with each click. Permission xptoemerald.admin
required to place signs, xptoemerald.sign
to use.
Configuration
conversion_scale
: Set the scale of conversion (the amount of XP that converts to 1 Emerald).
material
: Set the material to use.
convert_xp_using
: If emeralds
is used, the [amount]
is in Emeralds, while if xp
is used, it is XP.
convert_emeralds_using
: Similarly, sets the [amount]
to Emeralds, or can convert based on the desired Experience level. (This feature may not work correctly.)
To use specific settings for a world, use the following format:
world_name:
____
conversion_scale: 9001
____
material: gold_ingot
Replace the underscores with spaces, and 9001
and gold_ingot
with the values you wish to use.
Permissions:
xptoemerald.*
: Give access to all xptoemerald commands.
xptoemerald.admin
: Allow converting of other player's resources. Also allows setting of scale and material, and reloading of the config file.
xptoemerald.convert
: Allow converting of XP to Emeralds and back.
xptoemerald.convert.xte
: Allow conversion of XP to Emeralds via commands.
xptoemerald.convert.etx
: Allow conversion of Emeralds to XP via commands.
xptoemerald.sign
Allow conversion via signs.
Planned Features
- Version 1.1.0 is considered feature-complete. While suggestions are welcome, the only planned work is bug fixes, and keeping it up to date.
If we want to be able to change xp to villager eggs what would we put?
@pzannucci
You are welcome to submit a pull request. ;) Otherwise, I may attempt something like that if I ever get bored...
It would be cool if this would allow you to convert XP to a currency used by a robust economy plugin, like FE Economy. Then you could use this more easily with a ton of other plugins like Residence, Towny, SignShop, etc.
Wait... I have it working without a config... so. Just using the signs... :D Thank you 501st_alpha1. You make my server possible! Come check it out if you ever get a chance. ;3
This would be perfect for my server! can you update it for 1.6.2? :O
@EpicATrain
I have not had the chance to test or update it yet. Does it work if you fill out the config manually?
Does this not work with minecraft 1.6.2? I installed it but the config file auto generated a blank config.
@Fishbowl444
Thanks for the complement and the suggestions. Those are all great ideas; I will try to implement them when I get some free time.
May I just say that this plugin is a big part of my server's economy and that I love it? I like many others have some suggestions:
1. Shorter Commands - ( /xp2em and /em2xp maybe?) People like me are sometimes lazy.
2. More Config Options - I would like to disable converting emeralds back into exp, but lack the option to. Adding this alone would make me a very happy server admin.
3. Conversion Math - Personally I find it annoying to have to type the amount of xp instead of the number of emeralds I will get out of the transaction. Preferably add an option to use either or?
Keep up the good work and update to 1.4.6 when you have the chance!
Here is a video i made on how to install and use this plugin. Xp To Emerald Plugin
I'm not likely to make any videos myself, though others are welcome to.
The length of commands is a good point, I may add shorter ones in the future.
To set the scale, do: /xptoemerald setscale <scale> [world] where <scale> is an integer, and [world] is the name of a world (optional).
Shorter commands?
/xptrade
instead of those super long commands? Looking good so far. How do I set the <scale> ?
Video on commands or configuration?
@alexey7813
You are referring to this?
This is designed to be a general purpose plugin, so there are no plans to support other plugins at this time. How does this plugin use experience differently?
Great plugin, but there is a question. Do you plan to support plugin "Heroes". It is charged experience is not the usual way.
@gabriel11798
Not currently, though this will be added in a future update.
Are we able to change the conversion amount?