Depends on
Required for this file to work correctly.
Works with
Optional integrations and compatible files.
About Consumable Effects
Create custom consumable effects. Instant metabolism, over-time effects, movement speed, tea boosts, and more.
Feature Overview
|
Instant + Timed Effects
Apply calories, hydration, health, regen, bleeding, poison, radiation, and dirty on consume. Add effect-over-time ticks for oxygen, comfort, temperature, and more.
|
In-Game Admin Editor
Create, edit, test, give, and delete effects from a full UI. No JSON editing required for day-to-day setup. Overdose settings live in the same menu.
|
|
Tea Boosts & Feedback
Stack Rust modifiers like Move Speed, Scrap Yield, and Clotting. Pair them with screen overlays, consume FX, hold tooltips, and custom vital timers on the HUD.
|
Optional Overdose
Effects can raise Rust's dirty metabolism. Past the dirty threshold, the player still gets the positive effect, plus a separate overdose effect you configure. Leave dirty at 0 and it never triggers.
|
How it works
Each effect is keyed by a custom item name. When a player consumes (or uses as a medical tool) an item whose name matches that key, ConsumableEffects applies your configured result instead of the vanilla consume behavior.
Set a base shortname and skin in the editor so you can Give the item from the admin UI. For loot, kits, or shops, spawn the same shortname/skin and set the item name to the effect key (for example Combat Tea).
https://www.youtube.com/watch?v=IafSWFMSKxs
Commands
Note
Admin menu requires auth level admin or the permission consumableeffects.admin.
| Command | Description |
|
/consumableeffects CHAT ONLY |
Opens the admin UI to list, create, edit, test, give, and delete consumable effects, plus overdose settings. |
Frequently Asked Questions
Can players see what an item does?
The default item description cannot be changed. That is a game limitation, since descriptions are client-side. Set a tooltip on the effect instead. When the player holds the custom item, a tooltip pops up on their screen explaining what it does. Timed effects also appear as custom vitals on the HUD for their remaining duration.
How does the plugin know which item to affect?
By custom item name. The effect dictionary key must match item.name. Shortname and skin are only used as references for giving and identifying the item visually.
Does it work with syringes and medical tools?
Yes. Named medical items are handled on use the same way food and drink consumables are handled on consume.
What are tea boosts?
Native Rust modifiers (Move Speed, Scrap Yield, Clotting, Max Health, radiation resistances, and others). Enable Tea Boost on an effect, pick one or more types, then set value and duration.
How does overdose work?
Optional. If enabled, effects that add dirty raise the player's dirtyness. Crossing the dirty limit still applies the positive effect and also applies the configured overdose effect. While overdose is active, the player cannot start another consumable effect. Leave dirty at 0 on your effects if you do not want this system.
Where are effects stored?
In the plugin config under Effects. Older installs that used a separate data file are migrated into the config automatically on load.
Help
|
Have more questions? Reach out to us on Discord if you need support or have a custom request. |
|
