BM Blackmatic Plugins
CustomPotions
Rust Plugin

CustomPotions

Adds custom consumable potions with configurable health and metabolism effects, custom skins, chat commands, and optional Discord webhook logging.

Working v1.0.0 Support: active Author: Blackmatic
Downloads are available for registered users only.

Create account Login

Registered users can report plugin problems directly from this page.

Description

Custom Potions is a Rust plugin that allows you to add special consumable items with custom effects to your server.
Players can receive unique potion-style items through chat commands, and when consumed, these items can increase maximum health and boost metabolism for a configurable duration.

The plugin currently supports two custom consumables:

Super Serum
Pure Health Tea

Each item can be fully configured in the config file, including:

max health increase
metabolism boost
duration
skin ID
custom item name

In addition, the plugin supports optional Discord webhook logging for both item distribution and item usage, making it easy to track activity on your server.

Features

  • Adds custom potion-style consumables to Rust
  • Configurable health boost
  • Configurable metabolism boost
  • Configurable effect duration
  • Custom skin IDs
  • Custom item names
  • Chat commands to give players the items
  • Permission-based access control
  • Optional Discord webhook logging
  • Separate settings for each item
  • Lightweight and easy to configure

Commands

  • /stahl
  • Gives the player Super Serum
  • /plutonium
  • Gives the player Pure Health Tea

Permissions

  • custompotions.superserum
  • Required to use /stahl
  • custompotions.purehealthtea
  • Required to use /plutonium

Installation

Upload CustomPotions.cs to your server’s oxide/plugins folder
Reload the plugin or restart the server
The plugin will automatically generate its config file
Open the config file and adjust the settings as needed
Grant the required permissions to players or groups
Test the commands in-game

Troubleshooting

Command does not work

Make sure the player has the required permission:

custompotions.superserum
custompotions.purehealthtea
Item is not using the correct name or skin

Check the config values for:

Skin ID
Custom Name
Effects are too weak or too strong

Adjust these values in the config:

Max Health Increase
Metabolism Boost
Duration (seconds)
Discord logging is not working

Make sure:

Enabled is set to true
the webhook URL is valid
your server can reach Discord
Plugin config seems broken

Delete the config file and reload the plugin so a fresh default config is generated.

Compatibility

Mod Framework: uMod / Oxide
Designed for servers running standard Rust plugin environments
Can be used on PvP, PvE, modded, and custom gameplay servers

Config preview

{
  "Config Version": 1,
  "Discord Webhook": {
    "Enabled": false,
    "Webhook URL": "",
    "Username": "CustomPotions",
    "Avatar URL": "",
    "Log Item Give (Commands)": true,
    "Log Item Use (Consume)": true
  },
  "SuperSerum Settings": {
    "Max Health Increase": 900.0,
    "Metabolism Boost": 50.0,
    "Duration (seconds)": 300.0,
    "Skin ID": 3412057437,
    "Custom Name": "Super Serum"
  },
  "PureHealthTea Settings": {
    "Max Health Increase": 20.0,
    "Metabolism Boost": 25.0,
    "Duration (seconds)": 300.0,
    "Skin ID": 3412057437,
    "Custom Name": "Pure Health Tea"
  }
}

Was this plugin useful?

Helpful: 0 | Needs work: 0

Changelog