Metabolism Control

Metabolism Control 1.2.0

Override player metabolism stats like health, calories, and hydration
Documentation License Changelog (2) Reviews (1) Version History Discussion
Metabolism Control gives you precise control over player metabolism mechanics. Instead of relying on Rust's default metabolism system, you can set custom starting values for health, calories, and hydration when players connect or respawn. The plugin also allows you to adjust drain rates, set maximum values, prevent specific stats from decreasing, and even pause metabolism entirely when players reach certain comfort levels.

The plugin uses a priority-based profile system, allowing you to create different metabolism configurations for different player groups (VIP, admin, etc.) based on permissions. This makes it ideal for PvE servers, custom game modes, or providing perks to donating players.

Features

  • Set custom health, calories, and hydration values on player connect and/or respawn
  • Configure maximum values for health, calories, and hydration
  • Prevent calories and hydration from decreasing (set to -1)
  • Adjust drain rates with multipliers (make hunger/thirst drain faster or slower)
  • Pause metabolism when players reach a certain comfort level
  • Priority-based profile system for different player groups

Permissions

The plugin uses a flexible permission system where you define permissions in the configuration file. Each profile can have its own permission requirement.

Permission Format

  • Short form: vip (automatically becomes metabolismcontrol.vip)
  • Explicit form: metabolismcontrol.vip
  • Dotted form: something.vip (becomes metabolismcontrol.something.vip)

Example Permissions

  • metabolismcontrol.vip -- For VIP players
  • metabolismcontrol.admin -- For administrators
  • metabolismcontrol.donor -- For donors

Configuration

JSON: 
{
  "Version": "1.2.0",
  "Apply On Connect": true,
  "Apply On Respawn": true,
  "Default Values (used if no profile matches)": {
    "Calories (set to -1 to stop decreasing)": 500,
    "Hydration (set to -1 to stop decreasing)": 250,
    "Health": 100,
    "Maximum Calories (set to 0 to ignore)": 0,
    "Maximum Hydration (set to 0 to ignore)": 0,
    "Maximum Health (set to 0 to ignore)": 0,
    "Calories Drain Multiplier (0 or 1 = normal, 0.5 = half, 2 = double)": 1.0,
    "Hydration Drain Multiplier (0 or 1 = normal, 0.5 = half, 2 = double)": 1.0,
    "Pause Metabolism At Comfort Threshold (0 = disabled, 1.0 = max comfort)": 0.0
  },
  "Update Current And Maximums On Reload (false = max only)": false,
  "Profiles": [
    {
      "Enabled": true,
      "Permission (e.g., vip or metabolismcontrol.vip)": "vip",
      "Priority (higher wins)": 10,
      "Values": {
        "Calories (set to -1 to stop decreasing)": 500,
        "Hydration (set to -1 to stop decreasing)": -1,
        "Health": 100,
        "Maximum Calories (set to 0 to ignore)": 0,
        "Maximum Hydration (set to 0 to ignore)": 0,
        "Maximum Health (set to 0 to ignore)": 0,
        "Calories Drain Multiplier (0 or 1 = normal, 0.5 = half, 2 = double)": 1.0,
        "Hydration Drain Multiplier (0 or 1 = normal, 0.5 = half, 2 = double)": 1.0,
        "Pause Metabolism At Comfort Threshold (0 = disabled, 1.0 = max comfort)": 1.0
      }
    }
  ]
}

Global Settings

  • Apply On Connect -- Applies metabolism values when players connect to the server
  • Apply On Respawn -- Applies metabolism values when players respawn after dying
  • Update Current And Maximums On Reload -- When true, both current values and maximums update on reload; when false, only maximums update

Default Values

These values are applied to players who don't have permission for any enabled profile.
  • Calories -- Starting calories value, or -1 to prevent calories from ever decreasing
  • Hydration -- Starting hydration value, or -1 to prevent hydration from ever decreasing
  • Health -- Starting health value when metabolism is applied
  • Maximum Calories -- Sets the maximum calories a player can have, 0 uses Rust's default
  • Maximum Hydration -- Sets the maximum hydration a player can have, 0 uses Rust's default
  • Maximum Health -- Sets the maximum health a player can have, 0 uses Rust's default
  • Calories Drain Multiplier -- Multiplier for how fast calories drain
  • Hydration Drain Multiplier -- Multiplier for how fast hydration drains
  • Pause Metabolism At Comfort Threshold -- Pauses calorie and hydration drain when player comfort reaches this value

Profiles

Profiles allow different metabolism configurations for different player groups based on permissions. When multiple profiles match a player, the highest priority profile is used.
  • Enabled -- Whether this profile is active
  • Permission -- The permission required for this profile to apply
  • Priority -- Used when a player has multiple matching profiles, higher priority wins
  • Values -- Contains the same settings as "Default Values" section above
Author
VisEntities
License duration
Unlimited
Price
7.99 USD
First release
Last update

Ratings

5.00 star(s) 1 reviews
Donate

Also by VisEntities

Latest updates

  1. 1.2.0

    Added Pause Metabolism At Comfort Threshold option, allowing players to AFK indefinitely at max...

  2. 1.1.0

    Added support for customizing how fast calories and hydration drain.
Read more…

Latest reviews

PistOffBastd
Fantastic plugin, clean and simple. Adjusting your players metabolismis a great way to change how the game is played. Excellent job Vis
Upvote 0 Downvote
Read more…
Back
Top
Chat commands start with a /, while console commands can be entered directly in the F1 console or server console. Use find <keyword> in console to search for available commands related to the plugin. Parameters in < > are required, while [ ] are optional.
This plugin uses Oxide's permission system. Grant or revoke permissions using oxide.grant and oxide.revoke. You can assign them to individual players or groups using their Steam id or group name.
Settings are stored in the config file found under the config/ directory. You can edit this file manually, then reload the plugin to apply your changes.
Persistent data is saved in the data/ directory. This includes things like saved settings, usage stats, or player progress depending on the plugin. Deleting a data file will reset stored progress or customizations.
Language files are located in the lang/ folder. To translate messages, copy the en.json file into your target language folder (e.g. fr, de) and edit the values. Reload the plugin after changes to apply new messages.
This section lists public methods exposed by the plugin for use in other plugins. You can call these via the CallHook method. Ensure the plugin is loaded before calling its API to avoid null reference errors.
These are custom hooks that other plugins can listen for. Simply define a method with the same name and expected parameters in your plugin to handle the event. Hooks are triggered at key moments and are useful for extending or reacting to plugin behavior.
These hooks are injected into the game's code using Harmony. They let the plugin run code at key points in the game's internal logic. You can return values to block or modify behavior. Use with caution — these are powerful and can affect core mechanics.
Cart

Cart

Total -