⛰️ Environment#

#bs.environment:help

Comprehensive information and tools related to weather and biome properties.

../../_images/environment.png

“The most dangerous worldview is the worldview of those who have not viewed the world.”

—Alexander von Humboldt

🔧 Functions#

You can find below all functions available in this module.

Get Biome#

#bs.environment:get_biome

Get biome data at the execution position of the function.

Inputs:

Execution at <entity> or positioned <x> <y> <z>: Position from which you want to get biome data.

Outputs:

Storage bs:out environment.get_biome:

  • Biome data

    • type: String representation of the biome ID (e.g., minecraft:plains).

    • temperature: The base temperature of the biome.

    • has_precipitation: Whether the biome has precipitation or not.

Example: Get biome data at the current location:

# Once
function #bs.environment:get_biome
data get storage bs:out environment.get_biome

Credits: Aksiome

Get Temperature#

#bs.environment:get_temperature {scale:<scaling>}

Get the temperature at the execution position of the function, taking the altitude into account.

Inputs:

Execution at <entity> or positioned <x> <y> <z>: Position from which you want to get the temperature.

Function macro:

  • Arguments

    • scale: Scalar for the function’s output.

Outputs:

Return | Score $environment.get_temperature bs.out: Temperature at the given position.

Example: Get the temperature at the current altitude:

# Once
function #bs.environment:get_temperature {scale:1000}

Credits: Aksiome, theogiraudet

Get Celestial Angle#

#bs.environment:get_current_sun_angle {scale:<scaling>}

Get the current sun’s angle on the Y axis relative to the horizon, in degrees.

Inputs:

Function macro:

  • Arguments

    • scale: A scalar applied to the output.

Outputs:

Return: Sun’s angle in degrees (scaled by scale).

Storage bs:out environment.celestial_angle : Sun’s angle in degrees.

Example: Get the sun’s current angle:

# Once
function #bs.environment:get_current_sun_angle {scale: 1000}
tellraw @a [{"text":"Sun angle: "},{"nbt":"environment.celestial_angle","storage":"bs:out","interpret":true},{"text":"°"}]

Note

This feature also works when the advance_time game rule is set to false. In such situation, the returned value is the sun’s angle at the time of daylight cycle freeze.

#bs.environment:get_current_moon_angle {scale:<scaling>}

Get the current moon’s angle on the Y axis relative to the horizon, in degrees.

Inputs:

Function macro:

  • Arguments

    • scale: A scalar applied to the output.

Outputs:

Return: Moon’s angle in degrees (scaled by scale).

Storage bs:out environment.celestial_angle : Moon’s angle in degrees.

Example: Get the moon’s current angle:

# Once
function #bs.environment:get_current_moon_angle {scale: 1000}
tellraw @a [{"text":"Moon angle: "},{"nbt":"environment.celestial_angle","storage":"bs:out","interpret":true},{"text":"°"}]

Note

This feature also works when the advance_time game rule is set to false. In such situation, the returned value is the moon’s angle at the time of daylight cycle freeze.

#bs.environment:get_sun_angle {scale:<scaling>}

Get the sun’s angle on the Y axis relative to the horizon at a specific time.

Inputs:

Scores $environment.celestial_angle.day bs.in: The day number.

Scores $environment.celestial_angle.daytime bs.in: The time of day in ticks (0-24000).

Function macro:

  • Arguments

    • scale: A scalar applied to the output.

Outputs:

Return: Sun’s angle at the given time, in degrees (scaled by scale).

Storage bs:out environment.celestial_angle : Sun’s angle in degrees.

Example: Get the sun’s angle on day 100 at noon (6000 ticks):

# Once
scoreboard players set $environment.celestial_angle.day bs.in 100
scoreboard players set $environment.celestial_angle.daytime bs.in 6000

function #bs.environment:get_sun_angle {scale: 1000}
tellraw @a [{"text":"Sun angle at day 100, noon: "},{"nbt":"environment.celestial_angle","storage":"bs:out","interpret":true},{"text":"°"}]
#bs.environment:get_moon_angle {scale:<scaling>}

Get the moon’s angle on the Y axis relative to the horizon at a specific time.

Inputs:

Scores $environment.celestial_angle.day bs.in: The day number.

Scores $environment.celestial_angle.daytime bs.in: The time of day in ticks (0-24000).

Function macro:

  • Arguments

    • scale: A scalar applied to the output.

Outputs:

Return: Moon’s angle at the given time, in degrees (scaled by scale).

Storage bs:out environment.celestial_angle : Moon’s angle in degrees.

Example: Get the moon’s angle on day 100 at midnight (18000 ticks):

# Once
scoreboard players set $environment.celestial_angle.day bs.in 100
scoreboard players set $environment.celestial_angle.daytime bs.in 18000

