⛰️ 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

Celestial Movement#

#bs.environment:get_current_sun_angle

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":"°"}]

doDaylightCycle gamerule

This feature also works when the doDaylightCycle gamerule 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

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":"°"}]

doDaylightCycle gamerule

This feature also works when the doDaylightCycle gamerule 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

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

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":"°"}]
#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

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

👁️ 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!