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 Yani120 Yani120 Jul 18, 2016 at 16:02 UTC - 0 likes

    Everything's working great except the plugin stops me from being able to write on sign posts or any other plugins from being able to write on signposts.

    Last edited Jul 18, 2016 by Yani120: grammar
  • Avatar of broluigi broluigi Jul 13, 2016 at 18:03 UTC - 0 likes

    using spigot 1.10 R0.1 snapshot. If you need motivation, go to spigot and you'll find ways to monetize!

    hyperconomy-0.975.7-SNAPSHOT hypermerchant-1.6-dev

    Cannot set the merchant traited Npc. Cannot use the shop.

    13.07 14:03:13 [Server] INFO ... 15 more
    13.07 14:03:13 [Server] INFO at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) ~[spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at grokswell.hypermerchant.HyperMerchantPlugin.onCommand(HyperMerchantPlugin.java:283) ~[?:?]
    13.07 14:03:13 [Server] INFO at grokswell.hypermerchant.HyperMerchantCommand.<init>(HyperMerchantCommand.java:50) ~[?:?]
    13.07 14:03:13 [Server] INFO Caused by: java.lang.NullPointerException
    13.07 14:03:13 [Server] INFO at java.lang.Thread.run(Thread.java:745) [?:1.8.0_66]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.MinecraftServer.run(MinecraftServer.java:571) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.MinecraftServer.C(MinecraftServer.java:672) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.DedicatedServer.D(DedicatedServer.java:399) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.MinecraftServer.D(MinecraftServer.java:733) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.SystemUtils.a(SourceFile:45) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0_66]
    13.07 14:03:13 [Server] INFO at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [?:1.8.0_66]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.PlayerConnectionUtils$1.run(SourceFile:13) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.PacketPlayInChat.a(PacketPlayInChat.java:1) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.PacketPlayInChat.a(PacketPlayInChat.java:45) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.PlayerConnection.a(PlayerConnection.java:1183) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at net.minecraft.server.v1_10_R1.PlayerConnection.handleCommand(PlayerConnection.java:1348) [spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at org.bukkit.craftbukkit.v1_10_R1.CraftServer.dispatchCommand(CraftServer.java:646) ~[spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:141) ~[spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO at org.bukkit.command.PluginCommand.execute(PluginCommand.java:46) ~[spigot.jar:git-Spigot-6016ac7-10c10b3]
    13.07 14:03:13 [Server] INFO org.bukkit.command.CommandException: Unhandled exception executing command 'hmerchant' in plugin HyperMerchant v1.6-dev
    13.07 14:03:13 [Server] ERROR null
    13.07 14:03:13 [Server] INFO LoreCase issued server command: /hmerchant setshop Eco-Shop

    Also, bugs when i set the hypermerchant trait

    13.07 14:02:12 [Multicraft] Skipped 12 lines due to rate limit (30/s)
    13.07 14:02:09 [Server] WARN at net.minecraft.server.v1_10_R1.PlayerConnection.a(PlayerConnection.java:1183)
    13.07 14:02:09 [Server] WARN at net.minecraft.server.v1_10_R1.PlayerConnection.handleCommand(PlayerConnection.java:1348)
    13.07 14:02:09 [Server] WARN at org.bukkit.craftbukkit.v1_10_R1.CraftServer.dispatchCommand(CraftServer.java:646)
    13.07 14:02:09 [Server] WARN at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:141)
    13.07 14:02:09 [Server] WARN at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.Citizens.onCommand(Citizens.java:237)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.command.CommandManager.executeSafe(CommandManager.java:175)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.command.CommandManager.execute(CommandManager.java:87)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.command.CommandManager.executeMethod(CommandManager.java:152)
    13.07 14:02:09 [Server] WARN at java.lang.reflect.Method.invoke(Method.java:497)
    13.07 14:02:09 [Server] WARN at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    13.07 14:02:09 [Server] WARN at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    13.07 14:02:09 [Server] WARN at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.commands.TraitCommands.toggle(TraitCommands.java:157)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.commands.TraitCommands.addTrait(TraitCommands.java:64)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.npc.AbstractNPC.addTrait(AbstractNPC.java:89)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.npc.AbstractNPC.getTraitFor(AbstractNPC.java:232)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.npc.CitizensTraitFactory.getTrait(CitizensTraitFactory.java:137)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.npc.CitizensTraitFactory.create(CitizensTraitFactory.java:124)
    13.07 14:02:09 [Server] WARN at net.citizensnpcs.api.trait.TraitInfo.tryCreateInstance(TraitInfo.java:49)
    13.07 14:02:09 [Server] WARN at java.lang.Class.newInstance(Class.java:442)
    13.07 14:02:09 [Server] WARN at java.lang.reflect.Constructor.newInstance(Constructor.java:422)
    13.07 14:02:09 [Server] WARN at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    13.07 14:02:09 [Server] WARN at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    13.07 14:02:09 [Server] WARN at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    13.07 14:02:09 [Server] WARN at grokswell.hypermerchant.HyperMerchantTrait.<init>(HyperMerchantTrait.java:87)
    13.07 14:02:09 [Server] WARN java.lang.NullPointerException
    13.07 14:02:09 [Server] INFO LoreCase issued server command: /trait hypermerchant
    Last edited Jul 13, 2016 by broluigi


    Website: lorecase.org

  • Avatar of jaggy80 jaggy80 Jun 11, 2016 at 00:49 UTC - 0 likes

    <<reply 2816834>>

    Something changed with spawn eggs in 1.10.. all eggs in HC are showing as shulker spawn eggs with the same ID.  They now spawn eggs via command instead of damage value so /additem doesn't seem to work for them...

  • Avatar of jaggy80 jaggy80 Jun 07, 2016 at 01:57 UTC - 0 likes

    <<reply 2821779>>

    Yeah, all those commands are the old version... all the ones on the github wiki page are the commands you need :)

  • Avatar of TacoGerbil TacoGerbil Jun 06, 2016 at 21:37 UTC - 0 likes

    @jaggy80: Go


    under "Shop Management Commands".

    Now IF I go to the Wiki and look at the FAQ there... I see the option to BAN... Since a description of Banning isn't made I avoided as I did not realize it was the same as "remove" in relation to this plugin's use of the word.

  • Avatar of jaggy80 jaggy80 Jun 06, 2016 at 16:15 UTC - 0 likes

    <<reply 2816834>>

    So I've never programmed or compiled anything, but looked at your code because I wanted to make the buy price a lot higher than the sell price.  Found where to do it in your code and I was able to compile using ecilpse :)  That was not easy for a noob!

    Basically it was the "gap" feature I was wanting.. I made it 25% more expensive to buy all items because such a small gap made it easy to find ways to exploit if anything is priced even slightly wrong or if other plugins made certain items less rare, etc.  This is all I changed in BasicTradeObject.java
    totalPrice = (Math.log(getTotalStock()) - Math.log(getTotalStock() - amount)) * getMedian() * getValue() * 1.25;
    (just added * 1.25)

    I'm proud of myself! haha

  • Avatar of jaggy80 jaggy80 Jun 06, 2016 at 16:06 UTC - 0 likes

    <<reply 2821466>>

    Not sure where you're seeing /removeitems on the FAQ.  The FAQ page says to do:
    /ss select shopname
    /ss ban all

  • Avatar of TacoGerbil TacoGerbil Jun 05, 2016 at 23:43 UTC - 0 likes

    Thank you for the awesome plugin :)

    How on earth do you remove all items from a shop? Instructions and FAQ say removeitems all nameofshop....... but it says "unkown command"..... PLEASE!!! :)

  • Avatar of jaggy80 jaggy80 May 25, 2016 at 14:06 UTC - 0 likes

    <<reply 2816834>>

    Thanks so much for your help!  Would you ever consider accepting bitcoin donations?

    How would you like reports of item default price issues?  I found granite/diorite/andesite prices are too high when using components.  Since netherquartz is one of their components, it makes their price ~$30 each which is way too much when you can find them in huge veins.

    Default value for redsand is $15 which is too high if someone finds that biome, I think.

    Will the high CPU issue go away after it has 7 full days of history?

    Would a "Gap" option be a good idea?  Basically a setting for each item to increase price difference between buy and sell.  It seems players sell lots more than they buy and get money too fast.. when I increase stock/lower the value to decrease how much money they're making, it also makes the item (and component items) too cheap to buy.  Even a Global Gap setting may help solve this issue..  I guess I could just control it with high sales taxes though..

    I know you're busy so I don't expect any changes, these are just ideas :)

  • Avatar of RegalOwl RegalOwl May 23, 2016 at 22:20 UTC - 0 likes

    @jaggy80: Go

    For now the solution is either to disable the web page or reduce the time HyperConomy stores history. Had a lot going on recently and haven't had time to fix this yet, but it will be the next thing I work on.

    Thanks for pointing out the price issues. I can fix those in the defaults. Cake can't really be reverse crafted due to the bucket of milk. I can look into the others. I'm guessing some of them were converted to craftables in a recent update and were missed.


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