GiveIt - A "give" item plugin with more control  Version: 1.3 The idea behind this plugin is to allow players to use a special command called "/giveme" which can be controlled. By controlled, I mean that the server admin can only allow certain items with a max amount to be given. That way, you won't have players building giant gold structures unless you'd like them to You can also restrict an item to a single player for those extra special projects. Players are able to see what items are available ingame. Players that are added to the mods.txt file, will have the ability to add and remove items from the allowed.txt file ingame. They will also have the ability to give other players items. The usernames of players that are listed in the blocked.txt file will not be able to use the /giveme command. I've been using GiveIt for a while on my server to see how well it worked and so far it's been working quite well so I've decided to release it and share the source code. This is my first plugin for CraftBukkit so do go easy on me Features: Only allow specified items to be "given" Restrict the amount that can be "given" Restrict the giving of certain items to a single player Full logging of every item requested by every player Players can see what items are allowed ingame Mods can add or remove items from the allowed list ingame Certain players can be blocked from using the /giveme command ItemId's don't need to be in the 3 digit format ie. 75 will work instead of 075 Support for Permissions plugin v2.5 (Permissions plugin is optional) Download: Download GiveIt v1.3 Plugin Source Code Hudson Installation Instructions: Download GiveIt using the link above and place it in your plugins folder Enable GiveIt by starting your server GiveIt will automatically create a directory called GiveIt in your plugins folder In the GiveIt folder there should be a file called allowed.txt Add a new item to the allowed.txt file by following this: ItemID=MaxAmount.username eg. 278=01.cian1500ww This command allows cian1500ww to give themselves one diamond pickaxe eg. 278=01 This command allows any player to give themselves one diamond pickaxe Make sure that you only add one item per line. The plugin does NOT need to be reloaded after adding items to the allowed.txt file. Add the usernames of the players to mods.txt that you'd like to have access to the /givemeadd and /givemeremove commands. (Only if you are not using Permissions) Add the usernames of the players to blocked.txt that you would like to stop from using /giveme. (Only if you are not using Permissions) Reload the plugin after adding usernames to mods.txt or blocked.txt A log file called GiveIt.log will be created in the GiveIt folder after the plugins first use. Sample allowed.txt file: Code: #ItemID=Amount.username 278=01 052=01 078=64 079=64 066=30 074=32 011=10.cian1500ww Usage Instructions: A player can give themselves an item by using the following command: Code: /giveme <itemid> <amount> <durability> Example: Code: /giveme 052 1 Note: In version 1.3+, it's possible to /giveme and /giveto items with durability An important point to remember is that the item id must always be 3 digits so item 40 will be 040.No longer an issue in V1.2 If the player requests an item that isn't allowed, they will be notified. Also, if they request too many of one item, they will be asked to choose a lower amount. Players can see what items are available by using the following command: Code: /givemeinfo Players that are specified in the mods.txt file, can add items to the allowed.txt file with the following command: Code: /givemeadd <itemid> <quantiy> <username if required> Example: Code: /givemeadd 278 30 cian1500ww Example without username: Code: /givemeadd 278 30 They can also remove items from the file using this command: Code: /givemeremove <itemid> Example: Code: /givemeremove 50 The /giveto command allows players listed in the mods.txt file to give items in allowed.txt to other players. The command is as follows: Code: /giveto <playername> <item> <amount> <durability> Example: Code: /giveto cian1500ww 35 10 2 Permissions Plugin Instructions: Add the following permission to the groups or users that you'd like to have access to the "/giveme" command: Code: giveit.allow All users will still have access to the "/givemeinfo" command. Add the following permission to the groups or users that you'd like to have access to the "/givemeadd" and "/givemeremove" command: Code: giveit.modify To give users access to the "/giveto" command: Code: giveit.to If you are using Permissions, the mods.txt and blocked.txt files will not be used but will still be generated. Changelog: Version 1.3: Added support for CraftBukkit build 617 Added the /giveto command Added support for durability so players can now set the durability of the item they are spawning Fixed problems where players could give themselves more than the allowed amount Fixed the example command being shown everytime /giveme was used Tested with Permissions v2.5.5 Version 1.2: Added support for Permissions v2.5 Removed TSLPC Added support for builds 254+ Ability to add items and remove items from the allowed.txt file ingame. Added a blocked.txt file that will contain a list of usernames that aren't allowed to use the plugin Allowed for the use of item ids that don't begin with 0 ie. 74 instead of 074 Allowed for the spawning of item quantities greater than 64 Version 1.1: Added support for Permissions plugin Improved incorrect command checking Split the code into separate classes and tidied it up a bit Version 1.0: Initial Release Let me know of any problems here or feel free to drop me an email -> [email protected] If you have any ideas or feature requests, please do tell me and I'll do my best to implement them!!