HyperMerchant
I will no longer be supporting this plugin. I can't find the time or motivation and I have moved on to Sponge for my personal servers. If anyone is interested in forking this, go right ahead and I will link to your project.
Thanks to everyone who reported a bug or donated their time or cryptocurrency.
Introducing HyperMerchant
HyperMerchant is a shopmenu GUI and NPC shopkeeper plugin for HyperConomy shops.
HyperConomy is the premier fully dynamic minecraft shop plugin. It is loaded with super unique features and is the perfect shop/economy plugin for RP, Faction, Freeplay, Towny, and Hybrid servers; Or any other server that is in need of a superb economy or shop plugin.
HyperConomy is most likely compatible with whatever economy plugin you are already using; And if you don't have an economy plugin already, HyperConomy has one built in.
So what is a fully dynamic shop plugin? It means that prices change automatically based on what your players buy and sell, much like they would in a real economy. This functionality can be disabled if you want prices to remain the same. Check out HyperConomy now.
HyperMerchant simmers alongside and together they become a super sauce, packed with vitamin awesome!
To get started, download the correct versions of each program. Details can be found in the compatibility guide.
Follow the links below to learn more about configuring and using HyperMerchant.
Commands and Permissions
Configuration
Menu Buttons
Compatibility
How To
Languages
HyperMerchant Features
Coming soon in version 1.58
Language support. Currently available in the latest development build.
- Simple to use Inventory-style shop menus.
There are helpful tooltips in the shop menu to guide new players.
Purchase 1, 8, or a full stack of items in a single click.
To sell items, simply drag them from your inventory window to the shop window. - Management Menu for player shops. Players can use /mmenu while staning in their shop, or shift+click their shopkeeper NPC.
- NPC's are not required, you can enjoy the shop interface with /shopmenu and /remotemenu commands.
- Assign many NPC's around your world to the same shop.
- Convenient commands to quickly set NPC greetings, farewells, offduty, and service denial messages.
- NPCs can be toggled to offduty mode to temporarily close shops.
- Players who own a player shop can be "clicked on" to open their shop menu.
- Player shop owners can toggle themselves "/onduty" and you can limit them to only being "open" while inside their shop.*
- Your players can /hire their own NPC shopkeepers (clerks) for a configurable "comission percentage".
- You can set up NPCs who are ready to be hired by a player to work in that player's shop.
- You can set up shops to be rented by players with NPC shopkeepers included.
- Configure the Interface Icons in the shopmenu gui by editing "menubuttons.yml".
- Sort menu by name, material, sell price, buy price, or stock amount. (donated for by hellphish)
- Hide items with zero stock. (donated for by hellphish)
Requirements
See the compatibility page for a breakdown of Bukkit + HyperConomy + HyperMerchant + Citizens matchups.
HyperMerchant is compatible with Java 6.
You must have Citizens2 installed to use NPC shopkeepers. You do not need Citizens if you only want to use the shop menus.
Development Builds and Source Code
Development builds are available at the continous integration server.
Development builds have not been verified safe by Bukkit staff. Use at your own risk.
Get the source for HyperMerchant on github.
Donations
I now accept donations in cryptocurrency. If you message me I will happily honor you as a donor on this page.
DogeCoin:
DJHgjbD2qpeWstJxBtyzEVetPSeGiQN2Zt
BitCoin:
1EwTvDRXu9nERfzdFxWZMV8y5ct76e1DPT
SHORT VIDEO TUTORIAL
https://www.youtube.com/watch?v=afvurpJJC6g
Also, you can direct your players to this video on how to shop in HyperConomy shops via HyperMerchant menus or HyperConomy commands:
Shopping Tutorial: http://www.youtube.com/watch?v=Ck4gr-QrjG8
Video is courtesy of JacksmackDave. Thank you!
Special Thanks
Thanks to Tux2 for getting me started with this bukkit plugin tutorial.
Thanks to nisovin for sharing his menu code in this forum post.
And especially thanks to RegalOwl for developing the featurefilled HyperConomy plugin. It is the machine and HyperMerchant is just an interface built upon it.
Much credit also goes to the developers of Citizens, whose plugin provides all the npc interaction.
Reporting Bugs
If you are having a problem, there is a good chance it has never been reported yet. If I don't hear about the bug, I probably won't ever know about the bug, because I don't run a populated server to test out every feature of HyperMerchant.
Please take the time to report any issue, it will be a help to the community and your own server. I usually check this page each day. Thanks! =)
-
View User Profile
-
Send Message
Posted Feb 25, 2014I forgot to thank you for adding the blacklist.yml earlier, so here is my thanks for adding that as a feature!
To label another caveat, the GUI doesn't play nice when players want to sell & buy XP.
Keep up the great work! :)
-
View User Profile
-
Send Message
Posted Feb 25, 2014HyperMerchant dev build #44 si just released. It should be compatible with HyperConomy dev build #356 and above. Get it from link above in section "Development Builds and Source Code"
-
View User Profile
-
Send Message
Posted Feb 24, 2014@ryanthemagi
Enchanted books are not in the database. Players can sell the enchantment from the book, or buy an enchantment onto the book.
-
View User Profile
-
Send Message
Posted Feb 24, 2014I'm wondering why I can't stock my NPCs with enchanted books. When I try to do so, it renders the error "Sorry, that item or enchantment is not in the database."
-
View User Profile
-
Send Message
Posted Feb 16, 2014@guruserver
If you are using version 1.4 Edit the menubuttons.yml file. A list of valid material names is here http://jd.bukkit.org/dev/apidocs/org/bukkit/Material.html
-
View User Profile
-
Send Message
Posted Feb 16, 2014Is there a way of allowing us to customize the item used as buttons in the shop panel? like changing the lava and water to different items
-
View User Profile
-
Send Message
Posted Feb 15, 2014@JacksmackDave
Are you using the latest version of HyperMerchant? This bug should have been fixed in version 1.4[Beta]. Please let me know and I will investigate it more closely.
-
View User Profile
-
Send Message
Posted Feb 15, 2014Stone brick seem to all show the same sell price for me. When I drag the items into the shop it sells for the right amount but when you hover over the item it shows the base stone brick sell price which is very low compared to the others.
OH, and thank you for posting my video!
-
View User Profile
-
Send Message
Posted Feb 11, 2014@JacksmackDave
Thanks mate! This video could indeed be helpful for players who are not accustomed to the features found in HyperConomy and HyperMerchant. I've placed a link on this page.
Regarding the "ghost item" artifact bug seen in the video: that issue was fixed by Mojang in the 1.7.4 minecraft client. Try switching to the latest version in your launcher, the menus are much smoother =)
-
View User Profile
-
Send Message
Posted Feb 10, 2014I made a tutorial video for my server that covers much of hypermerchant, you may use it if you think it gives people better information.
http:www.youtube.com/watch?v=Ck4gr-QrjG8
-
View User Profile
-
Send Message
Posted Feb 8, 2014Alright latest 1.4-dev build now includes "npcblacklist.yml" You can add names and npc types that you don't want players to use for their clerks.
-
View User Profile
-
Send Message
Posted Feb 8, 2014@Baamoink
There aren't permissions for that yet, but I can see the issue. I will add a "types.yml" file and "names.yml" file so you can disallow those npcs.
That will effect players who have "hypermerchant.clerk" permission. Players with "hypermerchant.manage" permission will be able to assign any name still.
-
View User Profile
-
Send Message
Posted Feb 8, 2014Started using this a few days ago after being a long time user of HyperConomy. Really love how much better integrated this makes the HyperConomy plug-in for players to use. My only issue I suppose is that players quite like making their clerks as the server staff, enderdragons, withers etc... x)
Are there permission nodes so that I can limit the clerks to certain mob types or player names?
-
View User Profile
-
Send Message
Posted Feb 6, 2014Big thanks to InsomniaCraft for testing the 1.4dev builds, and for requesting the "shop rental" feature. It's working pretty good now.
Anyone who wants to try it out get it from the development builds links above.
Your admins who have permission for the /hmerch commands can toggle a merchant as /forhire and then your players can hire them to work their shops.
Or even more conveniently, you can assign a merchant to a shop and then toggle the /rental command and your players can rent an already made shop with npc.
-
View User Profile
-
Send Message
Posted Jan 26, 2014@InsomniaCraft
Indeed the initial build was littered with little bugs. Thank you for trying it out!
I've squashed every bug I could find and if you don't mind, please try downloading version 1.4-dev again.
-
View User Profile
-
Send Message
Posted Jan 25, 2014Im getting flooded with errors when trying to use most of the clerk sub commands, I'm unable to create a player shop using the clerk command so I cannot test any further. Here is the error I receive when using /clerk setshop
http://hastebin.com/viyebalova.vbs
-
View User Profile
-
Send Message
Posted Jan 25, 2014@shmancelot
I just saw your message while checking the status of your plugin. Will be testing now and I'll report back. Thanks for the reply.
-
View User Profile
-
Send Message
Posted Jan 21, 2014Fixed a bug that was preventing players from selling enchants in version 1.31. Please download version 1.32 from the development builds link above if you are experiencing this issue.
-
View User Profile
-
Send Message
Posted Jan 20, 2014@InsomniaCraft
If you are up to it, try testing out the just now uploaded 1.4-dev version, available from the development builds link above. It has the new /clerk command, which is designed to be used by players, while the /hypermerchant command is for admins.
Check out commands and permissions page for more info.
Also there are two more configuration options related to this (though they aren't yet functional).
I haven't had a chance to test it yet, all I know is it loads up properly on my server.
I'll post again when the configuration options are working.
EDIT: one more thing, 1.4-dev requires HyperConomy dev build # 344 or greater.
-
View User Profile
-
Send Message
Posted Jan 19, 2014When would we be able to interact with npcs to simply rent one? I really love the idea, and the current player shop system with hypermerchant requires too many permissions for my players.