function #bs.environment:get_moon_angle {scale: 1000}
tellraw @a [{"text":"Moon angle at day 100, midnight: "},{"nbt":"environment.celestial_angle","storage":"bs:out","interpret":true},{"text":"°"}]

Credits: theogiraudet

Get Moon Phase#

#bs.environment:get_moon_phase

Get the current moon phase as a string identifier.

Outputs:

Storage bs:out environment.get_moon_phase: Moon phase identifier.

Return: Moon phase identifier (see the note below).

Example: Get the current moon phase:

# Once
function #bs.environment:get_moon_phase
data get storage bs:out environment.get_moon_phase

Moon Phase Values

The function returns one of the following string values:

  • "full_moon" (id: 0)

  • "waning_gibbous" (id: 1)

  • "third_quarter" (id: 2)

  • "waning_crescent" (id: 3)

  • "new_moon" (id: 4)

  • "waxing_crescent" (id: 5)

  • "first_quarter" (id: 6)

  • "waxing_gibbous" (id: 7)

The moon phase cycle follows Minecraft’s 8-day lunar cycle.

Credits: theogiraudet

Look at Celestial Object#

#bs.environment:look_at_sun

Orient the executing entity to look at the sun.

Inputs:

Execution as <entity>: The entity to orient.

Outputs:

State: The entity’s rotation is modified to face the sun.

Example: Make the current entity look at the sun:

# Once
function #bs.environment:look_at_sun
#bs.environment:look_at_moon

Orient the executing entity to look at the moon.

Inputs:

Execution as <entity>: The entity to orient.

Outputs:

State: The entity’s rotation is modified to face the moon.

Example: Make the current entity look at the moon:

# Once
function #bs.environment:look_at_moon

Credits: theogiraudet

👁️ Predicates#

You can find below all predicates available in this module.

Can It Rain?#

bs.environment:can_rain

Determine if it can rain or not.

Credits: Aksiome

Can It Snow?#

bs.environment:can_snow

Determine if it can snow or not.

Credits: Aksiome

Can It Rain or Snow?#

bs.environment:has_precipitation

Determine if the biome has precipitation or not.

Credits: Aksiome

Is It Raining?#

bs.environment:is_raining

Determine if it is currently raining or not.

Credits: Aksiome, theogiraudet

Is It Thundering?#

bs.environment:is_thundering

Determine if it is currently thundering or not.

Credits: Aksiome, theogiraudet

Time Predicates#

bs.environment:is_day_time

Determine if it is currently daytime (between 07:00 and 18:00).

Credits: theogiraudet

bs.environment:is_night_time

Determine if it is currently nighttime (between 19:00 and 06:00).

Credits: theogiraudet

bs.environment:is_sunrise_time

Determine if it is currently sunrise (between 06:00 and 07:00).

Credits: theogiraudet

bs.environment:is_sunset_time

Determine if it is currently sunset (between 18:00 and 19:00).

Credits: theogiraudet

Villager Behavior#

bs.environment:is_villager_sleeping_time

Determine if villagers are currently in their working phase (between 08:00 and 15:00).

Credits: theogiraudet

bs.environment:is_villager_socializing_time

Determine if villagers are currently in their socializing phase (between 15:00 and 18:00).

Credits: theogiraudet

bs.environment:is_villager_sleeping_time

Determine if villagers are currently in their sleeping phase (between 18:00 and 07:00).

Credits: theogiraudet

Is It Bed Time?#

bs.environment:is_bed_time

Determine if beds can currently be used by players (between 18:32 and 05:27 in clear weather, or 18:00 and 05:59 in rainy weather).

Credits: theogiraudet

Is It Undead Burning Time?#

bs.environment:is_undead_burning_time

Determine if undead mobs (zombies, skeletons, etc.) can currently burn in sunlight (between 05:27 and 18:32 in clear weather).

Credits: theogiraudet

Is It Monster Spawning Time?#

bs.environment:is_monster_spawning_time

Determine if hostile monsters can currently spawn outdoors (between 19:11 and 04:48 in clear weather, or 18:58 and 05:01 in rainy weather).

Credits: theogiraudet

Is It Bee Sleeping Time?#

bs.environment:is_bee_sleeping_time

Determine if bees are currently in their sleeping phase (between 18:32 and 05:27 in clear weather).

Credits: theogiraudet

Is It Creaking Spawning Time?#

bs.environment:is_creaking_spawning_time

Determine if creakings can currently spawn (between 18:32 and 05:27 in clear weather, or 18:00 and 05:59 in rainy weather).

Credits: theogiraudet

💬 Did it help you?

Feel free to leave your questions and feedback below!