Skip to content
← All documentation

/// SUPPORTED THIRD-PARTY PLUGIN

Rust Kits

Free guide for configuring this third-party plugin in the Hub. Install the plugin separately from its official source.

Prepare your file

  1. Check the installed version

    This guide describes Rust Kits 4.4.9. Use the same version in the configurator.

  2. Import your configuration

    Open the configurator and import your current JSON. For a new installation, you can start from the provided example.

  3. Edit and download

    Adjust the settings, fix reported errors, and download the JSON. Keep a copy of your old file before replacing it.

Your configuration is not saved on the site. Keep the exported file; you can import it again later.

Settings for this version

General 14
Kit chat command
Text · required

Chat command opening kits, without a leading /. Choose a name not already used by another plugin.

JSON pathKit chat command
Purchase currency
Choice · required

Currency used for paid kits: scrap items, Economics balance or ServerRewards points. The last two require their respective plugin.

JSON pathCurrency used for purchase costs (Scrap, Economics, ServerRewards)

Allowed values: Scrap, Economics, ServerRewards

Log granted kits
On / off · required

Log kit grants to help track claims and troubleshoot distribution.

JSON pathLog kits given
Wipe player usage data
On / off · required

Clear player usage data on wipe, including kit uses and cooldowns. This does not delete kit definitions.

JSON pathWipe player data when the server is wiped
Use Kits UI
On / off · required

Use the graphical kit menu. When disabled, the plugin uses its command/chat workflow.

JSON pathUse the Kits UI menu
Filter player skins
On / off · required

Requires Player DLC API for the automated ownership filter.

JSON pathOnly show/give players skins that they are allowed to use (requires PlayerDLCAPI)
Allow NPC kit skins
On / off · required

Allow skinned items in kits given to NPCs. This does not replace players’ skin-ownership checks.

JSON pathAllow NPCs to use skins in kits
Allow auto-kit toggle
On / off · required

Let players choose whether auto-kits are granted on spawn. This does not create a new auto-kit.

JSON pathAllow players to toggle auto-kits on spawn
Show inaccessible permission kits
On / off · required

Also show kits a player cannot access. Their permission is still required: visible does not mean claimable.

JSON pathShow kits with permissions assigned to players without the permission
Admins ignore usage restrictions
On / off · required

Allow administrators to bypass kit usage restrictions. They must still have enough inventory space.

JSON pathPlayers with the admin permission ignore usage restrictions
Auto-kits by priority
List · required

Exact kit names tried automatically on spawn in priority order. The plugin selects the first eligible kit; order matters.

JSON pathAutokits ordered by priority
Post-wipe cooldowns
JSON value · required

Set the post-wipe delay in seconds for each kit name.

JSON pathPost wipe cooldowns (kit name | seconds)
CopyPaste parameters
List · required

Option/value arguments passed to CopyPaste for kits containing a building. Requires CopyPaste and an existing building file.

JSON pathParameters used when pasting a building via CopyPaste
HumanNPC kit menus
JSON value · required

Choose the kit menu shown by each NPC user ID.

JSON pathKit menu items when opened via HumanNPC (NPC user ID | Items)
UI options 2
Default kit image URL
Text · required

Direct address of the image to display, not its web page. Use an image players can access; prefer HTTPS.

JSON pathUI Options → Default kit image URL
View-kit icon URL
Text · required

Direct address of the image to display, not its web page. Use an image players can access; prefer HTTPS.

JSON pathUI Options → View kit icon URL
Configuration version 3
Major
Choice · required

Internal configuration format marker. Keep the value supplied for this plugin version.

JSON pathVersion → Major

Allowed values: 4

Minor
Choice · required

Internal configuration format marker. Keep the value supplied for this plugin version.

JSON pathVersion → Minor

Allowed values: 4

Patch
Choice · required

Internal configuration format marker. Keep the value supplied for this plugin version.

JSON pathVersion → Patch

Allowed values: 9

Primary color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Color 1 → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Color 1 → Alpha
Secondary color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Color 2 → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Color 2 → Alpha
Accent color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Color 3 → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Color 3 → Alpha
Additional color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Color 4 → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Color 4 → Alpha
Disabled color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Disabled Color → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Disabled Color → Alpha
Panel color 2
Hex
Text · required

Color for this part of the menu as #RRGGBB, such as #FF8800 for orange. Opacity is set separately with Alpha.

JSON pathUI Options → Panel Color → Hex
Alpha
Number · required

Opacity for this color: 0 = fully transparent, 1 = opaque. Low opacity may make the menu or text unreadable.

JSON pathUI Options → Panel Color → Alpha

Plugin instructions

Rust Kits 4.4.9

Configure Rust Kits for free under Oxide using the global file oxide/config/Kits.json. This guide covers the official uMod version 4.4.9 observed on 2026-08-02, under the MIT license. Image Library is required for this version.

Global configuration

  • Command and economy: Kit chat command and Currency used for purchase costs (Scrap, Economics, ServerRewards).
  • Logging and lifecycle: Log kits given and Wipe player data when the server is wiped.
  • Menu and access: Use the Kits UI menu, Show kits with permissions assigned to players without the permission, and Players with the admin permission ignore usage restrictions.
  • Skins: Only show/give players skins that they are allowed to use (requires PlayerDLCAPI) and Allow NPCs to use skins in kits. Player DLC API is required only for the automated ownership filter described by the first option.
  • Auto-kits: Allow players to toggle auto-kits on spawn and the ordered Autokits ordered by priority list.
  • Post wipe cooldowns (kit name | seconds) associates each kit name with a delay in whole seconds.
  • Parameters used when pasting a building via CopyPaste is passed to the optional CopyPaste integration.
  • UI Options contains six { Hex, Alpha } colors plus Default kit image URL and View kit icon URL.
  • Kit menu items when opened via HumanNPC (NPC user ID | Items) associates each numeric NPC user ID with a claimable kit list and NPC response.
  • Version is managed by the plugin and is 4.4.9 in the supplied default configuration.

Kit data is not configuration

Kit definitions and their inventories are not in Kits.json. The plugin reads them from oxide/data/Kits/kits_data.json; per-player uses and cooldowns are stored in oxide/data/Kits/player_data.json. The configurator edits only global settings, not kit contents or player data.

Official source: https://umod.org/plugins/rust-kits

Install the file

After keeping a copy of the previous file, place the exported JSON at this location on your server:

oxide/config/Kits.json

Follow the plugin instructions above for dependencies and reloading. Exporting does not connect the site to your server.