Wulf
Allows players with permission to give items or kits

Supported Games

Give limits item giving by only allowing players with the relevant permissions access to give items (by item ID or item name, when available) to themselves or other players.

WARNING: By default, this will override and replace any commands that share the same name. For Rust, this will cause all F1 item giving to require permissions in order to use it.

If the Kits plugin is installed, players can also give kits if they have the permission.

Permissions

  • give.self -- Allows giving items to self
  • give.all -- Allows giving items to all players
  • give.to -- Allows giving items to other players
  • give.arm -- Allows giving items to player's belt (Reign of Kings and Rust only)

Kits

  • give.kit -- Allows giving kits to self
  • give.kitall -- Allows giving kits to players
  • give.kitto -- Allows giving kits to all players

Commands

  • give <item id or name> [amount] -- Give an item to yourself
  • giveall <item id or name> [amount] -- Give an item to all players currently connected
  • giveto <player name or id> <item id or name> [amount] -- Give an item to another player
  • givearm <item id or name> [amount] -- Give an item to your yourself in the belt (Reign of Kings and Rust only)

Kits

A supported Kits plugin must be installed and loaded for these commands to work.

  • givekit <kit name> -- Give an available kit to yourself
  • givekitto <player name or id> <kit name> -- Give an available kit to another player

Note: If no amount is given, only a single item (1) or kit will be given. If not player name or ID is specified, item or kit will be given to the player using the command.

Configuration

{
  "Item blacklist (name or item ID)": [
    "rock",
    "torch"
  ],
  "Log usage to console": false,
  "Show chat notices": true,
  "Show popup notices": true
}

Localization

{
  "CommandGive": "give",
  "CommandGiveAll": "giveall",
  "CommandGiveArm": "givearm",
  "CommandGiveTo": "giveto",
  "CommandGiveKit": "givekit",
  "CommandGiveKitTo": "givekitto",
  "CommandGiveKitAll": "givekitall",
  "GiveKitAllFail": "Could not give kit '{0}' to {1} player(s)",
  "GiveKitAllSuccess": "Gave kit '{0}' to {1} player(s)",
  "GiveKitFail": "Could not give kit '{0}' to yourself",
  "GiveKitSuccess": "Gave kit '{0}' to yourself",
  "GiveKitToFail": "Could not give kit '{0}' to '{1}'",
  "GiveKitToSuccess": "Gave kit '{0}' to '{1}'",
  "GiveAllFail": "Could not give item {0} x {1} to {2} player(s)",
  "GiveAllSuccess": "Gave item {0} x {1} to {2} player(s)",
  "GiveFail": "Could not give item {0} x {1} to yourself",
  "GiveSuccess": "Gave item {0} x {1} to yourself",
  "GiveToFail": "Could not give item {0} x {1} to '{2}'",
  "GiveToSuccess": "Gave item {0} x {1} to '{2}'",
  "InvalidItem": "{0} is not a valid item or is blacklisted",
  "InvalidKit": "{0} is not a valid kit",
  "ItemNotFound": "Could not find any item by name or ID '{0}' to give",
  "ItemReceived": "You've received {0} x {1}",
  "KitsUnavailable": "Kits plugin is not installed or is not loaded",
  "NotAllowed": "You are not allowed to use the '{0}' command",
  "NoPlayersConnected": "There are no players connected to give items to",
  "NoPlayersFound": "No players found with name or ID '{0}'",
  "PlayersFound": "Multiple players were found, please specify: {0}",
  "PlayersOnly": "Command '{0}' can only be used by a player",
  "PlayerNotConnected": "Unable to give to player '{0} ({1})', not connected",
  "UsageGive": "Usage: {0} <item id or name> [amount] [skin id]",
  "UsageGiveAll": "Usage: {0} <item id or name> [amount] [skin id]",
  "UsageGiveTo": "Usage: {0} <player id or name> <item id or name> [amount] [skin id]",
  "UsageGiveArm": "Usage: {0} <item id or name> [amount] [skin id]",
  "UsageGiveKit": "Usage: {0} <kit name>",
  "UsageGiveKitTo": "Usage: {0} <player id or name> <kit name>",
  "UsageGiveKitAll": "Usage: {0} <kit name>"
}

Credits

  • thomasfn(the original Oxide developer), for the original Kits plugin for Oxide 1
  • Reneb, for the original Kits plugin for Rust and Hurtworld on Oxide 2
  • Mughisi, for the original Kits plugin for Reign of Kings

MIT License, with distribution exclusivity for uMod.org


Copyright (c) 2020 Wulf


Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:


The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.


THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.