1. Home
  2. Games List  
  3. Knowledge Base  
  4. Rust Knowledge Base  
  5. Kits | Rust Server Plugin Guide
Kits | Rust Server Plugin Guide

Kits | Rust Server Plugin Guide


If you're an admin for a Rust Server and you're looking to understand how the Kits Plugin works, this is the know all, indefinate guide for this plugin. Everything you need to know from Kits' Admin Commands to Kits' Config options are listed below. The amount of things you can do with this plugin is insane! 

For this guide, we recommend being a server owner through GameServerKings for access to our 24/7 live support which will help you along the way. Check our Hosting Page for Rust Dedicated Servers for price inquiries. If you like this guide and would like to stay updated on information as valuable as this, check out our Rust Knowledge Base

Features include:

Being able to choose a limit for kit usage
Creating kits for Admins, Mods, and VIP's
Creating an AutoKit for easy on-login kit giving
This Plugin supports adding kits to Graphic User Interface menus.
This Plugin supports a GUI menu for chat
And much more!

By the time you finish this guide you should know all you need to know about the Kits Plugin from oxidemod.org.


Pre-configuration Install Guide:


Before we get started there will be a couple things you'll need to do:

First, install Oxide on your server. It's very easy, just requires one click! Read our guide on how to install Rust Oxide.
Next, you will need an oxidemod.org account. You can login with your steam information or make a new account.
Finally, download the Kits plugin from oxide mod located here.

Now that you've downloaded Kits, follow our How to install oxide plugins guide. You must install Kits in the correct directory to run. Once you've installed Kits, manually reset your server to generate plugin configuration files.

Optional Step: Download and install Give from Umod.org. This allows you the functionality for player moderators to give kits to users easily. You can find a link for Give here. You can find a guide for the Give plugin here. (coming soon)


Navigation:


Kits configuration guide:

The Kits Plugin does not require ANY .json editing to create kits for VIP, mods, or admins. It uses a series of in-game commands to do what it needs to do. There are admin only and player commands. Below are two tables describing what each command does, followed by an example of how you make a kit.

User Command List:

Command

Description

/kit By typing /kit, the chatbox will display the full list of kits available to you.
/kit "KitName" To select a kit, tpe /kit followed by the KitName.

 

Admin Command List:

Command

Description

/kit list Displays the list of all kits
/kit add "KitName" Add a new kit 
/kit remove "KitName" Remove a kit 
/kit edit "KitName" Edit a kit
/kit resetkits Deletes all kits and playerdata
/kit resetdata Resets all playerdata

Kit options:


You can edit options of a kit you are currently editing by typing:
/kit edit "KitName" followed by
/kit [option1 value1] [option2 value2]

Option 

Value

Description

max "number"/false Sets the maximum uses of a kit by changing the "number" field. False deactivates this option.
cooldown "time"/false Sets the cooldown between uses in seconds by changing the "time"value. False deactivates this option.
Building "ID" Sets a building to paste. Bad idea to use in user kits unless they're paid and one time use.
authlevel "number" Authorization level required to redeem the kit. Set it to 2 for this command to be admin only, otherwise use permissions.
npconly "true/false" This sets the kit to be NPC accessible only.
permission CustomPermissionName/false Only players with the "custom permission" oxide permission will be able to redeem these kits.
description "description text" Sets a description for the kit
image 'URL' Sets an image for a kit
hide true/false Hides a kit from the user kit list, but not admin kit list.
xp "xp value" Gives the user this much XP when redeeming the kit
items NO VALUE copies the items in your inventory to set it in the kit

In-Game Kit Building Scenario:

It's Christmas, and you want to reward your users with a kit of free Christmas items! You think to yourself, "hmm, that wouldn't be too hard," all you'd have to do is:

Step1: Clear your inventory of items
Step2: Open up your console by pressing F1
Step3: Give yourself the items using inventory.give "Item name"
Step4: Make the kit.

It would be that easy. We'll run you through this scenario.


Log into rust and connect to your server. Press F1 to open your console. I've decided I'll be giving my users 10 large christmas presents. So I cleared my inventory and then typed in inventory.give xmas.present.large 10 and that gave me 10 Large Christmas presents.

Now, I type /kid add ChristmasKit in my ingame text box. It returend with this:

ingame picture

Good, I've created my new kit. Next, I have to edit the kit to only allow users to claim their kit once a day to keep players from abusing gift box mechanics. Then, I'll also want to give my command a description. I type in the in-game text box:

/kit edit ChristmasKit
/kit cooldown 86400 description "Merry Christmas! Contains 10 large gift boxes."

"cooldown 86400" Sets the cooldown to 24 hours, because 24 hours * 60minutes * 60seconds = 86400 seconds.
My Description is set to Merry Christmas! Contains 10 large gift boxes.

After I hit enter I'm returned with a verification that the changes were made.

If I type /kit ChristmasKit it will redeem the 10 boxes. I do so to test it, now I can press [TAB] on my keyboard to check my inventory for changes.

Everything is there, so I know I did it right. Now make sure your users understand that the kit system works by replacing your inventory with the kit. Applying a kit will remove all items in your inventory. Make sure you give them a notice to secure their items in a container before using a kit.

There's an easy way to do that using the EasyChatCommands plugin. We have a guide here showing you how to set that up. We recommend putting this in your help area, which would show /kits if you set it to.


