World

World

Represents the current Minecraft world. Provides access to blocks, biomes, time, dimension, and color data.

---

Functions

Blocks

getBlock(x, y, z)

Returns the block at the given world coordinates.

• Parameters:
  • x, y, z — Integer
• Returns: Block

make world player.getWorld()
make block world.getBlock(0, 64, 0)
say block.getName()

---

Dimension & Time

getDimension()

Returns the identifier of the current dimension.

• Returns: String — e.g. "minecraft:overworld", "minecraft:the_nether"

isDay()

Returns whether it is currently daytime.

• Returns: Boolean

getTimeOfDay()

Returns the time of day in ticks (0–24000).

• Returns: Long

getTime()

Returns the total world time elapsed in ticks (ever-increasing).

• Returns: Long

make world player.getWorld()
say world.getDimension()

check world.isDay() do
    say "It's daytime! Time: " + world.getTimeOfDay()
otherwise
    say "It's nighttime!"
end

---

Biomes & Colors

getBiomeAt(x, y, z)

Returns the biome ID at the given coordinates.

• Parameters:
  • x, y, z — Integer
• Returns: String — e.g. "minecraft:plains"

getBiomeAt(position)

Returns the biome ID at the given Position.

• Parameters:
  • position — Position
• Returns: String

getBiomeColorAt(x, y, z)

Returns the biome color as a packed ARGB integer at the given coordinates.

• Parameters:
  • x, y, z — Integer
• Returns: Integer

getBiomeColorAt(position)

Returns the biome color as a packed ARGB integer at the given Position.

• Parameters:
  • position — Position
• Returns: Integer

getGrassColor(position)

Returns the grass color at the given position, blended for the local biome.

• Parameters:
  • position — Position
• Returns: Integer — Packed ARGB color

getFoliageColor(position)

Returns the foliage (leaf) color at the given position.

• Parameters:
  • position — Position
• Returns: Integer — Packed ARGB color

getDryFoliageColor(position)

Returns the dry foliage color at the given position.

• Parameters:
  • position — Position
• Returns: Integer — Packed ARGB color

getWaterColor(position)

Returns the water color at the given position.

• Parameters:
  • position — Position
• Returns: Integer — Packed ARGB color

make world player.getWorld()
make pos player.getPosition()

say world.getBiomeAt(pos)
~ Output: "minecraft:forest"

make grassColor world.getGrassColor(pos)
make waterColor world.getWaterColor(pos)

make item player.getMainHandItem()
item.setTint(grassColor)

---

Utility

calculateDistanceBetweenPositions(pos1, pos2)

Returns the distance between two Position objects.

• Parameters:
  • pos1, pos2 — Position
• Returns: Long

toString()

Returns a string summary of the world state.

• Returns: String — e.g. "World{dimension=minecraft:overworld, isDay=true, timeOfDay=6000, time=142300}"

make world player.getWorld()
make pos1 player.getPosition()
make pos2 new Position(0, 64, 0)
make dist world.calculateDistanceBetweenPositions(pos1, pos2)
say "Distance to origin: " + dist

say world.toString()