Kits for Rust

Kits

Total Downloads: 43,547 - First Release: Oct 21, 2014 - Last Update: Feb 28, 2017 at 9:46 PM

4.94853/5, 136 likes
  1. Absolut
    Kits plugin, with only command chat support

    Features:
    Choose a limit of usage for kits
    Choose a cooldown for kits
    Create kits for admins
    Create kits for moderators
    Create kits for VIPs
    Choose 1 Autokit on your server
    Configure Permission based AutoKits
    Supports GUI
    Supports NPC
    Supports Skins
    Supports Pasting Buildings (CopyPaste version 3.0.8+)
    Enable Kit Logging
    Create kits not accessible by players but accessible via the Give plugin
    No more json, too hard for a lot of admins, all kits are configuration from ingame

    Players Commands:
    - /kit => see the full list of available kits for you
    - /kit KITNAME => choose a kit

    Admin Commands:
    - /kit list => see the full list of kits
    - /kit add "KITNAME" => add a new kit
    - /kit remove "KITNAME" => remove a kit from the database
    - /kit edit "KITNAME" => edit a kit
    - /kit resetkits => delete all kits and player data
    - /kit resetdata => reset player data
    - /kit option1 value1 option2 value2 option3 value3 => set the options for a kit you are currently editing

    How to create kits:
    1) Empty your inventory
    2) Add in your inventory the kit that you want players to have (blueprints, weapons in the belt, armors in the clothing, etc)
    3) use /kit add "kitname"
    4) set the options via: /kit option1 value1 option2 value2 etc
    ex:
    /kit items max 10 cooldown 3600 description "Every hour kit, max usage: 10"



    Options:
    max XXX/false => set the max usage of a kit (false will deactivate it)
    cooldown XXXX/false => set the cooldown in seconds of a kit (false will deactivate it)
    building XX => sets a building to paste
    authlevel X => level needed to redeem the kit
    npconly true/false => only avaible via an NPC
    permission CUSTOMPERMISSION/false => only players with the custom permission oxide permission will be able to redeem those (doesn't work on autokits). See under.
    description "XXXX XXX"/false => set a description for a kit
    image "URL" => set an image for a kit in the GUI.
    hide true/false => hide a kit from the list: /kit (won't hide from the admin command /kit list)
    xp XXX => give this much of xp when redeeming the kit
    items => no values here, this will copy the items in your inventory to set it in the kit.

    Custom Permissions:
    when you created a kit or edited a kit do:
    /kit permission PERMISSIONNAME
    the permissionname can be a new permission or an existing permission.

    Custom permissions are oxide permissions:
    Code (Text):
    oxide.grant user "PLAYERNAME" PERMISSIONNAME
    Auto Kits:
    1) /kit add "autokit"
    2) /kit authlevel 2 hide true => this will set the kit only manually redeemable for admins, and hide will hide it from the list in /kit.
    3) /kit items => this will copy the items in your inventory to set it as the new kit. you don't need to do it seperatly you can do it in the previous line: /kit authlevel 2 items hide true

    Permission based AutoKits:

    "AutoKits": {
    "permission1.allow": "KitName1",
    "permission2.allow": "KitName2",
    "permission3.allow": "KitName3"
    },

    AutoKits extends the default autokit functionality but gives the customization of having multiple different autokits. On respawn this plugin will check any entries in the config and if the player has permission will give the kit. To configure an autokit simply provide a permission name (you can make this up --> see example) and a kit name (this kit must exist). So for example, if you have a kit named guns.. you might make an autokit of: "guns", "guns". Once you reload Kits it will automatically register permission: Kits.guns ... if you give this permission to a player they will get the gun kit on EVERY respawn.

    NPC GUI:
    When you create a NPC Kit, you can (or not) use -npconly
    When you created your npc, do /npc_list to get the NPC ID.
    Then in the config you can add what this npc has:
    Code (Text):
    "NPC - GUI Kits": {
    "1235439": {
          "description": "Welcome on this server, Here is a list of free kits that you can get <color=red>only once each</color>\n\n                      <color=green>Enjoy your stay</color>",
          "kits": [
            "kit1",
            "kit2"
          ]
        },
        "8753201223": {
          "description": "<color=red>VIPs Kits</color>",
          "kits": [
            "kit1",
            "kit3"
          ]
        }
    }
     
    Chat GUI:
    By default there are no chat gui.
    But you may replace the default /kit chat command by a gui.
    in the NPC - GUI Kits, instead of putting an NPC id, put: "0".

    ex:
    Code (Text):
    {
      "NPC - GUI Kits": {
        "0": {
          "description": "<color=green>Chat Kits</color>",
          "kits": [
            "lotwood",
            "wood",
        "autokit"
          ]
        }
      }
    }
    [U][/U]
    Adding Kits to GUI Menus
    You can add kits to each NPC GUI Menu or the Chat GUI Menu by editing the Kits List in the config or by clicking the "Add Kits" button in the GUI. This button and functionality is only available to Auth Level 2 or players with the permission ---> Kits.admin

    GUI Key Binding:
    If you choose to use the chat "0" Menu this config will set a keybinding in addition to the /kit --> command. Symbols don't work so don't ask. Use letters or f-keys. Make sure the F in say F6 is lower case: f6. Pressing the button will "Toggle" the menu.. meaning open and close it.

    GUI - Custom Background Image:
    If you choose to use the chat "0" Menu this url will provide a custom background for the UI. Simply make or find a picture and paste the URL into this field. Reload the plugin and you are done.

    CopyPaste Support:
    Create a building with CopyPaste then copy it.
    Create a new kit and put /kit building BUILDINGNAME as a kit parameter
    And voila, when people request the kit they will paste the building.
    In the configs you may change the parameters of copy paste buildings (only 1 parameter for all the buildings, so you can't set them seperatly)

    Code (Text):
      "CopyPaste - Parameters": [
        "autoheight",
        "true",
        "blockcollision",
        "3",
        "deployables",
        "true",
        "inventories",
        "true"
      ]
    Kit Logging:
    If you enable this option it will create a log file in oxide..logs.. named "KITS-KitLogging {todays date}. Each redeemed kit will be written in here with PlayerName <SteamID> Kit name <Date & time>

    Default Example Configs in:
    oxide/config/Kits.json
    Code (Text):

    {
      "NPC - GUI Kits": {
        "1235439": {
          "description": "Welcome on this server, Here is a list of free kits that you can get <color=red>only once each</color>\n\n                      <color=green>Enjoy your stay</color>",
          "kits": [
            "kit1",
            "kit2"
          ]
        },
        "8753201223": {
          "description": "<color=red>VIPs Kits</color>",
          "kits": [
            "kit1",
            "kit3"
          ]
        }
    }
     
    Settings authLevel is the level needed to use the admin commands
    note that a level 1 can't remove a kit from a level 2.

    For Plugin Devs
    To refuse a kit to be given (arena, specific player moderation, etc)
    you may do this:
    Code (Text):
    function PLUGIN:canRedeemKit(player)
        if(ArenaPlayers[player]) then
            return "You are currently in an Arena, you may not redeem any kit"
        end
        -- don't return anything if you want to let the kit to be redeemed
    end
    By returning ANYTHING it will refuse the kit to be given, return a text to specify the reason.

    Check if the kit exists:
    Code (Text):
    object theanswer = Interface.CallHook("isKit", KITNAME);

    Images

    1. AutoKitInstructions.png
    2. CustomBackground.PNG
    3. InGameAddKits.PNG
    4. logEntries.PNG
    5. logging.PNG
    6. NewUI.PNG