Função de densidade

As funções de densidade compõem expressões matemáticas para obter um número de uma posição, armazenadas como arquivos JSON dentro de um pacote de dados no caminho data/<namespace>/worldgen/density_function.

Formato JSON

Uma função de densidade pode ser um número constante ou um objeto.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade.
  • Outros campos adicionais dependem do valor de  type, descrito abaixo.

Se o  type for constant, um formato abreviado é:

• : Um número constante. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).

Funções de criação

interpolated

Interpola em cada bloco em uma célula com base no valor da função de densidade de entrada de algumas células ao redor. O tamanho de cada célula é size_horizontal * 4 e size_vertical * 4. Usado frequentemente em combinação com flat_cache.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, interpolated).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

flat_cache

Calcula o valor por uma coluna 4*4 (o valor em cada bloco em uma coluna é o mesmo). E é calculado apenas uma vez por coluna, em Y=0. Usado frequentemente em combinação com interpolated.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, flat_cache).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

cache_2d

Calcula a densidade de entrada apenas uma vez por posição horizontal.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, cache_2d).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

cache_once

Se essa função de densidade for referenciada duas vezes, ela será calculada apenas uma vez por posição de bloco.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, cache_once).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

cache_all_in_cell

Usado pelo jogo em final_density e não deve ser referenciado em pacotes de dados.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, cache_all_in_cell).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

Funções com um argumento

abs

Calcula o valor absoluto da função de densidade de entrada.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, abs).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

square

Enquadra a entrada. (x^2)

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, square).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

cube

Cubifica a entrada (x^3).

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, cube).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

half_negative

Se a entrada for negativa, retorna metade da entrada. Caso contrário, retorna a entrada. (x < 0 ? x/2 : x)

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, half_negative).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

quarter_negative

Se a entrada for negativa, retorna um quarto da entrada. Caso contrário, retorna a entrada. (x < 0 ? x/4 : x)

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, quarter_negative).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

squeeze

Primeiro fixa a entrada entre -1 e 1, depois a transforma usando x/2 - x*x*x/24.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, squeeze).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

Funções com dois argumentos

add

Adiciona duas funções de densidade juntas.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, add).
  •  argument1: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  argument2: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

mul

Multiplica duas entradas.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, mul).
  •  argument1: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  argument2: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

min

Retorna o mínimo de duas entradas.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, min).
  •  argument1: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  argument2: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

max

Retorna o máximo de duas entradas.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, max).
  •  argument1: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  argument2: Uma função de densidade. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

Outras funções de densidade

blend_alpha

Usado no vanilla para uma transição suave entre chunks legados e o novos. ^{[mais informações necessárias]}

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, blend_alpha).

blend_offset

Usado no vanilla para uma transição suave entre chunks legados e o novos. ^{[mais informações necessárias]}

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, blend_offset).

blend_density

Usado no vanilla para uma transição suave entre chunks legados e o novos. ^{[mais informações necessárias]}

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, blend_density).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

beardifier

Adiciona bordas para estruturas (consulte o campo terrain_adaptation em Recurso de estrutura configurado). Seu valor é adicionado ao final_density na configuração de ruído do jogo. Não deve ser referenciado em pacotes de dados.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, beardifier).

old_blended_noise

Amostra um ruído herdado. ^{[mais informações necessárias]}

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, old_blended_noise).
  •  xz_scale: Valor entre 0,001 e 1000,0 (ambos inclusive).
  •  y_scale: Valor entre 0,001 e 1000,0 (ambos inclusive).
  •  xz_factor: Valor entre 0,001 e 1000,0 (ambos inclusive).
  •  y_factor: Valor entre 0,001 e 1000,0 (ambos inclusive).
  •  smear_scale_multiplier: Valor entre 1,0 e 8,0 (ambos inclusive).

noise

Amostra um ruído.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, noise).
  •  noise: Um ID de um ruído .
  •  xz_scale: Dimensiona X e Z antes da amostragem.
  •  y_scale: Dimensiona o Y antes da amostragem.

end_islands

Amostras na posição atual usando um algoritmo de ruído usado para ilhas do End. Seu valor mínimo é −0,84375 e seu valor máximo é 0,5625.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, end_islands).

weird_scaled_sampler

De acordo com o valor de entrada, dimensiona e aumenta (ou enfraquece) algumas regiões do ruído especificado e, em seguida, retorna o valor absoluto.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, weird_scaled_sampler).
  •  rarity_value_mapper: Pode ser type_1（A escala mínima é 0,75 e a máxima é 2,0）ou type_2（A escala mínima é 0,5 e a máxima é 3.0）.
  •  noise: Um ID de um ruído .
  •  input: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

shifted_noise

Semelhante ao noise, mas primeiro muda as coordenadas de entrada.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, shifted_noise).
  •  noise: Um ID de um ruído .
  •  xz_scale: Dimensiona o X e o Z antes da amostragem.
  •  y_scale: Dimensiona o Y antes da amostragem.
  •  shift_x: Função de densidade usada para compensar o valor X. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  shift_y: Função de densidade usada para compensar o valor Y. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  shift_z: Função de densidade usada para compensar o valor Z. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

