Heal

⭐ Premium

Requires the player to restore health using specified items, such as food or medical items. amountRequired is measured in raw HP restored.

{
  "type": "Heal",
  "title": "Patch up your team",
  "description": "",
  "amountRequired": 500,
  "conditions": {},
  "items": ["syringe.medical", "largemedkit"],
  "target": "Others"
}

Fields

Field	Type	Description
`type`	string	Exactly 'Heal'.
`title`	string	Short, human-readable name. Must not be empty.
`description`	string	A blurb of 1 to 3 sentences. May be empty if the title is self-explanatory.
`amountRequired`	integer (≥ 1)	How many points of health the player must restore.
`cooldown`	object \| null	Optional pacing limit on how fast progress adds up: at most maxAmount units of progress count in any sliding window of windowSeconds. Absent means progress adds up freely. While the window's budget is used up, further progress is ignored and the player sees a countdown to the next available moment.
`burst`	object \| null	Optional clustering requirement: actions only count when they arrive clustered, at least amount units within one trailing window of windowSeconds forming one burst. When present, amountRequired counts completed bursts instead of raw actions. Actions that age out of the window without completing a burst never count. Absent means no clustering.
`conditions`	map	Optional conditions that restrict when progress counts. Progress is recorded only when the objective's main requirement and all of these conditions are met. Use an empty map for none.
`hideDetails`	boolean	When true, hides this objective's in-game condition strip and details popup, so the description is the only explanation players get. Title, description and progress still show. Absent means false.
`items`	string[]	Rust item shortNames, lowercase dotted (e.g. rifle.ak, rifle.bolt, wood, stones, metal.fragments, scrap, hqm, lowgradefuel).
`target`	enum: Any \| Self \| Others	Whether the heal must target self, others, or either.

Notes

Progress increments by the HP actually restored, clamped to the target’s missing health. Over-healing past full HP does not count, and healing a full-health target counts nothing.
target controls whose healing qualifies:
- Self: only healing yourself.
- Others: only healing other players.
- Any: either.