Biome and Structure Metadata

This page details the standard to define metadata for biomes and strucutres that are needed to display them on (biome)-maps. It currently works for the online Minecraft Datapack Map and the World Preview Mod. Other maps are welcome to use this standard.

Biomes

Colors (and display names)

Create a file data/c/worldgen/biome_colors.json specifying the color of each biome as follows:

{
  "minecraft:beach": {
    "r": 244,
    "g": 238,
    "b": 5
  },
  "minecraft:snowy_beach": {
    "r": 249,
    "g": 255,
    "b": 150,
    "name": "Snowy Beach" // Optional display name field, instead of using language files.
  }
  //...
}

Note that you can specify the color of any biome, including biomes not defined by your mod. The use of language files is recommended over the name field.

Tags

Some maps might additionally make use of biome tags to classify biomes. Please make sure your biomes are in the correct tags, see Fabric contention tags and Forge tags. Especially make sure to put cave biomes in c:caves and/or forge:is_cave

Structures

Create a file c/worldgen/structure_icons.json specifying the icons. Icons can be either vanilla items or custom textures. When custom textures are used, a vanilla item should be specified as a fallback as not all maps are guaranteed to load textures from assets.

Icons (and display names)

{
  "minecraft:ruined_portal_desert": {
    "texture": "world_preview:textures/structure/ruined_portal.png", // Optional use of a custom texture
    "item": "minecraft:obsidian" // Vanilla item to use as icon, used as fallback if a texture is specified.
    "name": "Desert Ruined Portal" // Optional display name field, instead of using language files.
  },
  "minecraft:stronghold": //...
  //...
}

Note that you can specify the color of any structure, including structures not defined by your mod. The use of language files is recommended over the name field.

Tags

Structures that should never be shown on a map, can be hidden using the c:hidden_from_displayers convention tag. These structures will not show up in the list of structures to enable. If you have technical/internal structures that aren't visible in survival gameplay, you should add them to this tag. You do not need to specify icons for these structures.

For versions of Minecraft prior to 1.20.5, use the c:hide_from_map tag instead.

Note: To hide structures specifically from the "Minecraft Datapack Map", you can also use the jacobsjo:hidden_from_map tag.