Icon 3


Getting Started|Wiki|Commands|Permissions|FAQ|How To|Troubleshooting


HyperConomy is the all in one economy and shop plugin. It can be a simple chest or sign shop plugin, a Vault compatible economy plugin, a region based shop plugin with many configurable options, or even a complex system of economically competing towns and kingdoms. Any vanilla Minecraft item can be traded in HyperConomy and virtually any custom item can be added as well. Prices can be configured to change dynamically or they can be set as desired. To quickly edit prices and settings you can double click on HyperConomy.jar to access the GUI editor. HyperConomy has many features including things such as item price linking and showcase style item displays. Read below or check out the wiki for more information.



  • Supports all standard Minecraft items. (fireworks, lore, books, maps, damaged items, etc.)
  • Supports the addition of unlimited custom items.
  • Integrated economy plugin.
  • Player to player, player to shop, and shop to player trading.
  • Dynamic pricing system based on a hyperbolic curve.
  • Item price linking (price of recipe item is based on price of component items)
  • Player owned shops and chest shops.
  • Item frame shops.
  • Showcase style item displays.
  • Localization.
  • GUI Editor for easy manipulation of price settings.
  • Price floor, price ceiling, static pricing, initial pricing, sales tax, purchase tax, unlimited stock option and much more.
  • Dynamic tax rates. (Rich players can be taxed more than poor ones.)
  • Supports MySQL and SQLite.
  • Allows the creation of an unlimited number of economies, which allows for economically competing towns, kingdoms, factions, or other groups.
  • Supports command-free economies using transaction signs.
  • Price information, history, and more can be displayed on automatically updating information signs.
  • Price update notifications for any or all items.
  • Experience and enchantment trading.
  • When a player enters and leaves a shop, HyperConomy displays a customizable message.
  • Nearly everything can be changed while the server is running.
  • Unwanted features can be disabled.




Versions and Development Builds

  • Recommended builds are marked with [RB] and are generally thought to be stable and bug free.
  • Builds marked as [Beta] are as bug free as possible, but often have large code changes which may result in the appearance of new bugs.
  • Builds marked as [Dev] are development builds that I've decided to upload to BukkitDev. I may upload dev builds on occasion to provide easy access because Bukkit staff does not allow linking to development builds.
  • Development builds may contain bugs as I work on releasing a new [Beta] build. They may also contain fixes for bugs found in [Beta] builds. Use these builds if you're looking for a bug fix, or would like to try out a new feature I've just added. Also, feel free to search for bugs in the development builds. Any help with testing is greatly appreciated!
  • Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
  • The latest development builds can be found here.



  • HyperMerchant
    HyperMerchant is a graphical user interface for your players to use to interact with HyperConomy shops.
    It is also includes the ability to easily create Citizens npc shopkeepers for your HyperConomy shops.
  • HyperConomy Web
    HyperConomy Web creates a web page for HyperConomy, displaying information about all shops, items, and price history. The web page appearance can be customized to fit your server.


New Features, Bugs, Problems, etc.

  • If you have a question, or find a bug, first check the FAQ. I will try to include as many helpful questions and answers as possible.
  • If the FAQ doesn't help, don't hesitate to post your question or make a ticket.
  • If you do find a bug, please include which version of HyperConomy you're using, the full error message or stack trace (if there is one), the version and type of Minecraft server you're running, and an explanation of how to reproduce the bug or what causes the bug.





  • pr4xt3roy -> CapricaTown
  • Baamoink -> Mantle-Craft
  • Thanks as well to all of the other donors that haven't requested a listing here.


Basic Tutorial