range_choice

Calcula o valor de entrada e, dependendo desse resultado, retorna uma das duas outras funções de densidade. Basicamente, uma declaração if-then-else.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, range_choice).
  •  input: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  min_inclusive: O limite inferior. do intervalo. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  max_exclusive: O limite superior do intervalo. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  when_in_range: Função de densidade cujo valor é retornado quando a entrada está dentro do intervalo. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  when_out_of_range: Função de densidade cujo valor é retornado quando a entrada está fora do intervalo. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

shift_a

Amostra um ruído em (x/4, 0, z/4) e o multiplica por 4.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, shift_a).
  •  argument: Um ID de um ruído .

shift_b

Amostra um ruído em (z/4, x/4, 0) e o multiplica por 4.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, shift_b).
  •  argument: Um ID de um ruído .

shift

Amostra um ruído em (x/4, y/4, z/4) e depois o multiplica por 4.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, shift).
  •  argument: Um ID de um ruído .

clamp

Fixa a entrada entre dois valores.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, clamp).
  •  input: A função de densidade de entrada. Só pode ser uma função de densidade na forma de um objeto JSON ou um número constante.
  •  min: O limite inferior. Valor entre −1000000,0 e 1000000,0 (ambos incluídos).
  •  max: O limite superior. Valor entre −1000000,0 e 1000000,0 (ambos incluídos).

spline

Calcula uma spline cúbica.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, spline).
  •  spline: A spline. Pode ser um número ou um objeto.
    •  coordinate: A função de densidade usada para obter uma localização no spline. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
    •  points: (Não pode estar vazio) Lista de pontos do spline cúbico.
      •  location: A localização deste ponto.
      •  value: O valor deste ponto. Pode ser um número ou um objeto spline.
      •  derivative: A inclinação neste ponto.

constante

Um valor constante.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, constant).
  •  argument: Um valor constante. Valor entre −1000000,0 e 1000000,0 (ambos incluídos).

y_clamped_gradient

Bloqueia a coordenada Y entre from_y e to_y e, em seguida, mapeia-a linearmente para um intervalo.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, y_clamped_gradient).
  •  from_y: O valor a ser mapeado para from_value. Valor entre −4064 e 4062 (ambos incluídos).
  •  to_y: O valor a ser mapeado para to_value. Valor entre −4064 e 4062 (ambos incluídos).
  •  from_value: O valor para o qual mapear from_y. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  to_value: O valor para o qual mapear to_y. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).

Funções de densidade removidas

slide

Removido em 22w12a

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, slide).
  •  argument: A função de densidade de entrada. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

O legado "spline"

Removido em 22w11a

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, spline).
  •  spline: O spline. Pode ser um número ou um objeto.
    •  coordinate: A função de densidade usada para obter uma localização no spline. Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
    •  points: (Não pode estar vazio) Lista de pontos do spline cúbico.
      •  location: A localização deste ponto.
      •  value: O valor deste ponto. Pode ser um número ou um objeto spline.
      •  derivative: A inclinação neste ponto.
  •  min_value: O valor mínimo da saída. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  max_value: O valor máximo da saída. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).

terrain_shaper_spline

Removido em 22w11a

Calcula o spline a partir das configurações de ruído.

• : objeto raiz.
  •  type: O ID do tipo de função de densidade (neste caso, terrain_shaper_spline).
  •  spline: Pode ser offset, factor, ou jaggedness.
  •  min_value: O valor mínimo da saída. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  max_value: O valor máximo da saída. Valor entre −1.000.000,0 e 1.000.000,0 (ambos incluídos).
  •  continentalness: Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  erosion: Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.
  •  weirdness: Pode ser um ID de uma função de densidade ou uma função de densidade na forma de um objeto JSON ou um número constante.

Histórico

Edição Java
1.18.2		pre1			Funções de densidade adicionadas: absprettyaddprettybeardifierprettyblend_alphaprettyblend_densityprettyblend_offsetprettycache_2dprettycache_all_in_cellprettycache_onceprettyclampprettyconstantprettycubeprettyend_islandsprettyflat_cacheprettyhalf_negativeprettyinterpolatedprettymaxprettyminprettymulprettynoiseprettyold_blended_noiseprettyquarter_negativeprettyrange_choiceprettyshiftprettyshift_aprettyshift_bprettyshifted_noiseprettyslideprettysquareprettysqueezeprettyterrain_shaper_splineprettyweird_scaled_samplerprettyy_clamped_gradient.
		pre2			Função de densidade spline adicionada.
1.19		22w11a			Função de densidade terrain_shaper_spline removida.
					Removidos os campos min_valueprettymax_value em spline.
		22w12a			Função de densidade slide removida. Em vez disso, uma combinação de addprettymulprettyy_clamped_gradient é usada para obter o mesmo resultado.
					Adicionados campos para a função de densidade old_blended_noise: xz_scale, y_scale, xz_factor, y_factor, e smear_scale_multiplier.

Links externos

Este artigo faz referência Guia da função de densidade por Misode e Changelog técnico por Misode.