Características y reglas de características

Todo lo que decora el terreno es una característica (feature): vetas de mineral, árboles, flores, hierba, rocas, manantiales, coral. Si no es el terreno básico ni una criatura, seguramente es una característica.

Para que una característica aparezca en el mundo necesitas dos archivos:

• Una característica dice qué colocar: una veta de mineral, un árbol, un solo bloque.
• Una regla de característica (feature rule) dice dónde y con qué frecuencia: en qué biomas, cuántas veces por chunk, a qué altura.

En esta guía vas a hacer que aparezca mena de rubí bajo tierra en todos los biomas del mundo superior.

Los archivos

BP/
  blocks/
    ruby_ore.json
  features/
    ruby_ore_feature.json
  feature_rules/
    ruby_ore_rule.json

Paso 1: el bloque de mena

Primero necesitas un bloque que colocar. Crea un bloque personalizado normal llamado wiki:ruby_ore con una textura y una tabla de botín. Si todavía no has hecho ningún bloque, sigue Tu primer bloque personalizado.

Paso 2: la característica

{
  "format_version": "1.13.0",
  "minecraft:ore_feature": {
    "description": {
      "identifier": "wiki:ruby_ore_feature"
    },
    "count": 6,
    "replace_rules": [
      {
        "places_block": "wiki:ruby_ore",
        "may_replace": [
          "minecraft:stone",
          "minecraft:granite",
          "minecraft:diorite",
          "minecraft:andesite"
        ]
      }
    ]
  }
}

• La clave raíz, aquí minecraft:ore_feature, es el tipo de característica. Cada archivo tiene exactamente uno. La tabla al final de esta página los enumera todos.
• count es cuántos bloques intenta colocar una veta. Los diamantes usan vetas pequeñas y el carbón, grandes.
• replace_rules dice qué bloque va dónde. La mena solo sustituye los bloques que aparecen en may_replace, así que nunca flota en las cuevas ni se come la tierra.

Reglas de nombres

• Una característica por archivo.
• El nombre del archivo debe coincidir con la parte del nombre del identificador. wiki:ruby_ore_feature va en ruby_ore_feature.json. El espacio de nombres no cuenta para la coincidencia.
• Si dos paquetes usan exactamente el mismo identificador, gana el paquete que está más arriba en la lista. Así es como puedes sustituir una característica del juego base.

Paso 3: la regla de característica

Una característica no hace nada hasta que una regla de característica la vincula a unos biomas:

{
  "format_version": "1.13.0",
  "minecraft:feature_rules": {
    "description": {
      "identifier": "wiki:ruby_ore_rule",
      "places_feature": "wiki:ruby_ore_feature"
    },
    "conditions": {
      "placement_pass": "underground_pass",
      "minecraft:biome_filter": [
        {
          "test": "has_biome_tag",
          "operator": "==",
          "value": "overworld"
        }
      ]
    },
    "distribution": {
      "iterations": 4,
      "coordinate_eval_order": "zyx",
      "x": {
        "distribution": "uniform",
        "extent": [0, 16]
      },
      "y": {
        "distribution": "triangle",
        "extent": [-48, 16]
      },
      "z": {
        "distribution": "uniform",
        "extent": [0, 16]
      }
    }
  }
}

La regla tiene tres partes.

description

• identifier da nombre a la regla. Igual que con las características, la parte del nombre debe coincidir con el nombre del archivo.
• places_feature es la característica que coloca esta regla. Una regla controla una característica.

conditions

minecraft:biome_filter elige los biomas. Es una lista de pruebas de filtro, y la que usarás casi siempre es has_biome_tag. Cada bioma comprueba el filtro: los que lo pasan reciben la característica.

Puedes combinar pruebas con all_of y any_of. Este elige biomas cálidos del mundo superior que no sean océanos:

"minecraft:biome_filter": [
  { "test": "has_biome_tag", "operator": "==", "value": "overworld" },
  {
    "any_of": [
      { "test": "has_biome_tag", "operator": "==", "value": "desert" },
      { "test": "has_biome_tag", "operator": "==", "value": "mesa" }
    ]
  },
  { "test": "has_biome_tag", "operator": "!=", "value": "ocean" }
]

Para poner mena de rubí solo en la Arboleda de Rubí, comprueba su propia etiqueta: "value": "ruby_grove".

placement_pass dice cuándo se coloca la característica respecto a las demás. Las pasadas se ejecutan en este orden:

Las características de una misma pasada no tienen un orden fijo entre ellas.

distribution

Esto decide cuántas copias intentan generarse en cada chunk y dónde.

En una regla de característica, x y z se cuentan desde la esquina del chunk, así que [0, 16] cubre el chunk entero. y es la altura del mundo.

Cada rango tiene un tipo de distribution que da forma a dónde caen los valores:

Para cosas que van en el suelo, como plantas, define y con Molang para que caigan en la superficie:

"y": "query.heightmap(variable.worldx, variable.worldz)"

Pruebas

1. Activa el paquete en un mundo nuevo.
2. Pasa al modo espectador con /gamemode spectator y vuela bajo tierra cerca de Y 0.
3. Busca la textura de rubí en la piedra. ¿Demasiado rara? Sube iterations o count.

Si no aparece nada, abre el registro de contenido. Las causas habituales son un nombre de archivo que no coincide con el identificador, un nombre incorrecto en places_feature o una errata en el nombre del bloque en places_block.

Todos los tipos de característica

Cada archivo de característica usa exactamente uno de estos como clave raíz. Algunos colocan bloques; otros solo eligen entre otras características, las mueven o las repiten. La mayoría de las decoraciones del juego base encadenan varias: por ejemplo, una característica de dispersión que ejecuta una de búsqueda que a su vez ejecuta un árbol.

Siguientes pasos

• Crea un hogar para tu mena: El archivo del bioma.
• Consulta las etiquetas de bioma con las que filtrar: minecraft:tags.