
Contenido
- 1 general
- 2 formato JSON
- 3 Añadiendo biomas
- 4 componentes
- 4.1 minecraft: clima
- 4.2 minecraft: overorld_height
- 4.3 Minecraft: parámetros de superficie
- 4.4 Minecraft: ajustes de material de superficie
- 4.5 materiales
- 4.6 rango_ruido
- 4.7 minecraft: superficie_pantano
- 4.8 minecraft: superficie_oceánica_congelada
- 4.9 minecraft: mesa_surface
- 4.10 Minecraft: Nether_surface
- 4.11 minecraft: the_end_surface
- 4.12 Minecraft: reglas de generación_de_mundo_de_mundo
- 4.13 Minecraft: reglas de generación_nether
- 5 biomas
- 5.1 Propiedades de la definición de bioma
- 5.2 Propiedades de la descripción del bioma
Este es el documentación del bioma para Bedrock Edition beta 1.17.40.20. Las nuevas funciones, componentes y capacidades de esta versión no son definitivas y pueden cambiar sin previo aviso antes de la versión final. Asegúrese de consultar la documentación una vez que la versión esté fuera de la versión beta si el complemento no funciona correctamente. No se garantiza que los paquetes de recursos y comportamiento creados para la versión beta funcionen en la versión final.
Visión General
Los biomas describen cómo debería verse y comportarse una parte local del mundo. Al escribir datos de bioma personalizados, el jugador puede:
- Cambiar la forma general del terreno por un bioma
- Cambiar la relación de frecuencia de los tipos de biomas
- Cambia los bloques que componen el bioma, tanto en la superficie como debajo.
- Cambie la distribución de elementos decorativos (por ejemplo, árboles, césped, etc.) de un bioma.
- Cambia las turbas que se generan por un bioma
- Cambiar el clima por un bioma
Formato JSON
Todos los biomas deben especificar la versión a la que se dirigen a través del campo "format_version". El resto de los datos del bioma se divide en subobjetos o componentes JSON independientes. En general, puede pensar en la presencia de un componente como la definición de los comportamientos del juego en los que participa un bioma y los campos del componente definen cómo participa. En términos generales, hay dos categorías de componentes:
- Los componentes con espacio de nombres (es decir, aquellos con un prefijo 'nombre:') se asignan a comportamientos específicos en el juego; pueden tener campos miembro que parametricen ese comportamiento; solo se admiten los nombres que tienen una asignación válida.
- Los componentes sin espacio de nombres se tratan como 'etiquetas': cualquier nombre que consta de caracteres alfanuméricos, '.' y '_' está permitido; la etiqueta se adjunta al bioma para que el código o los datos puedan verificar su existencia; Es posible que los componentes de etiqueta no tengan campos de miembros.
Consulte las propiedades del bioma a continuación para registrar biomas.
Aquí hay un ejemplo de bioma del supramundo{"format_version": "1.13.0", "minecraft: biome": {"descripción": {"identifier": "llanuras"}, "componentes": {"minecraft: clima": {"caída": 0.4, "snow_accumulation": [0.0, 0.125], "temperature": 0.8}, "minecraft: overorld_height": {"noise_type": "lowlands"}, "minecraft: surface_parameters": {"sea_floor_depth": 7, "sea_floor_material": "minecraft: gravel", "foundation_material": "minecraft: piedra", "mid_material": "minecraft: suciedad", "top_material": "minecraft: hierba", "sea_material": "minecraft: agua"}, "minecraft: overorld_generation_rules ": {" hills_transformation ": [[" forest_hills ", 1], [" forest ", 2]]," mutate_transformation ":" sunflower_plains "," generate_for_climates ": [[" medium ", 3], [" warm ", 1], [" frío ", 1]]}," animal ": {}," monstruo ": {}," sobremundo ": {}," llanuras ": {}," bee_habitat ": {}} }}
Aquí hay un ejemplo de otro bioma del supramundo. Este es personalizado.
{
"format_version": "1.13.0", "minecraft: biome": {"description": {"identifier": "taiga_extreme_mountains"}, "componentes": {"minecraft: clima": {"caída": 0.8, " snow_accumulation ": [0.0, 0.125]," temperature ": 0.25}," minecraft: overorld_height ": {" noise_params ": [2.6, 0.64]}," minecraft: surface_parameters ": {" sea_floor_depth ": 7," sea_floor_material " : "minecraft: gravel", "foundation_material": "minecraft: piedra", "mid_material": "minecraft: suciedad", "top_material": "minecraft: podzol", "sea_material": "minecraft: agua"}, "minecraft : surface_material_adjustments ": {" settings ": [{" materials ": {" top_material ":" minecraft: grass "}," noise_range ": [0.25, 1.0]}]}," minecraft: overorld_generation_rules ": {" hills_transformation " : "extreme_hills", "mutate_transformation": "extreme_hills_mutated", "generate_for_climates": [["congelado", 1], ["frío", 1]]},
"animal": {}, "monstruo": {}, "sobremundo": {}, "pino": {}, "taiga": {}}}}
Aquí hay un ejemplo de bioma inferior
{
"format_version": "1.13.0", "minecraft: bioma": {"descripción": {"identifier": "basalt_deltas"}, "componentes": {"minecraft: clima": {"caída": 0.0, " snow_accumulation ": [0.0, 0.125]," temperature ": 2.0," white_ash ": 2.0}," minecraft: nether_generation_rules ": {" target_temperature ": -0.5," target_humidity ": 0.0," target_altitude ": 0.0," target_weirdness ": 0.0," peso ": 0.175}," minecraft: surface_parameters ": {" sea_floor_depth ": 1," sea_floor_material ":" minecraft: basalt "," foundation_material ":" minecraft: netherrack "," mid_material ":" minecraft : basalt "," top_material ":" minecraft: basalt "," sea_material ":" minecraft: lava "}," minecraft: surface_material_adjustments ": {" settings ": [{" materials ": {" top_material ":" minecraft: blackstone "," mid_material ":" minecraft: blackstone "}," noise_frequency_scale ": 0.1," noise_range ": [-1.0, 0.0]}, {" materials ": {" top_material ":" minecraft: gravel "}," rango_altura ": [" variable.sea_level - 3 "," variable.sea_level + 2 "]," ruido_ escala_de_frecuencia ": 0.4125," rango_de_ruido ": [-1.0, 0.5]}]},
"nether": {}, "basalt_deltas": {}, "spawn_many_magma_cubes": {}, "spawn_ghast": {}}}
}
Añadiendo biomas
Los biomas se leen de archivos JSON en las subcarpetas de biomas de los paquetes de comportamiento. La carga aplica un bioma por archivo; el nombre del archivo y el nombre real del bioma deben coincidir. Agregar un archivo con un nuevo nombre a la ubicación de los datos del bioma lo hará disponible para que el juego lo use, mientras que los biomas existentes se pueden anular a través de archivos que coincidan con su nombre existente. Tenga en cuenta que si agrega un nuevo bioma, deberá escribir datos de componentes que le permitan participar en la generación mundial, o de lo contrario no aparecerá en los mundos.
Componentes
minecraft: clima
Describe temperatura, humedad, precipitación, etc. Los biomas sin este componente tendrán valores predeterminados.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Decimal | temperatura | 0.0 | |
Decimal | caída | 0.0 | |
Lista | acumulación de nieve | [0.0, 0.0] | |
Decimal | esporas_azules | 0.0 | Controla cuántas cenizas azules habrá en el aire. |
Decimal | esporas_rojas | 0.0 | Controla cuántas cenizas rojas habrá en el aire. |
Decimal | ceniza | 0.0 | Controla cuántas cenizas negras habrá en el aire. |
Decimal | ceniza blanca | 0.0 | Controla cuántas cenizas blancas habrá en el aire. |
minecraft: overorld_height
Parámetros de ruido utilizados para impulsar la altura del terreno en el Overworld.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Lista | ruido_params | [150.0, 32.0] | El primer número controla la altura a la que se encuentra el bioma. Las montañas tienen este número establecido en un valor grande, por ejemplo. El segundo número controla la variación de altura de este bioma. Cuanto menor sea el número, más plano será el bioma. |
Cordón | tipo_ruido | tu préstamo estudiantil | Controla la altura del bioma. Incluyendo (de menor a mayor) deep_ocean, ocean, swamp, beach, lowlands, taiga, default, mountains, default_mutated, highlands, stone_beach, less_extreme, extreme. |
minecraft: surface_parameters
Controla los bloques utilizados para la generación de terreno predeterminada de Minecraft Overworld.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Entero | sea_floor_depth | Controla la profundidad a la que debe situarse el suelo por debajo del nivel mundial del agua. | |
Cordón | sea_floor_material | Controla el tipo de bloque que se usa como piso para los cuerpos de agua en este bioma. | |
Cordón | top_material | Controla el tipo de bloque utilizado para la superficie de este bioma. | |
Cordón | mid_material | Controla el tipo de bloque utilizado en una capa debajo de la superficie de este bioma. | |
Cordón | Foundation_material | Controla el tipo de bloque utilizado a gran profundidad en este bioma. | |
Cordón | sea_material | Controla el bloque bajo el nivel del agua. |
minecraft: surface_material_adjustments
Especifique cambios detallados en los bloques utilizados en la generación de terreno (según una función de ruido).
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Lista | ajustes | Todos los ajustes que coincidan con los valores de ruido de la columna se aplicarán en el orden indicado.
materiales
rango_ruidoDefine un rango de valores de ruido [mínimo, máximo] al que se debe aplicar este ajuste. Valor predeterminado: [0.0, 0.0] |
Minecraft: superficie_pantano
Similar a surface_parameters. Agrega detalles de la superficie del pantano.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Entero | sea_floor_depth | Controla la profundidad a la que debe situarse el suelo por debajo del nivel mundial del agua. | |
Cordón | sea_floor_material | Controla el tipo de bloque que se usa como piso para los cuerpos de agua en este bioma. | |
Cordón | top_material | Controla el tipo de bloque utilizado para la superficie de este bioma. | |
Cordón | mid_material | Controla el tipo de bloque utilizado en una capa debajo de la superficie de este bioma. | |
Cordón | Foundation_material | Controla el tipo de bloque utilizado a gran profundidad en este bioma. | |
Cordón | sea_material | Controla el bloque bajo el nivel del agua. |
Minecraft: superficie_oceana_congelada
Similar a surface_parameters. Agrega icebergs.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Entero | sea_floor_depth | Controla la profundidad a la que debe situarse el suelo por debajo del nivel mundial del agua. | |
Cordón | sea_floor_material | Controla el tipo de bloque que se usa como piso para los cuerpos de agua en este bioma. | |
Cordón | top_material | Controla el tipo de bloque utilizado para la superficie de este bioma. | |
Cordón | mid_material | Controla el tipo de bloque utilizado en una capa debajo de la superficie de este bioma. | |
Cordón | Foundation_material | Controla el tipo de bloque utilizado a gran profundidad en este bioma. | |
Cordón | sea_material | Controla el bloque bajo el nivel del agua. |
minecraft: mesa_surface
Similar a surface_parameters. Agrega estratos de colores y pilares opcionales.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Cordón | top_material | Controla el tipo de bloque utilizado para la superficie de este bioma. | |
Cordón | mid_material | Controla el tipo de bloque utilizado en una capa debajo de la superficie de este bioma. | |
Cordón | sea_floor_material | Controla el tipo de bloque que se usa como piso para los cuerpos de agua en este bioma. | |
Cordón | Foundation_material | Controla el tipo de bloque utilizado a gran profundidad en este bioma. | |
Entero | sea_floor_depth | Controla la profundidad a la que debe situarse el suelo por debajo del nivel mundial del agua. | |
Cordón | arcilla_material | ||
Cordón | hard_clay_material | ||
Boolean | bryce_pillars | ||
Boolean | has_forest | ||
Cordón | sea_material | Controla el bloque bajo el nivel del agua. |
minecraft: nether_surface
Utilice la generación de terreno predeterminada de Minecraft Nether con el uso de los parámetros escritos aquí.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Entero | sea_floor_depth | Controla la profundidad a la que debe situarse el suelo por debajo del nivel mundial del agua. | |
Cordón | sea_floor_material | Controla el tipo de bloque que se usa como piso para los cuerpos de agua en este bioma. | |
Cordón | top_material | Controla el tipo de bloque utilizado para la superficie de este bioma. | |
Cordón | mid_material | Controla el tipo de bloque utilizado en una capa debajo de la superficie de este bioma. | |
Cordón | Foundation_material | Controla el tipo de bloque utilizado a gran profundidad en este bioma. | |
Cordón | sea_material | Controla el bloque bajo el nivel del agua. |
minecraft: the_end_surface
Usa la generación de terreno predeterminada de Minecraft End.
minecraft: reglas de generación_de_mundo_de_mundo
Controle cómo se crea una instancia de este bioma (y luego se modifica potencialmente) durante la generación mundial.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Cordón | Hills_transformation | "", ["", 0] | Controla qué bioma se utiliza como subbioma común de este bioma. Se pueden utilizar múltiples biomas. |
Cordón | mutate_transformation | "" | Controla qué bioma se utiliza como subbioma raro de este bioma. |
Cordón | river_transformation | "" | Controla qué bioma se utiliza como ríos en este bioma. |
Cordón | Shore_transformation | "" | Controla qué bioma se utiliza como frontera entre el continente y el mar en este bioma. |
Lista | generate_for_climates | ["", 0] | Controla las categorías climáticas de la generación mundial que este bioma puede generar. Un solo bioma se puede asociar con múltiples categorías con diferentes ponderaciones. |
minecraft: nether_generation_rules
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Decimal | target_temperature | 0.0 | Controla qué tan caliente está este bioma en la lista. |
Decimal | target_humidity | 0.0 | |
Decimal | target_altitude | 0.0 | |
Decimal | target_weirdness | 0.0 | |
Decimal | de pérdida de peso | 0.0 | Controla la frecuencia con la que se generará el bioma. |
Biomas
Propiedades de definición de bioma
Estas propiedades son parte de la definición de bioma. Esto ayuda al sistema a determinar cómo analizar e inicializar este bioma.
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
formato_versión | Especifica la versión del juego en la que se creó este bioma. Si la versión es inferior a la versión actual, se le aplicará cualquier cambio realizado en el bioma en la versión básica. |
{"format_version": "1.13.0", "minecraft: biome": {"componentes": {...} ...}}
Propiedades de la descripción del bioma
Tipo | Nombre | Valor por defecto | Descripción |
---|---|---|---|
Cordón | identificador | El identificador de este bioma. El nombre puede incluir un espacio de nombres. |