El archivo de bioma

Un bioma es una zona del mundo con su propio suelo, clima, colores y criaturas. Las llanuras, los desiertos y las arboledas de cerezos son biomas. En esta guía vas a crear una arboleda de rubí: una pradera cálida con hierba rojiza que sustituye pequeñas zonas de las llanuras.

Un bioma, igual que un bloque, vive en dos paquetes:

• El archivo del paquete de comportamiento dice cómo se construye el terreno: su clima, qué bloques cubren el suelo y dónde aparece.
• El archivo del paquete de recursos (el "bioma de cliente") dice qué aspecto y qué sonido tiene: color de la hierba, color del agua, niebla, música.

Los archivos

BP/
  biomes/
    ruby_grove.biome.json
RP/
  biomes/
    ruby_grove.client_biome.json

Los dos archivos usan el mismo identificador, wiki:ruby_grove. Así es como el juego sabe que van juntos.

Paso 1: el bioma del paquete de comportamiento

{
  "format_version": "1.26.30",
  "minecraft:biome": {
    "description": {
      "identifier": "wiki:ruby_grove"
    },
    "components": {
      "minecraft:climate": {
        "temperature": 0.9,
        "downfall": 0.4,
        "snow_accumulation": [0.0, 0.125]
      },
      "minecraft:overworld_height": {
        "noise_type": "lowlands"
      },
      "minecraft:surface_builder": {
        "builder": {
          "type": "minecraft:overworld",
          "top_material": "minecraft:grass_block",
          "mid_material": "minecraft:dirt",
          "foundation_material": "minecraft:stone",
          "sea_floor_material": "minecraft:gravel",
          "sea_material": "minecraft:water",
          "sea_floor_depth": 7
        }
      },
      "minecraft:replace_biomes": {
        "replacements": [
          {
            "dimension": "minecraft:overworld",
            "targets": ["plains"],
            "amount": 0.25,
            "noise_frequency_scale": 0.5
          }
        ]
      },
      "minecraft:map_tints": {
        "grass": { "type": "tint", "tint": "#c4504f" },
        "foliage": "#b8433f"
      },
      "minecraft:tags": {
        "tags": ["overworld", "animal", "monster", "plains", "ruby_grove"]
      }
    }
  }
}

El archivo tiene dos partes:

• description contiene el identifier. Usa letras minúsculas y tu propio espacio de nombres. También es el nombre que usa /locate biome.
• components contiene todo lo demás. Cada componente activa una cosa que hace el bioma.

Pon un bioma en cada archivo y ponle al archivo el nombre del bioma (ruby_grove.biome.json para wiki:ruby_grove).

Los componentes principales

Estos son los componentes que más vas a usar. Cada uno tiene su propia página en Componentes de bioma.

Cómo llega tu bioma al mundo

Un archivo de bioma nuevo no hace nada por sí solo. El juego solo coloca un bioma que le diga dónde ir, así que un bioma personalizado necesita minecraft:replace_biomes:

• targets enumera los biomas que sustituyes. Escríbelos sin espacio de nombres (plains, no minecraft:plains).
• dimension es minecraft:overworld o minecraft:nether.
• amount es, más o menos, cuánto del bioma objetivo sustituyes, desde algo más de 0 hasta 1.
• noise_frequency_scale fija el tamaño de las zonas. Los valores bajos dan menos zonas y más grandes. Los altos dan muchas pequeñas.

Etiquetas

Las etiquetas son palabras sencillas unidas al bioma. Tienen dos funciones:

1. Otros archivos las comprueban. Las reglas de aparición y las reglas de características usan pruebas como has_biome_tag para decidir dónde aparecen las criaturas y dónde van los árboles o las menas. Dale a tu bioma etiquetas como overworld, animal y monster y mucho contenido del juego base lo tratará como un bioma normal de la superficie.
2. Algunas etiquetas tienen un significado propio. Por ejemplo, cold o frozen visten a los aldeanos para la nieve; plains, forest, meadow y swamp eligen qué flores crecen; y desert y mesa hacen que la arena reproduzca sonidos ambientales.

Añade también una etiqueta tuya (aquí, ruby_grove). Así tus propias características y criaturas pueden apuntar solo a este bioma.

Las etiquetas pueden usar letras, números, . y _.

Paso 2: el bioma de cliente

La parte del paquete de recursos tiene la misma forma, pero su raíz es minecraft:client_biome:

{
  "format_version": "1.21.120",
  "minecraft:client_biome": {
    "description": {
      "identifier": "wiki:ruby_grove"
    },
    "components": {
      "minecraft:grass_appearance": {
        "color": "#c4504f"
      },
      "minecraft:foliage_appearance": {
        "color": "#b8433f"
      },
      "minecraft:water_appearance": {
        "surface_color": "#7a3fd1"
      },
      "minecraft:sky_color": {
        "sky_color": "#ff9a8c"
      },
      "minecraft:fog_appearance": {
        "fog_identifier": "wiki:ruby_fog"
      },
      "minecraft:biome_music": {
        "music_definition": "cherry_grove"
      }
    }
  }
}

Gráficos vibrantes (Vibrant Visuals) añade cuatro más que apuntan a sus propios archivos: atmósfera, iluminación, gradación de color y agua. La lista completa está en Componentes de bioma de cliente.

Todos los componentes son opcionales. Lo que omitas usa el valor por defecto.

Pruebas

1. Activa los dos paquetes en un mundo nuevo. Los biomas solo aparecen en chunks que todavía no se han generado.
2. Ejecuta /locate biome wiki:ruby_grove para encontrarlo.
3. Vuela hasta allí y comprueba el color de la hierba. Si es el verde normal, el identificador del bioma de cliente no coincide.

Siguientes pasos

• Llena tu bioma de mena de rubí y plantas: Características y reglas de características.
• Dale su propio ambiente: Niebla.
• Busca el nombre de cualquier bioma en ID de biomas.