Kits 2.0.3

Unique kit system with the highest possible functionality and beautiful design. This will please you (no need to sit in the config every time and try to fill in some incomprehensible values, etc.), and your players (convenient, clear and informative interface). You just start editing items directly in the game) and your players (comfortable, clear, informative interface)!

 

 Features of Our Kits

• Beautiful User Interface: Experience a visually appealing and user-friendly design.
• High Performance: Optimized for fast, reliable performance.
• Automatic Kit Conversion (uMod): Easily convert your existing kits.
• In-Game Kit and Item Setup: Configure kits directly in the game.
• Auto Kits & Wipes (Optional): Automate kit distribution and server wipes.
• Custom Items & Commands: Assign unique items and commands to kits.
• Advanced Item Settings: Fine-tune every aspect of your items.
• CopyPaste Integration: Seamlessly work with CopyPaste.
• Optional Features: Delays after wipes, set blocking in Building Block, logging, and item chances.
• Skills & ServerPanel Support: Enhance player experience with integrated support.

 Commands

• kit – open the kit interface
• kit help – get help with kits
• kit autokit – enable or disable autokit
• kit list – display all available kits
• kit [name] – redeem a specific kit
• kits.resetkits – delete all kits
• kits.give [name/steamid] [kitname] – grant a kit to player
• kits.convert – convert from uMod Kits
• kits.wipe – clear players data
• kits.reset – resets the player data or kits in the kits system.
  • kits.reset data [<targetID>/all] – resets the data of a player or all players.
    Parameters:
    <targetID>: The ID of the player whose data is to be reset. If you specify all, the data of all players will be reset.
  • kits.reset kits – resets all kits in the data
• kits.template [fullscreen/inmenu] [old_style/new_rust] [target_template] – sets the interface template for kits.
  Parameters:
  • [fullscreen/inmenu]: Type of interface template to set. Valid values: fullscreen or inmenu.
  • [old_style/new_rust]: Interface style. Valid values: old_style or new_rust.
  • [target_template]: For the inmenu template, you must specify the template number (1 or 2).

 

 Video

P.S. Video of the old version, video for the V2+ version is now in development

 

 Showcase

Full screen Templates

• Template OLD STYLE

• Template NEW RUST

In-Menu Templates

• Template V1 (V1.1)

• Template V2

Editor

 

 TEST SERVER

Join our test server to view and experience all our unique features yourself!
Copy the IP Address below to start playing!

connect 194.147.90.147:28015

 

 FAQ

Q: Where can I see an example of a config?
A:  Config

Q: Where can I see an example of a data?
A:  Data

Q: I have a question/problem. What should I do?
A: You can write to me in a PM on the site, create a ticket. Or write me in Discord: Mevent#4546

Q: Does the Kits plugin support other plugins?
A: Yes, this Kits plugin has an API similar to other popular kits plugins. If the plugin works with Kits - it works with this plugin too.

Q: How do I enable the sale of kits?
A: You need to configure the plugin economy (which plugin, its hooks, etc.), enable "Enable sale" in the Kits data (oxide/data/Kits/Kits.json or carbon/data/Kits/Kits.json) and set the price to "Selling price"

"Enable sale": true,
"Selling price": 100,

Q: How do I use Economics to pay for kits?
A: Example configuration settings:

  "Economy": {
    "Type (Plugin/Item)": "Plugin",
    "Plugin name": "Economics",
    "Balance add hook": "Deposit",
    "Balance remove hook": "Withdraw",
    "Balance show hook": "Balance",
    "ShortName": "",
    "Display Name (empty - default)": "",
    "Skin": 0
  },

Q: How do I use ServerRewards to pay for kits?
A: Example configuration settings:

  "Economy": {
    "Type (Plugin/Item)": "Plugin",
    "Plugin name": "ServerRewards",
    "Balance add hook": "AddPoints",
    "Balance remove hook": "TakePoints",
    "Balance show hook": "CheckPoints",
    "ShortName": "",
    "Display Name (empty - default)": "",
    "Skin": 0
  },

Q: How do I use scrap to pay for kits?
A: Example configuration settings:

  "Economy": {
    "Type (Plugin/Item)": "Item",
    "Plugin name": "",
    "Balance add hook": "",
    "Balance remove hook": "",
    "Balance show hook": "",
    "ShortName": "scrap",
    "Display Name (empty - default)": "",
    "Skin": 0
  },

Q: How do I resize the kit image?
A: You can do this in the config, here's an example of the image setup (-32 and 32 are width, and -75 and -11 are height

    "Image Settings": {
      "AnchorMin": "0.5 1",
      "AnchorMax": "0.5 1",
      "OffsetMin": "-32 -75",
      "OffsetMax": "32 -11"
    },

Q: How can I remove the numbers on the kits ("#1", "#2", etc.)?
A: You need to turn off "Show Number?" in the config:

 "Show Number?": false,

Q: How do I make it so that others can see kits with different permissions without being able to claim them? 
A: You need to turn off "Show All Kits?" in the config:

 "Show All Kits?": true,

Q: Where can I edit the names in the plugin or add my own language?
A: You can edit lang files that are located (for example) at "oxide/lang/en/Kits.json" or "carbon/lang/en/Kits.json".

 

 CONTACTS

 

 HOOKS

private string[] canRedeemKit(BasePlayer player)
private void OnKitRedeemed(BasePlayer player, string kitName)
private double OnKitCooldown(BasePlayer player, double cooldown)

 

 API

private bool TryClaimKit(BasePlayer player, string name, bool usingUI)
private string[] GetAllKits()
private object GetKitInfo(string kitname)
private string[] GetKitContents(string kitname)
private double GetKitCooldown(string kitname)
private double PlayerKitCooldown(ulong ID, string kitname)
private int KitMax(string kitname)
private double PlayerKitMax(ulong ID, string kitname)
private string KitImage(string kitname)
private bool IsKit(string kitname)
private bool isKit(string kitname)
private void GetKitNames(List<string> list)
private double GetPlayerKitCooldown(ulong userId, string name)
private double GetPlayerKitCooldown(string userId, string name)
private void SetPlayerCooldown(ulong userId, string name, int amount)
private int GetPlayerKitUses(ulong userId, string name)
private int GetPlayerKitUses(string userId, string name)
private void SetPlayerKitUses(ulong userId, string name, int amount)
private JObject GetKitObject(string name)
private int GetKitMaxUses(string name)
private string GetKitDescription(string name)
private string GetKitImage(string name)
private bool GiveKit(BasePlayer player, string name, bool usingUI)
private bool HasKitAccess(string userId, string name)
private int GetPlayerKitAmount(string userId, string name)