Relative Item Cooldown (Item Condition Type)

Compares how much of the stack's use cooldown is left, as a fraction from 1.0 (just used, with the full cooldown left) down to 0.0 (ready). It fails when nothing is holding the stack.

Type ID: apoli:relative_item_cooldown

Fields

FieldTypeDefaultDescription
comparisonComparisonrequiredHow to compare: <, <=, >, >=, == or !=.
compare_toFloatrequiredThe fraction to compare against, from 0.0 to 1.0.

Example

Glow while an ender pearl is still on cooldown, so the player can see when it is ready without watching the icon:

{
  "type": "apoli:self_glow",
  "condition": {
    "type": "apoli:equipped_item",
    "equipment_slot": "mainhand",
    "item_condition": {
      "type": "apoli:relative_item_cooldown",
      "comparison": ">",
      "compare_to": 0.0
    }
  }
}

Or only allow something once more than half of the cooldown has passed:

{
  "type": "apoli:relative_item_cooldown",
  "comparison": "<",
  "compare_to": 0.5
}