HyperConomy
Getting Started|Commands|Permissions|FAQ|How To|Troubleshooting
______________________________________________________________________________
Introduction
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 item displays. Read below or check out the wiki for more information.
New Chest Shops:
______________________________________________________________________________
Features
- 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 and chest shops.
- 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.
______________________________________________________________________________
Requirements
- None. If you'd like to integrate with an existing economy plugin using Vault, you will need the following: Vault and an economy plugin such as BOSEconomy, iConomy, or Essentials Economy
______________________________________________________________________________
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.
______________________________________________________________________________
Add-ons
- 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.
______________________________________________________________________________
Donate
- If you'd like to send me a donation for the time and effort spent making this plugin, you can do so here: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=AMK9AR4CVKEJJ
- To those who have donated: thank you very much for the support. If you'd like to be listed as a donor here just send me a message.
______________________________________________________________________________
Donors
- 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...
@Blackyvk
Performance should be increased somewhat in the latest dev build. Let me know if it helps on your server.
Hi there,
I love this plugin and think it's a work of art. Really easy to get going and feature complete, defs worth a donation! However there seems to be a issue with multi server setups not syncing the currency amount. Currently I have Hyperconomy using a mysql backend and added the servers by ip but it doesn't sync using both localhost and 127.0.0.1 (same machine). There are no explicit errors, it simply doesn't work but i can include my config for reference. I have consulted your documentation on the matter and believe it is all in order.
Curious why the ip addresses are needed, i imagine just having it all sync to the database backend would simplify it.
If i missed something let me know and i'll stand corrected.
Kind Regards,
P.S reference link: https://github.com/RegalOwl/HyperConomy-Documentation/blob/master/Wiki/General%20Information/Multi-server.creole
EDIT: forgot the version and such, was posting late at night
Version: HyperConomy v0.975.6
MC Server Version: MC 1.9 (Spigot 1.9 R 0.1 SNAPSHOT)
Reproduction: Simply attempt to configure multi server using the provided documentation
after running those commands the potions were working. The icons in the shop were what had me think they still weren't but once bought they are fine. :) The eggs though remain an issue I assume its the same issue that may have caused potions to stop not sure though. Thank you
@dpheonix68
Did you run the command /hcdata updateitems? I tested most of the potions as working. If you've already run that command along with /hcdata importmissing, let me know which potion you're having trouble with and I'll take a look at it.
I'm not sure about the spawn eggs. I'll take a look and get back to you.
@dpheonix68
The spawn eggs now store their ids in a NBT tag. It is a nuisance for now, because spigot/bukkit does not yet have a reliable way to access these tags. At least, that is my understanding of the situation.
Hi tried out the latest dev build #8 the potions have the icons now but still no effects. treats it like bottles of water. It is progress though keep up the good work. I'm not sure what 1.9 changed but it seems like a headache
revision: the icons seem to show them as water and no effects however once bought it seems to assign it. Will try out the eggs and see what happens.
2nd revision: Seems to still have the issue with spawn eggs. In the menu all the eggs look white but they have the mobs name. After you buy one though it goes in your inventory as a white egg that just says "spawn". It does not let the animal spawn it seems like a dummy egg. The same thing that changed potions might have changed the eggs as well.
@galacticwarrior
Ok, the issue is fixed in the latest Spigot/Craftbukkit. They fixed it quickly.
@galacticwarrior
Thank for the additional info. I was able to reproduce it. It appears that this may be an issue with Spigot/Craftbukkit. I've reported it and am waiting to see what the Spigot team says.
@RegalOwl
Hey there, It only seems to occur with potions spawned in with commands. For example, a potion spawned with /give {player} potion 1 {Potion:"swiftness"} which is in the player's inventory will prevent him doing any shop-related commands. In this instance these commands are added to the starter kit since Essentials does not yet support the new potions, and are executed when a new player joins a server.
Thanks!
@Blackyvk
I may see a way to increase performance. I'll let you know if I find a good way to do it.
@galacticwarrior
I haven't been able to reproduce that error. What sort of potion causes it? I may be able to fix it regardless, but knowing which potion may help.
@RegalOwl
no, just hyperconomy for just few frameshops and transaction signs..
Today we tried 3 people do the same thing, rightclick a frameshop and buy items like crazy for like 30 secs, tps went under 18.
@RegalOwl
Many thanks, the commands work perfectly.
However, at times there is an internal server error when someone attempts to sell or buy something. It only happens if there's a potion in their inventory.
Here's the log: http://pastebin.com/it2XN8jj
Thanks
@Blackyvk
I can pretty much guarantee the lag isn't due to logs. HyperConomy uses an asynchronous thread to write to the database so logging can't easily slow the main thread. It also pools writes into larger writes so that it only writes to the database periodically.
I can run a profiler to see where the slowdown is. You're using HyperMerchant, right?
is there a way to disable all kind of logs ? i dont know if thats the reason but, I'm switching servers and this one is less powerful, whenever I keep my right click pressed and buy 64 items 1 by 1, my tps drops from 19.9 to 19.3, if thats just 1 player and just 64 items bought, i dont know how will it be with more players doing it.
http://i.imgur.com/SM301B0.png
@galacticwarrior
A new build is out with fixed potions. After installing it just run /hcdata updateitems and then /hcdata importmissing to update items and add new 1.9 items. If you have multiple economies run it for each one /hcdata updateitems (economy)
figured out issue was null items being added. exported csv and removed then imported.
Also in addition to the potions not working as previously reported by another user the monster eggs all show up as white and say spawn when bought.
that was a different error. this is the one relating to the item. SQL write failed 0 time(s). The failing SQL statement is in the following brackets: [INSERT INTO hyperconomy_objects (MAXSTOCK, INITIATION, VALUE, DISPLAY_NAME, STATIC, STOCK, NAME, STATICPRICE, FLOOR, STARTPRICE, CEILING, DATA, ALIASES, MEDIAN, TYPE, ECONOMY) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)] Parameters: 1000000.0], [true], [500000.0], [elytra], [false], [0.0], [ELYTRA_0], [1000000.0], [0.0], [1000000.0], [1000000.0], [maxDurability,0;amount,1;maxStackSize,1;material,ELYTRA;data,0;itemMetaData,lore[0]{0}displayName[0]{0}enchantments[0]{0};durability,0;metaType,ITEM;isBlank,false;], [elytra,], [10.0], [ITEM], [default java.sql.SQLException: [SQLITE_CONSTRAINT] Abort due to constraint violation (columns NAME, ECONOMY are not unique) at org.sqlite.DB.newSQLException(DB.java:383) at org.sqlite.DB.newSQLException(DB.java:387) at org.sqlite.DB.execute(DB.java:342) at org.sqlite.DB.executeUpdate(DB.java:363) at org.sqlite.PrepStmt.executeUpdate(PrepStmt.java:85) at regalowl.hyperconomy.simpledatalib.sql.DatabaseConnection.write(DatabaseConnection.java:50) at regalowl.hyperconomy.simpledatalib.sql.SQLWrite.saveQueue(SQLWrite.java:163) at regalowl.hyperconomy.simpledatalib.sql.SQLWrite.shutDown(SQLWrite.java:151) at regalowl.hyperconomy.simpledatalib.sql.SQLManager.shutDown(SQLManager.java:44) at regalowl.hyperconomy.simpledatalib.SimpleDataLib.shutDown(SimpleDataLib.java:42) at regalowl.hyperconomy.HyperConomy.disable(HyperConomy.java:229) at regalowl.hyperconomy.command.HcCommand.onCommand(HcCommand.java:36) at regalowl.hyperconomy.bukkit.BukkitConnector.onCommand(BukkitConnector.java:114) at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:141) at org.bukkit.craftbukkit.v1_9_R1.CraftServer.dispatchCommand(CraftServer.java:645) at net.minecraft.server.v1_9_R1.PlayerConnection.handleCommand(PlayerConnection.java:1342) at net.minecraft.server.v1_9_R1.PlayerConnection.a(PlayerConnection.java:1177) at net.minecraft.server.v1_9_R1.PacketPlayInChat.a(PacketPlayInChat.java:45) at net.minecraft.server.v1_9_R1.PacketPlayInChat.a(PacketPlayInChat.java:1) at net.minecraft.server.v1_9_R1.PlayerConnectionUtils$1.run(SourceFile:13) at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) at java.util.concurrent.FutureTask.run(Unknown Source) at net.minecraft.server.v1_9_R1.SystemUtils.a(SourceFile:45) at net.minecraft.server.v1_9_R1.MinecraftServer.D(MinecraftServer.java:721) at net.minecraft.server.v1_9_R1.DedicatedServer.D(DedicatedServer.java:400) at net.minecraft.server.v1_9_R1.MinecraftServer.C(MinecraftServer.java:660) at net.minecraft.server.v1_9_R1.MinecraftServer.run(MinecraftServer.java:559) at java.lang.Thread.run(Unknown Source)
also I cant seem to set a sell price.
getting a weird error when 1.9 items are added. it stops the shop from loading and causes a right click npc event issue. in the error logs for hyperconomy it shows this error but the values are filled from what I can see. we use essentials economy.
HyperConomy[2016-03-14 10:55:50.163] SQL write failed 1 time(s). The failing SQL statement is in the following brackets: [INSERT INTO hyperconomy_players (SALT, X, Y, Z, UUID, WORLD, ECONOMY, NAME, BALANCE, HASH) VALUES (?,?,?,?,?,?,?,?,?,?)] Parameters: ], [-28.858961474086662], [64.0], [-1.2941857631819733], [baf37609-61ad-43bb-acdf-829361f57489], [phantom], [default], [Progwd], [0.0], [ java.sql.SQLException: [SQLITE_CONSTRAINT] Abort due to constraint violation (column UUID is not unique) at org.sqlite.DB.newSQLException(DB.java:383) at org.sqlite.DB.newSQLException(DB.java:387) at org.sqlite.DB.execute(DB.java:342) at org.sqlite.DB.executeUpdate(DB.java:363) at org.sqlite.PrepStmt.executeUpdate(PrepStmt.java:85) at regalowl.hyperconomy.simpledatalib.sql.DatabaseConnection.write(DatabaseConnection.java:50) at regalowl.hyperconomy.simpledatalib.sql.SQLWrite$WriteTask.write(SQLWrite.java:120) at regalowl.hyperconomy.simpledatalib.sql.SQLWrite$WriteTask.run(SQLWrite.java:113) at java.util.TimerThread.mainLoop(Unknown Source) at java.util.TimerThread.run(Unknown Source)
I can send the db file if you like or if you have a new db file with all the new 1.9 items that would be even better.
@RegalOwl
I'm glad to hear there will be an update! This plugin looks great!
I really appreciate people like yourself, thanks for making this!