ProtectiveVest

Project details

Project: ProtectiveVest
dev language: c# oxide
Plugin language: en (incl. de, fr, es, it, tr, ru, uk)
Author: @RustFlash

ProtectiveVest adds consumable vests that players activate from their hotbar via a hold-to-equip action.
After a successful equip, 1 vest is consumed and the player gains temporary bonus max HP (and is healed up to that new max).

The effect lasts until death. Optionally, you can configure the vest to be consumed/removed once health drops below a threshold, so players can activate another vest again.

• Hold-to-equip from hotbar (no chat commands)
• Consumes 1 item on successful activation
• Adds bonus max health and heals up to the new max immediately
• Optional auto reset below HP (removes the active vest once HP drops below a configured threshold)
• Built-in equip progress UI with multiple styles
• One active vest at a time (no stacking)

• No commands.

1. protectivevest.use — Allows using protective vests.

1. Put a configured vest item into your belt/hotbar.
2. Select it as your active item.
3. Hold the USE key until equip completes. Releasing USE cancels.
4. When completed, 1 item is consumed and the vest bonus is applied.

Equip will cancel if the player:

• releases USE
• switches active item / changes away from the vest item
• moves the item out of the belt
• changes the item (UID/skin/shortname mismatch) while holding

The plugin defines multiple vest entries by ItemShortName + SkinID.

{
  "UI": {
    "Style": "HorizontalBar",
    "Enabled": true,
    "UpdateIntervalSeconds": 0.10,
    "BackgroundAlpha": 0.65,
    "BarAlpha": 0.90
  },
  "Vests": [
    {
      "Name": "Aramid Armor Vest",
      "ItemShortName": "wood.armor.jacket",
      "SkinID": 3643174653,
      "BonusHealth": 50.0,
      "EquipDurationSeconds": 5.0
    }
  ],
  "AutoResetBelowHealth": 100.0,
  "ActiveVestsCheckIntervalSeconds": 0.75
}

• UI.Enabled
  Enable/disable the equip progress UI (equip still works when disabled).

• UI.Style
  UI style name. Valid values are:

  • HorizontalBar
  • CircularProgress
  • MinimalCorner
  • LargeCenter

  If an invalid style is set, it falls back to HorizontalBar.

• UI.UpdateIntervalSeconds
  How often the UI updates while holding USE. (Minimum is enforced internally.)

• UI.BackgroundAlpha / UI.BarAlpha
  Opacity values (0–1).

If you want to reference or debug the CUI elements, the plugin uses these fixed IDs:

• UI root: ProtectiveVest.UI
• Bar container: ProtectiveVest.UI.Bar

Each vest entry supports:

• Name — Display name in messages/UI
• ItemShortName — Rust item shortname
• SkinID — Skin ID to identify a specific skinned item
• BonusHealth — Bonus max HP granted on activation
• EquipDurationSeconds — Time (seconds) required to hold USE to equip

Notes:

• BonusHealth and EquipDurationSeconds are clamped internally to prevent broken values.

• AutoResetBelowHealth
  If <= 0, this feature is disabled.
  If > 0, the plugin periodically checks active vest users and removes the active vest when their HP drops below the threshold.

• ActiveVestsCheckIntervalSeconds
  How often the plugin checks active vests (only used if AutoResetBelowHealth > 0).

Built-in translations are included for:

• en (default)
• de
• fr
• es
• it
• tr
• ru
• uk

Configured vest items are blocked from being worn. They’re meant to be consumed from the hotbar.

No. Only one vest can be active at a time.

• On death (and it is cleared on respawn/disconnect).
• Optionally earlier if AutoResetBelowHealth is enabled and HP drops below the configured threshold.

load, run, enjoy 💝