Biomes

Use biome content, region declarations and level handles to control biome generation, query biomes and edit biome cells.

From Sunrise's modding bookead8a1e

  • Add a biome

    Use
    data/<ns>/worldgen/biome/<name>.json in a content mod or data pack (content mods)
    Side
    Content
  • Add my features or spawns to vanilla's biomes

    Use
    Registrar::declare_biome_modifier or a file in data/<ns>/neoforge/biome_modifier/ (content mods)
    Side
    Content
  • Give my dimension its own biomes

    Use
    DimensionSettings::biome_source: Fixed, Checkerboard, MultiNoise by preset, End, or Points for an explicit climate-point layout (dimension shape)
    Side
    Both
  • Put my biomes among the Overworld's or the Nether's

    Use
    Registrar::declare_biome_region with a weighted BiomeRegion (biome regions)
    Side
    Both
  • Know the biome at a position

    Use
    LevelRef::biome_at on a server level, LevelRef::client_biome on a client
    Side
    Server, client
  • Find the nearest biome or tag

    Use
    LevelRef::find_closest_biome with a BiomeSearch
    Side
    Server
  • Change a biome

    Use
    LevelRef::set_biome, one 4x4x4 cell, as /fillbiome does
    Side
    Server
  • Run bone meal at a position

    Use
    LevelRef::bone_meal
    Side
    Server
  • Place a feature (a tree, a patch, an ore vein)

    Use
    LevelRef::place_feature, as /place feature does (placing a template)
    Side
    Server
  • Tint foliage, grass or water by biome

    Use
    The register_color_resolvers hook for new colour resolvers, and the biome_colors hook to change a biome's own colours
    Side
    Client

Code and file modifiers support features, spawns, spawn costs, carvers, climate and effects. They apply additions, then removals, then modifications when the world loads, after its data packs. Mods cannot choose explicit phases or supply custom biome-modifier serializers (content mods).

Adopt installed biome regions

From the client's world list, open Edit World and confirm adoption to save the installed mods' biome regions for that world. Completed chunks keep their biomes and blocks. New chunks use the adopted layout, and chunks still being generated may finish with it. See biome regions.

Read and write limits

  • biome_at never loads or generates a chunk: an unloaded column answers None.
  • find_closest_biome follows vanilla's sampled spiral, so it is not a search through cells a mod edited, and it refuses a search whose sample count passes BiomeSearch::MAX_SAMPLES.
  • set_biome refuses a client, an unknown biome and an unchanged cell, and returns false rather than an error.

Edit this page on GitHub · Spotted something wrong? Open an issue or ask on Discord.