Rust Kits

Advanced in-game kit and loadout system for Carbon and Oxide/uMod Rust servers.

RustKits gives Rust server owners a complete and professional way to create, manage, and distribute player kits. Players can browse available kits, inspect their contents, view cooldowns and usage limits, and redeem kits through a clean in-game interface.

Server administrators can create and edit kits directly from inside the game without manually editing complex data files. Configure permissions, cooldowns, usage limits, costs, images, descriptions, item slots, and building blueprints from one integrated system.

Features

• Clean in-game CUI kit menu for players.
• Detailed kit view showing images, descriptions, item contents, cooldowns, usage limits, and purchase costs.
• In-game kit creation and editing interface for administrators.
• Create, edit, delete, and manage kits without manually editing kit data files.
• Copy items directly from the administrator's inventory when creating a kit.
• Support for inventory, clothing, and belt item slots.
• Support for item skins, blueprints, item contents, and supported item attachments.
• Configurable kit names, descriptions, images, permissions, auth levels, costs, cooldowns, maximum uses, and visibility.
• Permission-based kits for VIP, donor, staff, event, and custom player groups.
• Auth level restrictions for administrator and special-access kits.
• Per-player cooldown tracking.
• Maximum redemption limits per player.
• Post-wipe cooldowns for controlling kit access after a server wipe.
• Optional automatic player-data cleanup when the server is wiped.
• Automatic spawn kits that can be given to players after respawn.
• Optional player control for enabling or disabling automatic spawn kits.
• Kit costs using Scrap, Economics, or ServerRewards.
• CopyPaste support for kits that include building blueprints.
• HumanNPC support for opening configured kit menus from NPCs.
• Configurable NPC kit menus with separate kit lists and welcome messages.
• Player skin ownership checks through PlayerDLCAPI when enabled.
• Separate skin behavior for NPCs and non-player entities.
• ImageLibrary support for kit icons and UI images.
• Local title image support for offline and server-controlled branding.
• Configurable fallback title text when a title image is unavailable.
• Configurable UI colors, default images, title image path, image identifier, store link, and store note.
• Clear UI states for Claim, Purchase, Unlockable, Not Owned, cooldown, and maximum uses.
• Optional logging of kits given to players.
• Built-in chat and console administration commands.
• Compatibility hooks for other plugins that check or restrict kit redemption.
• Developer API for giving kits, checking kits, reading kit data, managing cooldowns, and tracking player usage.
• Legacy Kits data conversion utilities for importing supported older kit data.
• Fully customizable language messages and UI text.
• Compatible with both Carbon and Oxide/uMod Rust servers.

Quick Start

Install Image Library and upload RustKits.cs to your server plugins folder.

Load or reload the plugin, then open the kit menu in-game with:

/kit

Administrators can create a new kit with:

/kit new

Players can claim a specific kit directly with:

/kit <kit name>

RustKits stores kit definitions and player usage data separately from the plugin configuration, making it easy to update the plugin without losing configured kits or player cooldown data.

Player Commands

• /kit - Open the kit menu.
• /kit <name> - Claim a specific kit.
• /kit help - Display the available commands.
• /kit list - Display the available kits.
• /kit autokit - Enable or disable automatic spawn kits when enabled in the configuration.

Administrator Commands

• /kit new - Create a new kit using the in-game editor.
• /kit edit <name> - Edit an existing kit.
• /kit delete <name> - Delete an existing kit.
• /kit give <player> <kit> - Give a kit to a player.
• /kit givenpc <kit> - Give a kit to the NPC being targeted.
• /kit reset - Reset all player kit usage data.
• /kit resetuses <player> <kit> - Reset one player's usage for a specific kit.

Permissions

• kits.admin - Access the kit administration system and in-game editor.
• kits.<permission> - Custom permission assigned to an individual kit.

Example kit permissions:

kits.vip
kits.vipplus
kits.event
kits.staff

Kit permissions must use the kits. prefix.

Economy Support

RustKits supports multiple payment methods for kits:

• Scrap: Use the Scrap item as the kit currency.
• Economics: Charge players through the Economics plugin.
• ServerRewards: Charge players using ServerRewards points.

Each kit can have its own configurable purchase cost, allowing servers to create free, economy-based, VIP, and premium-style kits.

Optional Integrations

• ImageLibrary: Provides kit images, title images, and image caching for the UI.
• CopyPaste: Allows kits to paste configured buildings when they are redeemed.
• Economics: Enables Economics currency for kit purchases.
• ServerRewards: Enables ServerRewards points for kit purchases.
• PlayerDLCAPI: Checks skin ownership and prevents unauthorized skin usage when enabled.
• HumanNPC: Allows administrators to configure NPC-specific kit menus.

Configuration

• Change the player chat command.
• Select Scrap, Economics, or ServerRewards as the kit currency.
• Enable or disable the kit UI.
• Enable automatic player-data cleanup after a wipe.
• Enable or disable automatic spawn kits.
• Allow players to toggle automatic kits.
• Show or hide permission-restricted kits.
• Allow administrators to bypass usage restrictions.
• Configure post-wipe cooldowns per kit.
• Configure premium kit names and locked-kit labels.
• Customize the panel, disabled, action, and purchase colors.
• Set a default kit image and view icon image.
• Set a local title image path and ImageLibrary identifier.
• Set fallback title text when the local image is unavailable.
• Add optional store link and store note text.
• Configure CopyPaste parameters.
• Configure NPC-specific kit menus.
• Edit all player notifications, error messages, commands, and UI labels through language files.

Developer API

RustKits includes a developer API for plugin integrations and custom server systems.

• GiveKit - Give a configured kit to a player.
• IsKit - Check whether a kit exists.
• GetKitNames - Retrieve the available kit names.
• GetKitObject - Retrieve complete kit data.
• GetKitImage - Retrieve a kit image reference.
• GetKitDescription - Retrieve a kit description.
• GetKitCooldown - Retrieve a kit cooldown.
• GetKitMaxUses - Retrieve the maximum usage limit.
• GetPlayerKitUses - Retrieve player usage data.
• SetPlayerKitUses - Change player usage data.
• GetPlayerKitCooldown - Retrieve a player's remaining cooldown.
• SetPlayerCooldown - Set a player's kit cooldown.
• CreateKitItems - Create the items configured in a kit.

Compatibility

RustKits is compatible with Carbon and Oxide/uMod Rust servers.

ImageLibrary is required for full title and kit image functionality. CopyPaste, Economics, ServerRewards, PlayerDLCAPI, and HumanNPC are optional integrations that can be enabled when needed.