About Give Item
聽Purpose of this plugin is to give players ability to give items to themselves and others using chat command. By default nothing is allowed to anyone, so you can load plugin safely and configure it afterwards. In default config there are multiple permissions. Think of them as different lists of items. You can add new or remove existing permissions as you prefer. If you grant giveto permission to player, he will be able to give items to other players. If player has this permission he will be able to click on the nickname at the top left of the UI and all players list will show up.
Note: For a player to appear in the list, he must be alive
## Permissions
- giveitem.giveto -- Allows the player to give items to other players.
-
giveitem.ignorelimit -- Allows the player to ignore limits.
More permissions with limits are created in config file (see Configuration section below)
聽
## Commands
- /giveitem - Shows a user interface with a list of items by category.
聽
## Configuration
- Default avatar 聽used if Image Library 聽is not loaded or no avatar image found
- Default amount 聽used when the user interface is first loaded. The amount can be changed by pressing the buttons at the bottom of the screen.
- Show admins on player select page 聽show / hide admins from player selection list
- Check ownership of DLC items聽enable / disable聽Player DLC API plugin support
- Chat steamID icon 聽used to set 聽desired account 聽icon in chat messages
- Log Level (Debug, Info, Warning, Off) 聽used to set desired logging level
- Discord message enabled 聽enable / disable sending messages to Discord (requires Discord Logger)
- Discord WebhookURL 聽use this Webhook 聽to send message in desired channel. Leave blank to send to default chanel.
- Exclude hidden items 聽used to exclude items that have flag hidden 聽(set by Facepunch). 聽Should be used with caution since hidden items might be buggy/broken
- Items blacklist 聽used to exclude items by shortname
- Commands list 聽set desired chat command(s)
- 聽Clear data on map change 聽and Clear data on new save (wipe) 聽are used for cleaning datafile with limits (cooldown)
-
Note: If you'll set Limit reset interval (seconds) 聽to 0 聽it will disable limits for this permission. You can remove unnecessary default permissions and also add as many permissions as you want. For cases where the player has more than one, the permission with the higher priority will be applied.
Quote{ "Default avatar": "https://i.imgur.com/9GRIb3F.png", "Default amount": 1, "Show admins on player select page": false, "Check ownership of DLC items": true, "Chat steamID icon": 0, "Discord message enabled": false, "Discord WebhookURL": "", "Clear data on map change": true, "Clear data on new save (wipe)": true, "Popup close delay (seconds)": 5.0, "Commands list": [ "giveitem", "igive" ], "Permissions": [ { "Permission": "default", "Priority": 10, "Exclude hidden items": true, "Categories": [ "Medical" ], "Items blacklist": [ "blood" ], "Limit Total": 10, "Limit reset interval (seconds)": 86400.0, "Limits per category": { "Medical": 10 }, "Limits per item": { "antiradpills": 2, "bandage": 4, "largemedkit": 1, "syringe.medical": 1 } }, { "Permission": "vip", "Priority": 20, "Exclude hidden items": true, "Categories": [ "Items", "Attire", "Tool", "Medical", "Food", "Misc", "Fun" ], "Items blacklist": [ "bottle.vodka" ], "Limit Total": 10000, "Limit reset interval (seconds)": 86400.0, "Limits per category": { "Items": 100, "Medical": 10, "Food": 1000 }, "Limits per item": { "maxhealthtea.pure": 10, "healingtea.pure": 10 } }, { "Permission": "elite", "Priority": 30, "Exclude hidden items": true, "Categories": [ "Weapon", "Construction", "Items", "Resources", "Attire", "Tool", "Medical", "Food", "Ammunition", "Traps", "Misc", "Component", "Electrical", "Fun" ], "Items blacklist": [ "electric.generator.small", "mining.quarry", "mining.pumpjack", "explosives" ], "Limit Total": 100000, "Limit reset interval (seconds)": 7200.0, "Limits per category": { "Resources": 100000, "Ammunition": 10000 }, "Limits per item": { "sulfur": 10000, "sulfur.ore": 1000 } }, { "Permission": "admin", "Priority": 100, "Exclude hidden items": false, "Categories": [ "Weapon", "Construction", "Items", "Resources", "Attire", "Tool", "Medical", "Food", "Ammunition", "Traps", "Misc", "Component", "Electrical", "Fun" ], "Items blacklist": [], "Limit Total": 0, "Limit reset interval (seconds)": 0.0, "Limits per category": {}, "Limits per item": {} } ], "Log Level (Debug, Info, Warning, Error, Off)": "Off" }
## Localization
- Plugins 聽phrases are available on 3 languages out of the box: English, Russian and Ukrainian
- Plugin supports 聽Rust Translation API 聽which allows you to have item names in any language supported by Rust
Quote{ "Error.Dead": "Giving items not allowed when dead!", "Error.Failed": "Failed to give item!", "Error.LimitCategory": "You have reached the limit of {0} items in this category! Cooldown: {1}", "Error.LimitItem": "You have reached the limit of {0} items of this type! Cooldown: {1}", "Error.LimitTotal": "You have reached the limit of {0} total items! Cooldown: {1}", "Error.NoPermission": "You do not have permission to use this command!", "Error.PlayerNotFound": "Player <color=#FFA500>{0}</color> not found!", "Format.Day": "day", "Format.Days": "days", "Format.DiscordEmoji": ":palm_down_hand:", "Format.DiscordMessage": "{0} <t:{1}:t> `{2}` **`{3}`** gave to `{4}` **`{5}`** `{6}` x{7}", "Format.Hour": "hour", "Format.Hours": "hours", "Format.LogMessage": "{0} {1} gave to {2} {3} {4} x{5}", "Format.Minute": "minute", "Format.Minutes": "minutes", "Format.Prefix": "<color=#00FF00>[Give Item]</color>: ", "Format.Second": "second", "Format.Seconds": "seconds", "Format.Title": "Give Item", "Format.ItemCategory.Medical": "Medical", "Format.ItemCategory.Items": "Items", "Format.ItemCategory.Attire": "Attire", "Format.ItemCategory.Tool": "Tool", "Format.ItemCategory.Food": "Food", "Format.ItemCategory.Misc": "Misc", "Format.ItemCategory.Fun": "Fun", "Format.ItemCategory.Weapon": "Weapon", "Format.ItemCategory.Construction": "Construction", "Format.ItemCategory.Resources": "Resources", "Format.ItemCategory.Ammunition": "Ammunition", "Format.ItemCategory.Traps": "Traps", "Format.ItemCategory.Component": "Component", "Format.ItemCategory.Electrical": "Electrical" }
聽
## Developer Hooks
### OnPlayerGiveItem
object OnPlayerGiveItem(BasePlayer player, BasePlayer playerTarget, Item item)
Called when a player tries to give item to another player. If player is trying to give himself an item playerTarget 聽will be the same as player. Returning a non-null value (default true) prevents item from being gaved.
