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...
Comments
-
regal_owl_ Owner
-
benjamminfrankmon Ticket Manager
-
View User Profile
-
Send Message
Posted Jul 11, 2014@shmancelot I already tried this command but it's not removing my items for some reason? Am I doing something wrong?
-
View User Profile
-
Send Message
Posted Jul 9, 2014@ShadowWolfAlpha
Ok, new dev build is out for HyperConomy Web. It should be compatible with the latest dev build of HyperConomy.
-
View User Profile
-
Send Message
Posted Jul 9, 2014Hello,
I am using version v0.974.3 and I get the following error when using the /browseshop command:
Any ideas?
I tried upgrading to v0.974.54 but it makes the server crash on startup. I am using Spigot-1542 (released on July 8th 2014). I do not mind staying on v0.974.3 if the browseshop can be somehow fixed. I am sure other people have it working fine.. I bet it's something to do with my config, right?
-
View User Profile
-
Send Message
Posted Jul 9, 2014Hi, just thought I'd let you know that build #419 is throwing a console error, although it doesn't seem to adversely affect any gameplay:
http://pastebin.com/pL1eb2hH
Also, your work on this economy plugin is fantastic. It's really great to see how it has become such a full-featured economy.
-
View User Profile
-
Send Message
Posted Jul 9, 2014@ryanthemagi
Give it a try with bPermissions just to be sure. If it's not that I can check some other things.
@unrivaledneo
The stock level that needs to be reached isn't based on a setting, it varies depending on what an items settings are. Basically, it changes to dynamic mode whenever the dynamic price is less than or equal to the initial price. This depends on the median, the value, and the stock level.
-
View User Profile
-
Send Message
Posted Jul 9, 2014Was looking into the configs unless im just blind but how would you set it up so items dont have to reach 5k stock to start the dynamic pricing?
-
View User Profile
-
Send Message
Posted Jul 9, 2014@shmancelot
Yes, it is being done through hypermerchant. I am using 1.52dev of HM and 974.54dev of HC.
@RegalOwl
It was tested with a non-OP user to no avail. However, we are using PEX so perhaps that is the issue.
-
View User Profile
-
Send Message
Posted Jul 8, 2014@ryanthemagi
There are several factors that may be involved. I just tested it and it works fine for me and I think the shop permissions code should be pretty solid. Here are some possibilities:
1. The permissions will affect OP's differently since they get the hyperconomy.* permission which includes the hyperconomy.shop permission. Because of this you will have to explicitly deny shop permissions for any OP. (Or anyone with the hyperconomy.shop permission) This can be confusing when you're trying to test permissions.
2. What permissions plugin are you using? I've seen many people have trouble with PermissionsEx.
3. The permissions are applied in order of specificity. If a player is denied hyperconomy.shop.[name of shop].buy, they should not be able to buy there no matter what other permissions they have. The more specific permission will override more general ones. This could also be confusing the other direction. If a player has hyperconomy.shop.[name of shop].sell and hyperconomy.shop, they will still be able to buy from the shop because hyperconomy.shop gives them buy permission and it hasn't been explicitly denied.
Let me know if it was one of those things.
EDIT: Also, these permissions only apply to an entire shop for selling/buying. You can't give permissions for specific items. To block items from being sold use /ss ban or /ss allow. (Or change the trade status in player shops.)
-
View User Profile
-
Send Message
Posted Jul 8, 2014@ryanthemagi
Are your players primarily using commands or the HyperMerchant menu to interact with shops? If the menu, which versions are you using? It is possible that permissions support in HyperMerchant is not up to date with HyperConomy's current implementation.
-
View User Profile
-
Send Message
Posted Jul 8, 2014I'm having a lot of trouble getting items to be buy only or sell only. I turned per-shop-permissions to true, yet my players can still buy/sell anything in the shop. Theoretically, don't they need the permission node hyperconomy.shop.[name of shop].sell or .buy to be able to buy/sell? I even tried using negative permission nodes to no avail. Please advise.
-
View User Profile
-
Send Message
Posted Jul 7, 2014@cecustom
This was a bug. It should be fixed in dev build #419. Let me know if you find anything else!
-
View User Profile
-
Send Message
Posted Jul 7, 2014@ShadowWolfAlpha
I'll see if I can get a new build out for HyperConomy Web soon. I think it just needs a couple of minor changes.
As far as the error, do you know how to reproduce it? It's a strange error. I'd recommend trying the latest build to see if you get any different results.
-
View User Profile
-
Send Message
Posted Jul 7, 2014We are currently testing this mod for our server but found an issue I need help with. Is there a way that we can turn off remote access to the user stores. You can add and remove store items from anywhere. This creates a huge exploit, as the store can be used just like an ender chest. I am hoping I just missed something in the config.yml.
Just like a chest, the player should have to be at the shop to add things to the shop; or at least have it be an option. Something we can set per player.
Thanks for any help you can offer on this issue.
-
View User Profile
-
Send Message
Posted Jul 4, 2014Also getting this Error.Log
HyperConomy[0.974.54], CraftBukkit[git-Bukkit-1.7.9-R0.2-1-ga6e0bfd-b3095jnks (MC: 1.7.9)], [2014-07-04 18:30:29.606] java.lang.NullPointerException at regalowl.hyperconomy.display.TransactionSign.onPlayerInteractEvent(TransactionSign.java:161) at sun.reflect.GeneratedMethodAccessor83.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source) at java.lang.reflect.Method.invoke(Unknown Source) at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:292) at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62) at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.java:501) at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:486) at org.bukkit.craftbukkit.v1_7_R3.event.CraftEventFactory.callPlayerInteractEvent(CraftEventFactory.java:216) at net.minecraft.server.v1_7_R3.PlayerInteractManager.dig(PlayerInteractManager.java:103) at net.minecraft.server.v1_7_R3.PlayerConnection.a(PlayerConnection.java:536) at net.minecraft.server.v1_7_R3.PacketPlayInBlockDig.a(SourceFile:53) at net.minecraft.server.v1_7_R3.PacketPlayInBlockDig.handle(SourceFile:8) at net.minecraft.server.v1_7_R3.NetworkManager.a(NetworkManager.java:157) at net.minecraft.server.v1_7_R3.ServerConnection.c(SourceFile:134) at net.minecraft.server.v1_7_R3.MinecraftServer.v(MinecraftServer.java:667) at net.minecraft.server.v1_7_R3.DedicatedServer.v(DedicatedServer.java:260) at net.minecraft.server.v1_7_R3.MinecraftServer.u(MinecraftServer.java:558) at net.minecraft.server.v1_7_R3.MinecraftServer.run(MinecraftServer.java:469) at net.minecraft.server.v1_7_R3.ThreadServerApplication.run(SourceFile:628)
-
View User Profile
-
Send Message
Posted Jul 4, 201404.07 14:07:19 [Server] INFO org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: regalowl/hyperconomy/DataLoadListener 04.07 14:07:19 [Server] INFO [14:07:19 ERROR]: Could not load 'plugins/HyperConomy_Web.jar' in folder 'plugins'
I can't get the HyperConomy web thingy to work :(
-
View User Profile
-
Send Message
Posted Jul 2, 2014@Karim_NexusNode
@shmancelot
Soon, I'll hopefully have the commands organized into smaller subcategories so it's easier to find the new commands.
@pepper82 Check the ChestShops page under manual if that's the sort of shop you're thinking of. Other than that, signs/chests don't currently interact with player shops. I'll probably be changing that in the future though.
In regards to HyperConomy, the only real advantages of MySQL are reliability and ease of data viewing/manipulation. The SQLite database can be edited by various tools but you may run into problems if the server is running since you might lock it and prevent HyperConomy from functioning properly. MySQL, on the other hand can be safely viewed and edited easily through a tool such as PhpMyAdmin. In general, from what I've seen, MySQL is much easier to work with since it is fully concurrent and can be edited by multiple things at the same time. This would also be useful if you'd like to integrate HyperConomy's database with some other program.
SQLite, on the other hand, should probably be faster than MySQL since it has less overhead. It's still not technically a flat file, but closer to it than MySQL. It also requires no setup which is a big plus.
If you're getting 100 players online at the same time I would recommend MySQL just because it's very reliable and you'll be able to view/edit the database without any risk.
@shmancelot The only part of the database system that's run on the main thread is adding entries to the queue. This should take an insignificant amount of main thread time. Then a secondary thread runs every 30 seconds or so and writes all of the accumulated changes to the database in a single transaction. Putting everything into a single transaction makes it far faster than writing changes in real time.
-
View User Profile
-
Send Message
Posted Jul 2, 2014@pepper82
If you are "good" at sql, then there could be some benefit of using mysql, especially if you use mysql with some of your other plugins. It is more complex, so the potential to have problems is greater.
SQLite should perform admirably on a 100 player server. All the HyperConomy queries are queued up and made by the main thread (I believe, correct me if that's not the case RegalOwl =D ).
-
View User Profile
-
Send Message
Posted Jul 2, 2014Is there any tutorial to make playershops with signs / chests?
And would you recommend to use mysql on a 100 player server or will there be more problems with mysql than with flatfile / sqlite?
-
View User Profile
-
Send Message
Posted Jun 30, 2014@Karim_NexusNode
As you suspect, the commands have changed in later version of HyperConomy. There were just so many, so they have now been better organized in to subcommands.
Please have a look at the new commands page
see the /hcdelete command for item removal.
-
View User Profile
-
Send Message
Posted Jun 30, 2014Hello there RegalOwl! First of all, I love your plugin HyperConomy as it is the base tool that runs my, you guessed it, economy server. Now I have been having some problems unfortunately regarding the commands. Alright, I am not sure if this is normal or not in your latest Jenkins build but there is no longer an items.yml file in my configuration folder. I tried all the new builds, deleted the folder and still no luck with that as now I am assuming it has been discontinued. This is a problem for me because I have no clue how to change the price for my items and their values. Speaking of items, I can use the /ai command to add items altough the /ri or /removeitem command doesn't seem to be working for me and bukkit doesn't recognize it "Unknown Command...." That's not the only command it doesn't recognize either there are plenty others such as /setstock and more. I am not sure if the commands changed or what not but looking at the help documents both here and on my server don't seem to be working and I get the same results. I really need this plugin for my server and really, everything else seems to be functioning correctly except for the above mentioned. Although one other thing to note is that /hc works but /hc reload or anything tagged on to /hc (argument) doesn't do anything its just blank when you run the command. I can't reload or disable HC etc... Much help is appreciated, Thank You! P.S: I am also running HyperMerchant which seems to be working just fine.