[ADMN] GiveTo v0.8 - Give Items / Kits to Others or Self, Permissions/Economy - /gto | /gme [1597]

GiveTo - Give Items (& Kits) to Others or Self, Permissions/Economy Support
Version: v0.8
CraftBukkit: 1000, 1060, 1185, 1240, 1337

GiveTo is an easy way to give items to other players or yourself. Using Permissions or EssentialsGroupManager (w/ EssentialsGroupBridge) allows fine administrative control. GiveTo supports iConomy 4/5/6, BOSEconomy 7, MultiCurrency, and Essentials Economy via Register.

You can give an item by ID or NAME. If no item matches directly, GiveTo attempts to search for a matching item. If there is more than one result, you are presented a list of matches.

You can also specify an amount to give. Each item can have its own default and max amounts. Or GiveTo will use the global amounts configured.

Features:

• Item ID or Name with searching & results
• Global/Item-specific default and max amounts
• Global/Item-specific costs
• Global/Item-specific delays (cooldown)
• Quick self-give command
• Items can have multiple aliases and also act as a kit
• Customizable messages
• Configurable command names (with plugin.yml change)
• Permissions Support (else OPs): command use, reload, specific items/kits, delay/cost exemptions

Commands:

GiveTo adds two commands: /giveto (/gto /give) and /giveme (/gme). Both accept "reload" as the first argument to trigger a reload of the config.yml. /gto has full functionality from the console.

• /gto <player> <item> [count]
• /gme <item> [count]

The player can be a player name or "me." As long as there is only one match, you can enter part of a player name. Entering /gto ltg ... will give items to "ltguide."


The item can be an ID number or text that includes spaces or * as a wildcard. For example, assume you have two items: cobblestone and cobblestone stairs. Entering /gme co st 3 will display the two items. However, /gme co sta 3 will give you 3 cobblestone stairs. You could also use c a, but it actually matching would depend on what other items you have added.

You can also specify a "durability" that will override the one set in config. For example, /gme sapling:1 will give you a Spruce Sapling. This is useful for Maps since there are too many to conveniently list in the config.

If you want to change the commands, then you need to change them in plugin.yml inside the .jar. (7-zip: open jar, right-click plugin.yml, "Edit")

Configuration

Code:

count:
    max: 512
    def: 64
delay: 0
cost: 0
updateinventory: ['someclientmoduser','anothersuchuser']
messages:
    arglength: '&5Syntax: &f%s'
    permission: '&cYou do not have permission.'
items:
    stone:
        alias: rock
        id: '1'
    kit:
        def: 1
        max: 1
        permission: beginnerset
        delay: 600
        cost: 5
        id:
        - '276'
        - '277'
        - '278'
        - '279'
        - '259'
        - '288'

That is a sample configuration. The full config.yml will be created in the plugins/GiveTo folder when you start the server. You can also download the full config.yml below. YML files requires spaces instead of tabs and the level of indention matters.

Count:
If no amount is specified to /gto or /gme then the "def" value is used. The "max" value is the maximum amount that can be given per item.

Delay:
If no delay (cooldown) is specified in the item, then the global delay is used. The delay on a specific item can be less than the global.

Cost:
If a cost is specified in the config, then Register.jar will be created in the lib/ folder when you start the server. You will need to reload/restart the server or no money will be deducted from a player's account. The cost on a specific item can be less than the global.

Update Inventory:
Client mods for inventory (TooManyItems) require updateInventory() to visually update. However, this API method is deprecated so it shouldn't be used because a future update may remove it. Using this call resends the entire inventory to the player, so it requires more bandwidth from the server. By default the GiveTo plugin will not use it, but it can be enabled for certain users or globally with '*' if a lot of users request it.

Messages:
You can use Color Codes to control the colors in messages. You can flip the order of replacements by using %2$s and %1$s instead of %s. You don't have to use every replacement either, i.e. not showing balance.

Items:
item name - can contain spaces, i.e. glowstone block

• id - required - ID as string: '1' or ID as string list: ['276','277'] (or in long form; see above config); for durability values use a colon: '35:4'
• alias - optional - another common name, i.e. netherstone for netherrack (can also be a list, see 'id' above)
• def - optional - default amount
• max - optional - maximum amount
• delay - optional - delay seconds before giving item again(cooldown)
• cost - optional - money amount
• permission - optional - if specified, the user needs to have giveto.item.PERMISSION to give

Permissions:

• giveto.others - /gto
• giveto.self - /gme
• giveto.reload - /g* reload
• giveto.item.PERMISSION - required if you set an item specific permission
• giveto.exempt.delay - exempt from delay period
• giveto.exempt.cost - exempt from cost (all items FREE)

You can assign the same permission to multiple items (i.e., permission: builder) then assign a user or group 'giveto.item.builder' It's probably a good idea to add a permission to lava, bedrock, etc.

If any Permissions-like plugins are not available then Bukkit Permissions (SuperPerms) is used which, by default, will grant all access to OPs only.


Download GiveTo Plugin (Static)
Download GiveTo Plugin (version in filename)
View Full Items List
Source Code

Changelog:
Version 0.8

• added new items
• updated Register support (no longer needed in /lib)
• uses Bukkit Permissions (SuperPerms) if no Permissions-like plugin

Version 0.7

• added configurable updateInventory() for client mod fix
• updated Register support (iConomy 6, MultiCurrency, BOSE7)
• fix cost message showing previous balance

Version 0.62

• add new items

Version 0.61

• remove need for utf-8 encoded config.yml (now uses & for color instead of unicode)
• updated economy support
• fix default durability (fixes unable to craft with some spawned items)
• fix name lookup with specified durability (yellow wool:5 is really Light Green Wool)

Version 0.6

• customizable messages

Version 0.5

• able to specify custom durability on item (map:2)
• economy support (cost)
• delay periods/cooldown (delay)
• permissions for cost/delay exemptions
• multiple aliases per item

Version 0.4

• properly use command aliases in plugin.yml
• remove unnecessary if from onCommand
• override /give
• inventory full message

Version 0.3

• No longer requires target as exact player name, will search

Version 0.2

• Displays loaded items onEnable and reload
• Minor cleanup from pre-release

Version 0.1

• Initial release