UltraTrader
Remember the donate button works, I could use some fresh Mt. Dew (I also except BitCoin (address below)
Information
Links | Description |
---|---|
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. | |
Jenkins | Development Downloads on CI provided by CloudBees |
GitHub | Source Code is hosted by GitHub.com by DemgelOpenSource group |
Website | WebSite is hosted by Github using maven-site |
Donate BitCoin | 17U5koSrxqYphGTSN4nZsd1sDr7Ti96XW4 |
Donating FUN | Some fun options for donating if you don't have money but want to help |
Citizens Wiki | My Wiki entry on Citizens 2 website |
Most Documentation will be on the Website
at http://ultratrader.thedemgel.com
Installation |
Commands | Permissions | Create A Trader | Localization | Configuration | Setting Shop Limits
UltraTrader and Citizens
UltraTrader doesn't require Citizens to run. But it does come ready to integrate out of the box, and most extensions do currently require the use of citizens. UltraTrader will work with Citizens to create NPC traders, but if you don't want to use Citizens, you can easily make blocks/signs into shops.
Buying and Selling
Some notes on buying and selling:
- Owners will always receive items from their shop for free (FREE)
- Owners can never sell items to their own shop. Items placed into a Traders buy screen will just be returned.
External Plugins
As a way to extend Ultratraders without bloating the already sizable amount of code required any farther, I have started to create external plugins that extend UltraTrader. Some of these can be found on the Jenkins Site, but we aware that these are not bukkit tested yet, and may be full of bugs.
Working Extensions (not flawlessly yet)
- UltraRental - Create Rental NPCs
- UltraDenizen - Allows UltraTrader to work with Denizens
- UltraWorldGuard
- Adds some requirements that can be setup by:
- using required traits in limits.yml
- adding required trait permissions "trader.limit.required.default.worldguardowner"
- currently only adds "worldguardowner" (trader must be standing a region the player owns) and "worldguardmember" (trader must be standing in a region a player is a member of)
- Currently should still work, but updates are suspended till I the new repo.
- Adds some requirements that can be setup by:
- UltraFrames
- Currently will show randomly changing items that your shop sells
- add ultraframe trait to NPC
- right click with stick to select
- place item frames and watch the magic.
- Currently will show randomly changing items that your shop sells
Compatibility Extensions
These extensions are there to extend the compatibility of UltraTraders to more specific modes beyond the normal use of UltraTraders. Some planned extensions will likely be a bridge Extension for handling Bukkit->Forge communications, as well as NBT related code that I don't want to place directly into UltraTrader.
Metrics
This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
If you wish to disable this feature (/me cries), you can do so by opt-ing out, which you can do in the config file under /plugins/PluginMetrics/
Some Videos
If anyone wants to create a video demonstrating the use of UltraTrader, please PM me, thanks. I will be creating more as time goes on, but removed the out dated material for now
TODO
- command to allow Ops to not always get items for free from all stores
- Currently I have removed OPs completely from the free sell list (OPs no longer get free items, or shouldn't)
- Players can use the "/traderplayer toggleop" command to toggle paying at their own shop (for test purposes)
- Item to allow click to see shop information
- The command is there (/trader info) but it does nothing yet due to forced update
- adding aliases: "/trader" -> "/ut" - "/traderplayer" -> "/utp" - "/traderadmin" -> "/uta"
- removing logging from ultratrader and using a extension plugin, to hopefully invite some members to add pull requests to add logging features.
Thanks
- dayron1313 - Github issues
- Chriszh - for being persistant ;)
Does this plugin work with out the Extensions, that is a lot of extra plugins.
What does the shop level do ??
I love this plugin, thanks man, please do not give up on developing and update it =D, also is it possible to add another npc type for sell command? Like when they purchase, server will active the command one such as /heal <player>
Is there anyway to add more slots for one category?
I'm having a little trouble. It seems to work great with the account that i use to create the trader (op) however i can not interact with the trader at all on a different account.
Am I overlooking anything?
I'm having a little trouble. It seems to work great with the account that i use to create the trader however i can not interact with the trader at all on a different account.
Am I doing something wrong?
just to make you feel better, i am having the same thing
It would be amazing if you could add compatability with coinage.
http://dev.bukkit.org/bukkit-plugins/coinage/
@Tenowg
(shop use error)
Version1.1
After an extensive and worrying troubleshoot period(appx 3 hrs) I have a few requests for the future.
The first thing would be a /ut setowner command. This is because the trader's owner was my playername where the NPC's owner was server. I had deopped my self to test trader and was still able to edit him. This caused me much grief because i had assumed every one would be able to do the same and spent three hours troubleshooting it.
The second thing i'd like to request is a /ut reload command. Once i found in the config that my player was the owner of the Npc still I had to stop the entire server to change and reload the server. A simple server reload wouldn't use the new(saved) config. So i had to stop my server :(
One more thing I would like would be the additon of sub-dollar amounts such as .5 and .25. I use EconXP and I want to sell stone for .5 and buy for .25 to avoid too much "stone dumping" into my market for huge level gains.
Thanks for your considerations and I love your plugin
@tenowg
(buy/sell playerheads)
I am using EconXP. Blayerheads can not be traded because each one is somehow unique (even if just by name). I can set traders to buy/sell non named player heads, or individal player heads individually but not All player heads equally as the same object.
@tenowg I had already used 1.1 when i tested.
Could you add some kind of discount setting per shop? I thought for a permisssion first of all
For example:
- trader.discount.testshop -> It would grant a preset percent of discount for testshop.
- trader.discount.all -> This would grant discount for all of the shops.
@tomori_peti
Wait for 1.1 to be approved and see if this error still happens... if it does then I will look into it more.
Or if you don't want to wait, try using the 1.1 download from Jenkins, link above.
If i use non ANSI character in category's name i got these errors spamming in the console: http://pastebin.com/KseiSaUC
@teh_jombi
haha, you know, to be honest I never thought about this... at least I never put anything in there to stop it from buy/selling... I will look into it, most likely will add an option to say no instead of a value when asked for prices. Thanks, strange how somethings slip though the cracks.
Edit: This has been added to least upload, just wait for bukkit to approve, or download from Jenkins.
@tenowg
Ah! Exactly what I was looking for. Thank you kindly!
Edit: And setting a shop to only sell items to players, do you just set the sell amount to 0?
@teh_jombi
Currently, it is required to have 1 category, BUT this is only seen my the owner of the shop.
When a player uses the shop (not the owner) and there is only one category, then he will automaticly be sent to the items list of that category, so it appears that there are no categories to him.
Hope this answers you question.
@tenowg
Is it possible to not have a category, but just a set of items?
@tronman2020
This is not something I have considered, but I would need more information before considering it. When you say buy/sell player heads, would this be generic heads (as in, it can buy any players head, or only ones that the shop knows about)
I am not sure how hard it would be (probably not that hard) to let items be selected to be allowed to be purchased by type, as in, buy a head, no matter whos, or by wool, no matter the color, ext... Then the use of a custom wallet interface, or econ plugin that uses XP, to give xp instead of money.
@DannySan626
UltraTrader is compatible with multi-world economies, at least it should be, I have never tested it to tell you the truth, but using Vaults option for sending the world is used in all (will double check to be sure). So it really depends on your Economy plugin.
It is possible to write a custom wallet interface for Ultratrader, while there isn't any documentation on it yet, which would let you use items instead of an economy plugin. Process would give you the option to set the shops wallet to the custom wallet that would need to search the inventory for the items instead of using Vaults.
Currently Vault will still be required, as there are some parts of the plugin that need it.
is there any way to change the currency type of any Npc Shop. I currently have different worlds and am Starting a Skyblock world where you can buy stuff to extend your island and make it look better. It would be great if the shops for that world could use Gold Nuggets to trade for items instead of the usual Vault economy money. If this is not added, it would make for a great upgrade and could expand the creativity of servers and many who use different worlds. Just my opinion but keep up the good work, I love this plugin and EVERYONE should use it!
@tenowg
Does this replacement allow the buy/sell of player heads? I can't find any thing that seems to work but I have not tried this yet. I really liked cititraders so I reckon i'll upgrade to this if it allows playerhead trade