MBKits






🌟 MBKits - Modern Kit UI with Previews, Cooldowns, AutoKits & Permissions
MBKits is a modern, fully customizable and visually refined Rust plugin for managing player kits through an advanced UI.
It features a polished interface, animated intro images, detailed kit previews, cooldowns, autokits, pop-up notifications, flexible permissions, item skins, ammo support, and deep integration with systems.
⭐ Core Features
🎨 Beautiful Modern UI
- Clean scrollable interface with a 3-column grid for kits.
- Fully image-driven design (backgrounds, kit icons, overlays).
- Optional animated intro images on player connect.
- Supports custom images for individual kits.
🔍 View Kit Contents
- Players can preview every item inside a kit:
- Detailed inventory layout: Main, Belt, Wear.
- Supports custom skins, modded items, nested contents.
- Shows weapon ammo, attachments, and item quantities.
- Supports custom icons per item via custom image keys.
⏳ Advanced Cooldown System
- Per-kit cooldowns: 1h, 30m, 2d4h, etc.
- UI shows exact remaining cooldown time.
- Cooldowns persist through server restarts.
- Per-player cooldowns stored in data files.
🔐 Permission Support
- Each kit can require its own permission.
- Permissions auto-register if missing.
- UI reacts to permission state:
- No access → greyed-out button.
- Hidden kits optionally supported.
🎁 Claim System
- Checks if the player has enough space before giving the kit.
- Fully supports skins, ammo, attachments, modded weapons.
- Smart fallback logic if the intended slot is occupied.
- Custom commands per kit item using {playerid} and {name}.
- Success & error popups using dynamic UI with icons.
🌐 Multi-language Support
- Built-in languages:
- 🇺🇸 English
- 🇷🇺 Russian
- 🇺🇦 Ukrainian
- All UI text and messages are fully localized and stored in separate language files.
🛠 Admin Tools
➕ Create / Remove Kits
- Create kit from your inventory:
-
/dkit add <name> [permission]
- Saves main, belt, wear containers.
- Automatically creates a permission if not supplied.
- Sets default cooldown.
❌ Remove a kit:
-
/dkit remove <name>
-
Deletes the kit.
-
Clears all cooldowns for all players.
🎯 Create / Remove AutoKits
-
/akit add <name> /akit remove <name>
🔑 Permission System
- Requires mbkits.admin to manage kits.
- Kit permissions auto-create: mbkits.<kitname>
- Autokits: mbkits.autokit.<name>
📘 Commands
- Command Description
- /kits Opens the main kit UI
- /dkit add <name> Creates a new kit from your current inventory
- /dkit add <name> <permission> Creates a kit with a custom permission
- /dkit remove <name> Deletes a kit and clears all cooldown data
- /akit add <name> Creates a hidden AutoKit from your inventory
- /akit remove <name> Removes an AutoKit
📁 Data Files
Stored under:
oxide/data/MBSystem/MBKits/
- MBKits_kits.json - player kits
- MBKits_cooldowns.json - per-player cooldowns
- MBKits_uses.json - usage limits
- MBKits_autokits.json - hidden autokits