Customizable Protection

depends on

Custom Item Definitions

Works with

About Customizable Protection

This is a powerful tool that allows you to customize the protection of wearable items in the game. With this plugin, admins can create their own items with their own protection values and customize the protection of existing items. This means that players can adjust the protection to their playing style, which gives them an advantage in combat.

One of the distinguishing features of the plugin is its ability to allow players to take damage from NPCs on PVE servers depending on the equipment worn. This adds a new level of realism to the game, as players must carefully consider their defense when interacting with NPCs. It also encourages players to invest time and resources into building better gear, as better gear means better protection.

The ability to customize protection values, create custom items, and enable NPC damage on PVE servers makes it an indispensable tool for any Rust server.

Features

Appearance of item protection for players on PVE servers from NPC damage
Detailed adjustment of protection for any wearable item
Item setup files are all separately in their own file and folder, making it easy to customize items
Setting up a defense for a player without everything
The ability to create your own items, with their own protection, name and skinid

Permissions

customizableprotection.give 		for give command
customizableprotection.icon.show
customizableprotection.icon.hide

Console Commands

cp.give <custom item name> - Give yourself a custom item
cp.give <steamid> <custom item name> - Give the player a custom item
cp.create - Add a custom item based on the image of another item
cp.reload - Quick reloading of items

File hierarhy:

  • CustomizableProtection
     ↳ • Custom
          ↳ example1.json
          ↳ example1.json
     ↳ • Default
          ↳ attire.banditguard.json
          ↳ attire.bunny.onesie.json
          ↳ attire.bunnyears.json
          ↳ attire.egg.suit.json
          ↳ attire.hide.boots.json
          ↳ attire.hide.helterneck.json
          ↳ attire.hide.pants.json
          ↳ attire.hide.poncho.json
          ↳ attire.hide.skirt.json
          ↳ ... etc.

Custom item settings:

{
  "Shortname": "partyhat",
  "Unique SkinId": 111,
  "Name": "Cap of Fortune",
  "Description": "Even though it looks silly, it can save!",
  "UI Settings": {
    "Name Color (or use <color></color> in name)": "1 1 1 1",
    "Frame Color": "0.94 0.75 0.15 1"
  },
  "Protection": {
    "Hunger": 0.0,
    "Thirst": 0.0,
    "Cold": 0.0,
    "Drowned": 100.0,
    "Heat": 0.0,
    "Bleeding": 0.0,
    "Poison": 0.0,
    "Suicide": 0.0,
    "Bullet": 0.0,
    "Slash": 0.0,
    "Blunt": 0.0,
    "Fall": 100.0,
    "Radiation": 0.0,
    "Bite": 0.0,
    "Stab": 0.0,
    "Explosion": 0.0,
    "RadiationExposure": 100.0,
    "ColdExposure": 100.0,
    "ElectricShock": 0.0,
    "Arrow": 0.0,
    "OxygenExposure": 100.0
  }
}

Default item settings:

{
  "Hunger": 0.0,
  "Thirst": 0.0,
  "Cold": 0.0,
  "Drowned": 0.0,
  "Heat": 0.0,
  "Bleeding": 0.0,
  "Poison": 0.0,
  "Suicide": 0.0,
  "Bullet": 10.0,
  "Slash": 15.0,
  "Blunt": 15.0,
  "Fall": 0.0,
  "Radiation": 0.0,
  "Bite": 45.0,
  "Stab": 10.0,
  "Explosion": 0.0,
  "RadiationExposure": 2.0,
  "ColdExposure": 25.0,
  "ElectricShock": 0.0,
  "Arrow": 10.0,
  "OxygenExposure": 0.0
}

Default Config:

{
  "Icon Position (0 - Off | -1 - left by 1 slot, 1 - right by 1 slot | ..)": -1,
  "Lock values at normal values": true,
  "Protection Multipliers": {
    "Common": 1.0,
    "Types": {
      "Hunger": 1.0,
      "Thirst": 1.0,
      "Cold": 1.0,
      "Drowned": 1.0,
      "Heat": 1.0,
      "Bleeding": 1.0,
      "Poison": 1.0,
      "Suicide": 1.0,
      "Bullet": 1.0,
      "Slash": 1.0,
      "Blunt": 1.0,
      "Fall": 1.0,
      "Radiation": 1.0,
      "Bite": 1.0,
      "Stab": 1.0,
      "Explosion": 1.0,
      "RadiationExposure": 1.0,
      "ColdExposure": 1.0,
      "ElectricShock": 1.0,
      "Arrow": 1.0,
      "OxygenExposure": 1.0
    }
  },
  "Default Protection": {
    "Hunger": 0.0,
    "Thirst": 0.0,
    "Cold": 0.0,
    "Drowned": 0.0,
    "Heat": 0.0,
    "Bleeding": 0.0,
    "Poison": 0.0,
    "Suicide": 0.0,
    "Bullet": 0.0,
    "Slash": 0.0,
    "Blunt": 0.0,
    "Fall": 0.0,
    "Radiation": 0.0,
    "Bite": 0.0,
    "Stab": 0.0,
    "Explosion": 0.0,
    "RadiationExposure": 0.0,
    "ColdExposure": 0.0,
    "ElectricShock": 0.0,
    "Arrow": 0.0,
    "OxygenExposure": 0.0
  }
}