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 ;)
-
View User Profile
-
Send Message
Posted Jan 19, 2014Hello tenowg, I have a question. I understand the use of category's are needed to create a shop. But i was going to ask if there was a way you could implement a way to create my own category's without the need to name it with the in game chat. Or at-least simplify it.
-
View User Profile
-
Send Message
Posted Jan 16, 2014@Tendrid
If you scour the site you might find my name in a few places ;) Been there off and on since aufdemrand started denizens, he has made alot of progress on it though.
-
View User Profile
-
Send Message
Posted Jan 16, 2014@Tendrid
The towny extension isn't started yet, it only appears on Jenkins as it is a module, so you are likely to get this error, the working extensions are listed above... when I get the chance I will work on these soon.
-
View User Profile
-
Send Message
Posted Jan 15, 2014@tenowg
Feel free to stop in to the IRC channel, im always there as well as all the core devs. You may always want to talk to the dev thats doing Depenizen (http://wiki.citizensnpcs.co/Depenizen). I forget whos doing it off the top of my head, but hes in the irc channel as well.
also, i'm getting this error with the towny adapter for ultratrader: org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPluginLoader.java:247) [spigot.jar:git-Spigot-1239] at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:133) [spigot.jar:git-Spigot-1239] at org.bukkit.craftbukkit.v1_7_R1.CraftServer.loadPlugins(CraftServer.java:259) [spigot.jar:git-Spigot-1239] at net.minecraft.server.v1_7_R1.DedicatedServer.init(DedicatedServer.java:135) [spigot.jar:git-Spigot-1239] at net.minecraft.server.v1_7_R1.MinecraftServer.run(MinecraftServer.java:430) [spigot.jar:git-Spigot-1239] at net.minecraft.server.v1_7_R1.ThreadServerApplication.run(SourceFile:617) [spigot.jar:git-Spigot-1239] Caused by: java.io.FileNotFoundException: Jar does not contain plugin.yml ... 6 more
-
View User Profile
-
Send Message
Posted Jan 14, 2014@Tendrid
I am thinking about doing just that, but I have to get back into Denizens again and figure it out, it has changed so much since I last wrote any plugins for it.
-
View User Profile
-
Send Message
Posted Jan 14, 2014Would it be possible to get a support library for denizen? I'd love to be able to alter prices on my admin traders based on daily fluctuation in item purchases.
-
View User Profile
-
Send Message
Posted Jan 13, 2014@ProjectHyrule
There should be a 36 item limit per category, leaving the 2 lines empty in all item screens. At least it worked with I first tested it locally.
If you have any questions for the video, feel free to PM me. Thanks
-
View User Profile
-
Send Message
Posted Jan 13, 2014@tenowg
Dont worry to much about it =) The plugin is functional as of right now, playing around with the latest jenkins build and testing that out properly. I'll get you a video tutorial done, once i feel comfortable setting it all up. With the Jenkins build (92 Beta) there still seems to be a limit on items i can add to a shop as a OP. I might have to redo the npc from scratch though, ill try that =)
Edit: Tested with a new npc, theres still a 36 item limit on the stores. Also, default category works like a charm. It still has the arrow that sends people back to categories though, although the arrow dosent do anything for them. This works pretty well so far then.
-
View User Profile
-
Send Message
Posted Jan 13, 2014I am trying not to neglect this project, but currently I am still suffering from Sciatic nerve injury that limits my "sit" time... it would be worth a video for the comic value to see what happens if I sit to long...
-
View User Profile
-
Send Message
Posted Jan 13, 2014@ProjectHyrule
Yes I could really use some videos to show people how to use this...
-
View User Profile
-
Send Message
Posted Jan 10, 2014Sweet that sounds wonderful tenowg! I'll test it out in a few hours and have a look at it - Do you still need a video tutorial done? I could make one describing these things; Setting up a NPC shop, adding categories, sell + buy prices, changing levels and basic features in general etc. Entire limits thing i have not really looked into yet.
-
View User Profile
-
Send Message
Posted Jan 9, 2014@ProjectHyrule
I have pushed a version .92 BETA to Jenkins that contains the following:
Limits now will check if a player with OP and will assume they can have infinite everything. Admins that are not ops will still need to have permissions set.
-
View User Profile
-
Send Message
Posted Jan 9, 2014@ryanrmc
my recommendation for you, at this point:
And last but not least: remember to never reload a live server, always restart.
-
View User Profile
-
Send Message
Posted Jan 9, 2014@ProjectHyrule
The number of items in a category depends on the level of the shop (levels 1 - 4) and the number is 9 * Level, so if you have a level 2 shop, 18 items would be in each category. You may need to update to the Jenkins latest, as I am not sure if I added that build to Bukkit before I started having problems with my Sciatic nerve. Pervious builds would be limited to level * 9 for the whole store.
Again this information in the documentation is behind as I haven't been able to sit long enough to rewrite it before the pain makes be get up.
-
View User Profile
-
Send Message
Posted Jan 9, 2014@tenowg
I made another shop but that one broke again... I can't find it anymore in the config either.
-
View User Profile
-
Send Message
Posted Jan 9, 2014@tenowg
Ah lovely! I can indeed confirm that. If you're on 1.7.4 it dosent happen. All good then! Thank you :D
Still have one issue though, the amount of items you can add to a shop. Can i change that? My shop currently only holds about 20ish items, and it says thats the limit. I kinda wanted to add 10 categories, and about 100 items in total.
-
View User Profile
-
Send Message
Posted Jan 8, 2014@ProjectHyrule
Make sure you are using 1.7.4 client, the dragging dropping errors seem to be similar to those that were an error with bukkit/client 1.7.2.
@WilliamtheChad
This can be done, and could be added as a extension.
-
View User Profile
-
Send Message
Posted Jan 8, 2014Here's some functionality I'd like to see for this plugin in the future.
It is a type of admin/server shop that has a limited wallet and limited materials, but that regenerates it's wallet and materials on a set cycle. So you could say, set it to regenerate every 12 hours, every day, weekly, what ever kind of time frame you would like.
The wallet and inventory would be set at creation, and would not be attached to a specific player.
Is this something you'd be able to add in?
-
View User Profile
-
Send Message
Posted Jan 7, 2014@tenowg
Ah, I'm sorry to hear that man. Hope you'll be fine soon.
And regarding the category stuff, I think in the future it might be a good idea removing it, so it isnt forced. In my case i wanted to do seperated stores etc, like one called Food Store that shows all the food, i wouldnt need a category for that, which is why I asked :P Itll work for now though. Thank you for the reply! :)
Edit: Messed around with setting up a store now, but for some odd reason the "Sell Price" keeps being 0, also for people who dosent own the store, nor are OP'd and are actually in a default permission group. Not sure what im doing wrong here? Also, eventhough I am the store owner, i can sell to it. Of course i get 0 money from that :P
Edit2: Might have found the issue/error (If it is a error) - When you enter the dialogue where you set prices, the "Pay" Price seems to overwrite the "Charge" price, instead of being a Buy/Sell price etc. If you go into your config for each store, this is what it says on the buy price: !!float '0' <- i replaced this with a number, and it showed up right ingame. Is this a issue with the ingame editor, or what could be causing this?
Edit3: Found a duping method, you can drag down a category and add it to your inventory. You get the item then.
Edit4: I saw there was a version released the 3rd january - I never updated to that one haha. This might be why I've had issues. Can you confirm that before i start trying all over? xD
Edit5: Used latest version, all the adding of items for purchase/selling works just fine now, only issue is the duping one. Heres how you replicate it: 1: click a category. 2: You will have the category item in drag-n-drop (aka on your cursor) 3: Put the category item in your inventory 4: close shop 5: You then have the new item
This works for all the things in the NPC, you can basically take a item and drag and drop it to your inventory, and you get the item (If you do it on the buy-screen, you get two stacks and you pay for one)
Edit6: Is it not possible to set a limit on how many items i can add to a admin store? Atm it seems to lock me out of adding more items, after ive added about 23 items or so. Id like to change that, so i can have like 10 categories in my admin store, and list about a 100 items etc.
After i did these changes, it looked like i had some major lag on my server - not sure if this is related to the plugin, or if i was just unlucky.
-
View User Profile
-
Send Message
Posted Jan 6, 2014@ProjectHyrule
I am about to decide if I want to make a "default" category option, but for now, yes, a category is required.
I will update the tutorial later tonight... and just so everyone knows. things might be alittle slow for the moment, I seem to have injured my Sciatic nerve, so in short, it is a pain in the (you know what) to sit down for anything longer than 5 to 10 minutes if I am lucky.