Supplement Items
A supplement is an inventory item a player uses to get a timed boost while training. This page decides which items count as supplements and what they do.
Eight of them ship with the script and are already configured, so you only come here to change their numbers or to add your own.
The three boost types
| Boost Type | Effect |
|---|---|
| XP Bonus | More XP from every rep. |
| Fatigue Reduction | Less fatigue per rep, so the player can train longer before their muscles give out. |
| Minigame Chance | A chance that a rep's minigame passes itself, with no input needed. |
An item can carry more than one boost. Hardcore Stack, for example, gives XP and fatigue reduction at the same time.
Adding a supplement
Open Supplement Items in the sidebar
The counter at the top says how many are configured.
Click Add Item
A New Item card appears.
Fill in Item ID
The spawn name of the item exactly as your inventory knows it, for example gym_iron_surge. The display name is read from your inventory, so it only appears after you save and reopen the page.
Pick the Boost Type
Set Boost % and Duration (minutes)
The card summarizes it back to you as XP Bonus +20% for 60 min.
Click Save
Restart the resource
Saving writes to the database but does not live-reload. The interface tells you so.
The item has to exist in your inventory first, with an image, or it can never be given out or used. See the items step in installation.md.
What ships by default
| Item | Boost |
|---|---|
gym_iron_surge | +20% XP for 1 hour |
gym_pump_juice | +20% minigame auto-pass for 1 hour |
gym_ripped_recovery | -25% fatigue for 1 hour |
gym_hardcore_stack | +15% XP and -15% fatigue for 1.5 hours |
gym_beast_mode_fuel | +25% XP and +10% auto-pass for 2 hours |
gym_apex_predator | +20% XP, -20% fatigue and +10% auto-pass for 2 hours |
gym_american_mass | +20% XP and -20% fatigue for 3 hours |
gym_king_of_iron | +30% XP, -25% fatigue and +15% auto-pass for 3 hours |
Where players get them
Active boosts are shown on the gym menu's Dashboard, under Supplement Bonuses, with the time left on each.
If you run the business module, supplements are stocked in the gym's warehouse and sold from its shop. Without it, hand them out however your server normally sells items.