Advanced Kit Configuration

Now that you understand how to offer a kit to your users, here we'll show you a couple more ways you can configure this plugin to be a little more unique to your server.


Permissions:

/kit permission "permission name" applies a permission value to your kit. Using permissions you can give certain users certain kits over others. To make a new permission you can type /kit permission "NewPermissionName" or, more reliably, use oxide groups to make permissions. You should read our guide titled: "Oxide Permissions 101" for a better understanding of Oxide Permissions.

As for this plugin, you can use some basic oxide group commands within your F1 console as seen below.

Command

Description

oxide.grant user <username> <permission> Grants a user permissions
oxide.group add <groupname> Creates a group
oxide.grant group <groupname> <permission> Grants a group a permission level.
oxide.usergroup add <username><groupname> Adds a user to a group of users.
oxide.revoke <userid or username><group><permission> Revokes a member from a group

 

Example:

To apply a permission to a kit, say, "VIP", we'd need to first edit the VIP kit and then give it the permission. We'd do so by entering these commands in the in-game text box:

/kit edit VIP
/kit permission VIPPerms

You can give permissions to individuals or groups. If you give a permissions set to a group, all users within the group will have the permission. For example: John buys VIP on our Rust server's website, to give him VIP permissions and access to VIP Kits we'd type in the console:

oxide.group add VIP
oxide.grant group VIP VIPPerms
oxide.usergroup add John VIP

Now John is a member of the VIP group and can use the VIP Kit. 


AutoKits:

Autokits are useful, if you die, you can start again with a default kit, similar to how when you spawn in a new vanilla server, you spawn with a rock and a torch. There are two ways of configuring auto kits. The easy way gives one auto kit to all members on spawn or respawn. This kit is the same for everyone despite their permission levels. To set this up, it only takes three steps:

/kit add "autokit"
/kit authlevel 2 hide true
/kit itmes

Time to break this down. /kit add "autokit" creates a new kit named autokit. /kit authlevel 2 hide true makes the "autokit" kit only manually useable by those with authlevel 2 (server administrators) and hides it from the /kits command. /kit items changes the items in the kit to what is currently in your inventory. 

Following this method, you can create an autokit which is given to all users.


Custom AutoKits:

But say for example, you wanted to change your autokits depending on what permission status your users are. That can be done as well. To give kits to a specific user group, it will require some .json editing. To do this you must create your auto kit for your group first. To keep it easy, we'll do two. Normal and VIP.

Start by filling your inventory with the items you want in the Normal AutoKit. Type:

/kit add Normal
/kit authlevel 2 hide true
... Any other kit settings ...
/kit items

Then, remove everything from your inventory, and fill your inventory with the VIP Auto Kit Items.

/kit add VIP
/kit permission VipSpawn
/kit hide true
/kit authlevel 2
... Any other kit settings ...
/kit items

Now you have created two custom Auto Kits. Apply the permissions added to the oxide permissions groups 'default' which is the default group already made by oxide, and "VIP" the group we made earlier.

oxide.grant group default Kits.Normal
oxide.grant group VIP Kits.VIP

Now's the time to create all the custom kits you want to make. Now that you're done, it's time to configure them. Open your GameServerKing's Server Management panel, and click on file manager. Then navigate to oxide/config/Kits.json and edit Kits.json by clicking on the pencil next to the file. Navigate to the Custom AutoKits section, which should look like this:

"Custom AutoKits": {
},

Between the Curly Brackets, you will be adding your Kits. The way oxide will read this file, it will dispense the autokits in numerical order. So, if you are VIP, you have access to VIP kits as well as the default kit. For example, if you have a time restriction on kits of 5 minutes, and a VIP member dies twice within those 5 minutes, they will first receive the VIP kit, and then the kit for default users. Because of this, it's very important to list your Kits in numerical order, with your default at level 0, and increasing as you increase rank. So, in this scenario, we would change the Custom AutoKits section to look like this.

"Custom AutoKits": {
     "0": "Normal"
     "1": "VIP"
}

Save this file by clicking the save icon in the top left corner of the editor. Then, reset your server using your GameServerKings Game Server Manager panel. Your custom AutoKits will now be set up.


GUI Menus:

 

NPC GUI

When you create an NPC kit, you may choose to give it the option npconly true which makes the kit only accessible through NPCs. To allow NPC kits, create an npc and type /npc_list to get the NPC ID.  Then, go to your Kits.json file located at oxide/config/Kits.json and edit it by clicking on the pencil next to the file. You will be greeted by something like this: 

 "NPC - GUI Kits": {
NPC data

}

Then modify it to look something like this:

"NPC - GUI Kits": {
"NPC ID":{
     "description" : "Edit this string to what you want the description for your NPC Kit GUI to be."
     "kits: :[
          "kit1",
          "kit2",
          "... and so on"
          ]
     }
}

Once you fill out this information hit save in the upper left-hand corner of your text editor. Now your NPC will have a GUI where they can apply Kits to users.

Chat GUI

By default, there are no chat GUIs. But you may replace the default /kit chat command by a gui. In the code above, just type a zero for your NPC ID. This way instead of the kit selection being text-based, it will have it's own GUI, and the user will just have to click.


That's all you'll need to know! If you have any questions regarding this article, please voice your questions or concerns to our 24/7 live chat for an instant reply. Thanks for reading!