NPC Trader - The Full featured localized shop system Version 1.1.4 (Testing Version!) The first localized full featured shop system for Bukkit/iConomy, in NPC Form! What's better for a localized shop system then your very own NPC Clerk / Teller / Worker / Slave / Whatever word you want to call your NPC! Features Localized system Fully player controlled (No admin intervention needed) Full Item and Metadata support (Colored wools, etc) Item name or ID recognition Partial name recognition (If online) Complete internal permissions system for managers of the NPC iConomy Based MySQL data storage Item stocking system In-Game help for everything Supports Permissions and GroupManager (Using FakePermissions) Plugins! Installation / Setup Put NPCTrader.jar in your plugins folder Put mysql-connector-java-bin.jar in your main minecraft folder Restart your server (Auto-generates config.yml in plugins/NPCTrader/) Edit the config.yml for MySQL and other config settings. Restart once more Enjoy! If for some reason the folder / config does not auto-generate, then you can open the .jar file with 7zip or winzip or other archiving utility that supports jars and extract the config.yml from the jar. NOTE: If you do not have or do not know if you have MySQL setup then you either have to setup MySQL or not use this plugin for now. Please do not post questions asking how to install MySQL as that is outside of the scope of this post. You can follow this tutorial (Thanks @Germata!) for detailed windows installation and setup, but I cannot provide support for installing and setting up MySQL, only support for my plugin specifically. Permissions Permissions will only be used if it is installed. The following is the permissions list: Code: npc.admin - Give to admins for full access to all NPCs npc.admin.list - Access to /npc list npcs npc.user.* - General user commands, you can specify by replacing * with command name, I.E. buy npc.manager.* - NPC Manager commands npc.owner.* - NPC Owner commands npc.create - Ability to create an NPC If permissions is used you may also specify limits on how many NPCs a specific player or group may have ownership flag on, please see config file for more information. Usage Once the plugin is installed and running, you can see the in-game help by typing /npc in your chat window. To interact with an NPC just right click on it first. Here is a simple tutorial for setting up an NPC named Bob that sell's bread, cooked fish, and cooked pork, and buys wheat, raw fish, and raw pork. Stand exactly where you want your NPC, including head position and body rotation. Type: /npc create Bob 6 10 This will create the NPC with 6 Item Slots, each holding 10 units. Right click on the newly created NPC Type: /npc setup 1 bread 1 2 0 true false This will setup Slot 1 with Bread, selling lots of 1 at 2 Coins, buying them from players at 0, True for NPC Selling it, False for buying from players. Repeat step 4 for Cooked fish and Pork Type: /npc setup 4 wheat 64 0 10 false true This will setup Slot 4 with Wheat, buying lots of 64 at 10 Coins. This one is set False to selling it to players, but true to buy from players. Type: /npc stock 1 20 This will stock the NPC with 20 breads on slot 1 (Assuming you have enough bread). Repeat step 7 for raw fish and pork. You know have a fully setup and functioning NPC. Known Issues / Bugs Config folder does not get generated on Linux - Works on Windows Cookies and beds, and pretty much any other 1.4/1.5 items. Spams console when you stand close to an NPC Gives error when an NPC is spawned (Can be ignored) Head / Rotation is not being properly set on spawn / move. (Fixed in 1.14) Does not work with actual permissions (works with GroupManager) Rename command is broken Things Todo Re-write item handling Support for both GroupManager and Permissions iConomy 5 Support Add armor capacity Tie into WorldGuard for checking for build rights (Will be optional) Misc If you installed MySQL for Windows just to run this plugin then check out this link to see how to create the initial minecraft database you will need. *** NOTE: SQLite IS NEVER GONNA HAPPEN! If you want to see an alternative, fork the src, make it work as an option, and I will include it in.*** Changelog Version 1.1.4 Changed out item name / id handling system Now supports all current official items Fixed Move Bug Fixed NPC Creation Errors Fixed a few other errors Fixed Config creation on linux (hopefully!) Version 1.1.3 Completely rewrote most of the code that directly interfaces with the NPC Library. Now uses chunk loading/unloading to make sure only NPC's in loaded chunks are loaded (Way more efficient) Changed banker command to only allow setting yourself as banker (to stop an exploit situation). Version 1.1.2 Fixed upgrading stack counts for free bug Fixed rename command not working on linux Made it so an NPC must have 1 item slot to be created Added permissions support for owned npc limits (By group or player) Version 1.1.1 Fixed issues with quantities of '0' Added rename command Fixed iConomy hooking on startup Version 1.1.0 Fixed Admin Override Permissions not working Added Half and Double Slabs Updated to work with B612+ Version 1.0.9 Updated to work on B531+ Updated to work with iConomy 4.* Much needed overhaul of error handling and disabling procedures. Converted integer based money to decimal based. Version 1.0.8 Updated for newer builds Version 1.0.7 Fixed more issues with ItemData, hopefully they are fixed for good. Added log names Added Coal/Charcoal distinction Order of slots listed will always be in ascending order Version 1.0.6 More meta-data issues, resolved. Version 1.0.5 My restructuring of the code to try to support SQlite completely foobared the connect and close code, causing timeouts and errors. Fixed it. Version 1.0.3 Fixed buy/sell/stock/unstock to use absolute values so that negatives cannot happen. Version 1.0.2 Fixed bug where db connection was closed on /npc create Version 1.0.1 Fixed bug with null Item Datas Version 1.0.0 Fixed many many bugs Added /npc list npcs as an admin command to let you see a full list of NPCs Added recording transactions. Added full permissions support Better error handling and message delivery. Version 0.94 Fixed not checking stock when doing /npc setup Made the setup's error messages way more intuitive Version 0.93 Fixed disappearing NPC bug. Version 0.92 Fixed bug where selling was not checking player inventory. Version 0.91 Fixed bug where giving improper arguments for upgrading and creating reported iConomy and NPC Trader out of sync. Version 0.9 Initial Release You can download the jar here. You can download the mysql connector jar here.