Player Hydration

⭐ Premium

Progress counts only when the hydration of the player performing the action is within the specified bounds at that instant. This is the water number on the vitals HUD, which runs from 0 to 250.

{
  "type": "PlayerHydration",
  "maxHydration": 25
}

Fields

Field	Type	Description
type	string	Exactly 'PlayerHydration'
minHydration	number | null	Minimum hydration. Null (or omitted) means no lower bound.
maxHydration	number | null	Maximum hydration. Null (or omitted) means no upper bound.

Notes

• The thirsty warning shows at low hydration, around 25 and below. Dehydration damage starts at 20 or below, and sprinting locks at exactly 0. So “while thirsty” is maxHydration: 25.
• The abundance direction works too: “while fully hydrated” is something like minHydration: 200.
• Running hot (temperature above 40) drains hydration, so desert-themed contracts can combine this with Player Temperature.
• Either bound can be null (or omitted entirely) for “no limit on that side”, but at least one bound is required. A condition with neither bound would always be satisfied, so it is invalid and the contract will not load.
• If minHydration is greater than maxHydration, the plugin swaps them and logs a warning.

Examples

Kill 5 scientists while thirsty:

{
  "type": "Kill",
  "amountRequired": 5,
  "entities": ["scientistnpc_full_any"],
  "conditions": {
    "thirsty": {
      "type": "PlayerHydration",
      "maxHydration": 25
    }
  }
}