David

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.