🌍Environment and Location Conditions

Every registered condition on this page is documented as an independent reference entry. All entries also support the common condition fields documented on the Power Conditions page.

Registry keys on this page

• in_water

• in_lava

• in_rain

• in_sunlight

• in_structure

• light_level

• clear_weather

• thunder

• world

• night

• environment

---

in_water

Purpose: Checks Bukkit's Entity#isInWater state.

Context: Default target: TARGET; requires an entity.

Fields

Field	Default	Description
target	TARGET	Entity selector.
value	true	Expected state.

Example

type: in_water
target: SOURCE
value: true

Behavior and limits

• The selected entity must exist.

---

in_lava

Purpose: Checks whether the block at the selected entity's feet is lava.

Context: Default target: TARGET; requires an entity.

Fields

Field	Default	Description
target	TARGET	Entity selector.
value	true	Expected state.

Example

type: in_lava
target: SOURCE
value: true

Behavior and limits

• This checks the current feet block material.

---

in_rain

Purpose: Checks Bukkit's Entity#isInRain state.

Context: Default target: TARGET; requires an entity.

Fields

Field	Default	Description
target	TARGET	Entity selector.
value	true	Expected state.

Example

type: in_rain
target: SOURCE
value: true

Behavior and limits

• The selected entity must exist.

---

in_sunlight

Purpose: Checks a simplified daylight and sky-light exposure rule.

Context: Default target: TARGET; requires an entity.

Fields

Field	Default	Description
target	TARGET	Entity selector.
value	true	Expected state.

Example

type: in_sunlight
target: SOURCE
value: true

Behavior and limits

• Sunlight is true when world time is below 12300 and sky light at the entity block is at least 15.

• Weather is not checked directly.

---

in_structure

Purpose: Checks whether a location lies inside one of the configured generated-structure bounding boxes.

Context: Default target: TARGET; if the entity is unavailable, the trigger location is used.

Fields

Field	Default	Description
target	TARGET	Entity selector.
structure	empty	Single namespaced structure key.
structures	empty	List of accepted structure keys.

Example

type: in_structure
target: SOURCE
structures:
  - minecraft:fortress
  - minecraft:bastion_remnant

Behavior and limits

• Only structures reported for the current chunk are inspected.

• The resolved point must be inside the generated structure bounding box.

---

light_level

Purpose: Checks total block light.

Context: Uses the source/location required by the implementation; no configurable selector in the shared implementation.

Fields

Field	Default	Description
min	0	Inclusive minimum light level.
max	15	Inclusive maximum light level.

Example

type: light_level
min: 0
max: 7

Behavior and limits

• Reads the combined block light value.

---

clear_weather

Purpose: Checks whether the context world has no storm.

Context: Requires a resolved location and world.

Fields

Field	Default	Description
value	true	Expected clear-weather state.

Example

type: clear_weather
value: true

Behavior and limits

• value: false requires stormy weather but does not specifically require thunder.

---

thunder

Purpose: Checks whether the context world is thundering.

Context: Requires a resolved location and world.

Fields

Field	Default	Description
value	true	Expected thundering state.

Example

type: thunder
value: true

Behavior and limits

• A missing location or world does not match.

---

world

Purpose: Matches the world name at the trigger location.

Context: Requires a resolved location and world.

Fields

Field	Default	Description
world	empty	Single world name.
worlds	empty	List of accepted world names.

Example

type: world
worlds:
  - world
  - world_nether

Behavior and limits

• At least one name is required.

• Matching uses the actual Bukkit world name.

---

night

Purpose: Checks a fixed vanilla-style night time range.

Context: Requires a valid world from the source/context.

Fields

Field	Default	Description
value	true	Expected night state.

Example

type: night
value: true

Behavior and limits

• Night is defined as world time 12300 through 23850 inclusive.

• Weather and sky visibility are not considered.

---

environment

Purpose: Matches a world dimension and optionally a biome.

Context: Default target: SOURCE; selected entity must exist.

Fields

Field	Default	Description
target	SOURCE	Entity selector.
dimension	empty	Bukkit world environment such as NORMAL, NETHER, or THE_END.
biomes	empty	Accepted biome enum names or namespaced keys.

Example

type: environment
target: SOURCE
dimension: NETHER
biomes:
  - BASALT_DELTAS
  - minecraft:soul_sand_valley

Behavior and limits

• If dimension is configured it must match before biome checks.

• When both dimension and biome lists are empty, the condition fails.

---