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...
-
View User Profile
-
Send Message
Posted Aug 11, 2014@dilbukon
Check the previous comment for info about median/value. I'll add what I said to the wiki.
If you're talking about server shops this can essentially be done with the /hcset command and creative mode. There is no inbetween permission like there is for player shops. Player shops have this functionality with /ms add and /ms remove.
I can look into maxstock for servershops. I started adding it a long time ago but ended up creating player shops instead. I'll see what it would take to finish it. Do you have some sort of setup that requires a server shop? If not I would suggest using a player shop instead since it has more features. You can set a shared bank account as the owner if needed as well. In the future I think the best thing might be to add an option to player shops which allows them to directly interact with their economy's stock like player shops. With that feature they could simply replace server shops.
The reason category removing/adding is absent from player shops is it can't work the same as it does for server shops. What needs to be added is category status changes for player shops, not allowing or disallowing trading. Allowing/banning does work for player shops but it is confusing because its a second admin set permission on top of the player set permissions. I'll see if I can add category status changes. I'll look into /ms status as well.
-
View User Profile
-
Send Message
Posted Aug 11, 2014@xs0lidus
You can think of it like this:
value = A price modifier. The higher the value, the higher the price at all stocks. median = The stock amount where the price will equal the value of the item. So if something has a median of 10000 and a value of 2, the price will be 2 when the stock is 10000.
Increasing the median will slow the rate of price change. However, to get the price you would like you may need to use a larger stock.
One thing HyperConomy can't currently do is shift the stock by some amount. I could look into adding this at some point.
The pricing formula is essentially price = value * (median/stock).
The true pricing formula which allows for partial items' price to be calculated accurately is price = (ln(starting stock) - ln(ending stock)) * median * value
-
View User Profile
-
Send Message
Posted Aug 11, 2014Is it possible to completely disable the Welcoming Message to your shop? If so, how can I do it? It is being spammed heavily when you are in a spawn region, and doesn't stop showing up in your chat until you leave the area.
-
View User Profile
-
Send Message
Posted Aug 11, 2014Can you add a config option that lets players buy and sell items even if they arnt in a shop? It would be really useful!
-
View User Profile
-
Send Message
Posted Aug 10, 2014Can you explain what value and median is?
It's not very well explained on the wiki...
Can you add a feature to take the items in the inventory of shops (without buying them)? We have a system where we allow certain trusted managers to take the items and transfer them into a real chest.
Also, why do we not have /maxstock for server shops? The database entry is shown in the sqlite file, but I can't find a command to set this value.
Is there any chance you could add that as well?
Could you add /ms status for the server shop and category adding/removing for player shops, please?
Thanks!
P.S. I'm not sure why convenient and great features of player shops and server shops are missing each other's features to begin with.
-
View User Profile
-
Send Message
Posted Aug 10, 2014That makes sense. Now I have one more problem, I'm really having trouble getting prices in the shop how I want them.
I'm using dynamic pricing, and here's what I'm trying to achieve:
Iron Sword with 100 stock should sell for $500
I have the ceiling set to $1000 and the floor set to $100, but these values are reached very quickly when buying/selling. It should only be $1000 when there is 1 or 2 left in stock, but instead it's that price with 20-30 stock.
What kind of value and median should I be using so the value increases/decreases more slowly?
-
View User Profile
-
Send Message
Posted Aug 10, 2014@xs0lidus
Currently you cannot change the display icons in the HyperMerchant menus.
However, each enchant icon does show one of the items that can recieve the enchant.
For example, axes and swords can be enchanted with sharpness. I used the axe for the icon because I think some people might not know you can enchant an axe with sharpness.
-
View User Profile
-
Send Message
Posted Aug 10, 2014Another question.
I want sale prices to be much lower than buy prices. Currently a diamond sword can be bought for 2500 and sold for 2400, I'd rather it sold for around 1200. What do I edit?
-
View User Profile
-
Send Message
Posted Aug 9, 2014@RegalOwl
I was not, didn't know they had changed.
Thanks!
-
View User Profile
-
Send Message
Posted Aug 8, 2014@xs0lidus
Are you looking at the new commands page? The item management commands all fall under /hcset in the new versions. /hcset stock, /hcset median, etc. /hcs for short also works.
-
View User Profile
-
Send Message
Posted Aug 7, 2014Commands are not working, well most of them. I cannot set stock, price, median, anything. I created a server shop just fine, but I am completely unable to manage it. Using latest HC dev build, Essentials 2.13.1, latest HyperMerchant build and latest beta build of bukkit. No console errors at all. In-game error is "Unknown Command. Type /help for help"
Any idea?
-
View User Profile
-
Send Message
Posted Aug 6, 2014@KingOfHunting
Are you running an old version? If it's several versions old the command would be /setstockall 0.
-
View User Profile
-
Send Message
Posted Aug 6, 2014@shmancelot
"invalid name"
-
View User Profile
-
Send Message
Posted Aug 5, 2014@RegalOwl
Decided to just wipe my database. Seemed to work. I'll let you know if I come across anymore issues. Thanks!
-
View User Profile
-
Send Message
Posted Aug 5, 2014@Jhwx
Try turning on debug mode in config.yml. It should put out messages as HyperConomy is starting to see where it is hanging up. Let me know what the last few output messages are. Sometimes they come out of order due to async threading.
If that doesn't help I could take a look at your database and provide a fix.
-
View User Profile
-
Send Message
Posted Aug 4, 2014@KingOfHunting
/hcset stock all 0
-
View User Profile
-
Send Message
Posted Aug 4, 2014How do you set the stock to everything to 0?
-
View User Profile
-
Send Message
Posted Aug 4, 2014@RegalOwl
Just did that. No error any more, but it freezes on [....HyperConomy is loading, please wait....] Anymore ideas? Thanks.
-
View User Profile
-
Send Message
Posted Aug 4, 2014@MrBrasta
That currently isn't possible. I'll see if I can setup a way to change the trade amount with a command.
-
View User Profile
-
Send Message
Posted Aug 4, 2014@Jhwx
Please try the latest development build and see if this issue is fixed.