Changelog

All notable changes to UtilityBiome will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Note: Earlier history lives in the Git log (git log --oneline). This file tracks changes from version 1.0.0 forward.

[Unreleased]

[1.2.0] - 2026-11-09

Added

For mod authors

• World lookups for placers: ChunkAccess.worldSeed(), terrainHeight(worldX, worldZ) and biomeAt(worldX, worldZ) let a placer ask the world generator about any position, also outside its own chunk. terrainHeight is the natural terrain from the height noise and the same in every chunk, so a structure that spans several chunks is planned the same way in each of them. API version 0.8.0-Alpha.

Changed

For players

• English messages: all /ub commands, their help texts and error messages are now in English.

Fixed

For players

• /ub cave with stalagmites: the search crashed with a NullPointerException (ChunkGeneratorResource.getPrefab) for cave types whose first rooms carry prefabs, like stalagmites. It now runs on its own thread with the generator's thread resource bound, like the generator's worker threads.
• /ub cave with an empty entry: cave types whose entry node has no geometry (an EMPTY_LINE of length 0 that only carries the first chamber) were never found, because the generator doesn't add such nodes to the cave. The search now falls back to the node nearest to the entry point.
• /ub cave under rare biomes: cave types bound to a surface biome (BiomeMask) were often not found. Every entry point outside the mask was still built and used up the limit of 64 caves. The search now checks the biome mask first.

[1.1.0] - 2026-10-21

Added

For mod authors

• Loot containers: ChunkAccess.setContainer(x, y, z, block, dropList) and Blueprint.Builder.loot(symbol, block, dropList) fill chests and other containers from a drop list when the chunk first loads, like vanilla structures. API version 0.7.0-Alpha.
• Connected blocks: with Connected and Blueprint.Builder.connected(...), fences, walls and bars in blueprints get their shape (straight, corner, T, cross) and rotation from their neighbours, after every rotation of the blueprint.
• README with a quick start for other mods, including build-time-only use without a runtime dependency.

Fixed

For mod authors

• Rotated blocks: Blueprint.rotated now also rotates a |Yaw= in block keys.
• Block entities: blocks set by chunk features now get their block entity (containers, crops, spawn markers ...). Before, a chest placed by a feature had no storage, and crops didn't grow.

[1.0.0] - 2026-10-12

First stable release. UtilityBiome now requires Hytale 0.7.0 (server version >=0.7.0 <0.8.0). Hytale 0.6.x is no longer supported.

Added

For players

• Commands under /ub:
  • /ub where: zone and biome at your position.
  • /ub list: all loaded biomes.
  • /ub census: count biomes in an area.
  • /ub next <biome>: teleport to the next occurrence of a biome you have not visited yet.
  • /ub caves <zone>: cave types and ores of a zone.
  • /ub cave <cave type>: teleport into the nearest cave of a type.
  • /ub features and /ub feature <id>: list chunk features and teleport to the next spot where one was placed since the server started.

For mod authors

• Runtime API (api) for other mods:
  • Chunk features and placers that run on newly generated chunks, with access to blocks, fluids, height and the biome at each column.
  • Structures: describe a building as a text blueprint and register it as a chunk feature. UtilityBiome picks a flat spot on natural ground away from other buildings, rotates it at random and adds a foundation. Helpers for custom shapes and terrain.
• Build-time tools (tools) for the mod's tests and Gradle tasks, with no Hytale imports:
  • Biome generator: builds custom biomes from vanilla tiles, with covers, palettes, prefab lists and region grids.
  • Cave, ore, resource and spawn specs.
  • Asset validator and vanilla index, so that every block, item, prefab and environment a mod references is checked against vanilla.
• Gradle plugin with the tasks generateBiomes, checkGeneratedAssets, validateAssets, devAssetPack and freshWorld.

Changed

For players

• /ub next reads the surface height from the new heightmap.
• /ub cave has its own cave search, since Hytale 0.7.0 removed the vanilla one it was based on. It no longer teleports you if the cave start lies outside the world (below y 2 or above y 318).

For mod authors

• Hytale 0.7.0: chunk features read and write blocks through the chunk sections. The new heightmap is only built after the pre-load event, so the height is now computed from the blocks themselves.
• Vanilla index for Hytale 0.7.0.