New tutorial videos to come...

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

  • Avatar of RegalOwl RegalOwl Aug 29, 2015 at 22:47 UTC - 0 likes

    @galacticwarrior: Go

    Ok, could you try dev build #525? Hopefully your bug is fixed.

  • Avatar of RegalOwl RegalOwl Aug 25, 2015 at 14:21 UTC - 0 likes

    @galacticwarrior: Go

    I believe I see the problem. I'll work on a new dev build and get back to you when it's ready.

  • Avatar of RegalOwl RegalOwl Aug 25, 2015 at 05:44 UTC - 0 likes

    @pr4xt3roy: Go

    That feature was removed. I'll update the wiki. It added a lot of unnecessary complexity and potential bugs. Now that you can buy and sell enchantments onto books those can simply be placed in the chests and bought instead of transferring enchantments between items.

  • Avatar of galacticwarrior galacticwarrior Aug 24, 2015 at 15:45 UTC - 0 likes

    @RegalOwl: Go

    Hey there, Sorry for the late response.

    It appears the violating item(s) so far seem to be items from CrackShot, such as our blast grenades.

    Do you need a screenshot of one?

    Regards, galactic

  • Avatar of pr4xt3roy pr4xt3roy Aug 20, 2015 at 15:29 UTC - 0 likes

    According to https://github.com/RegalOwl/HyperConomy-Documentation/blob/master/Wiki/Shops/Chest%20Shops.creole I should be able to buy enchantments that should be applied directly on the item Im holding from chest shops.

    Chest shops allow the purchase of enchantments but not the sale. This is simply to avoid commands and because it is very unlikely that a chest would have a matching combination of items/enchantments. When purchasing enchantments, you must hold the item you want to enchant and then right click on the enchanted item that you would like to purchase the enchantments from. This will automatically purchase all enchantments from the selected item and place them on the item that you're holding.

    That was working fine on version v0.974.57

    However, we are now using Version 0.975.5 and its not behaving the same way anymore.

    When Im holding a pickaxe and right clicking on an enchanted book or enchanted pickaxe, I buy the enchanted book or the enchanted pickaxe, but the item im holding does not get enchanted. I didn't find anything relevant in the config.yaml. I also checked all the Wiki pages and all the ChangeLogs of every release between those two versions... All I found relevant was:

    • Enchantments can no longer be purchased on stacks of books
    • Added depth strider enchantment and removed a few items that can no longer be obtained

    Was this behavior changed (and the wiki needs to be updated) or is there perhaps a bug?


    -- pr4xt3roy [ Survival / Strong Anti-Grief / Build / Make Friends ]
    Minecraft Server IP: CapricaTown.net

  • Avatar of RegalOwl RegalOwl Aug 20, 2015 at 15:20 UTC - 0 likes

    @galacticwarrior: Go

    This looks like a bug, but I'll need more information in order to find it. I suspect there is some item that HyperConomy can't handle properly. Whenever this happens next could you take a look at the affected player's inventory? There should be one or more items that when in inventory cause this error. If you remove the item the error should go away. If you let me know what item causes this I can work on a fix.

    Last edited Aug 20, 2015 by RegalOwl
  • Avatar of galacticwarrior galacticwarrior Aug 19, 2015 at 19:28 UTC - 0 likes

    Hey there,

    We've been using HyperConomy for a while now but we've ran into an issue we simply can't solve. For some players, commands simply do not work. When a command is executed, for example /hs, nothing happens and no messages are sent in chat. The errors are in the pastebin link below:


    It only seems to affect certain players which become affected randomly. After trying out different versions, tinkering with the config and ultimately wiping the whole MySQL database, plugin data and reinstalling everything, it still seems to affect the same few people while it's fine for the rest. I'm stumped now and not sure what to do. Is it on our side?

  • Avatar of RegalOwl RegalOwl Aug 19, 2015 at 18:48 UTC - 0 likes

    @Dutch_Boy: Go

    What sort of sale is it and is it in all situations?

  • Avatar of RegalOwl RegalOwl Aug 19, 2015 at 18:48 UTC - 0 likes

    @BlockBert: Go

    Not currently. Adding items by linking a chest seems like a good idea though. I can look into that.

  • Avatar of BlockBert BlockBert Aug 16, 2015 at 19:20 UTC - 0 likes

    Is it possible to configure HyperConomy so that the players just drop items they want to sell in a chest and then those items appear in an NPC inventory at specified server shop location with a dynamic pricing system? I want an economy system which is as simple to use as possible.


Date created
Mar 29, 2012
Last update
Mar 04, 2015
Development stage
  • enUS
  • frFR
  • ruRU
GNU General Public License version 3 (GPLv3)
Curse link
Recent files