Patrón

Un patrón describe el bloque, mezcla, degradado o distribución generada que WorldEdit coloca durante una operación.

El marcador de patrón aparece como:

<pattern>

El marcador no se escribe literalmente. Reemplázalo con un patrón válido:

stone
stone,andesite,gravel
70%stone,20%andesite,10%gravel
$wood.rad
#blob5(stone,dirt)

Patrones de un solo bloque

El patrón más sencillo es un identificador de bloque.

stone
spruce_planks
glowstone

Los bloques de Minecraft también pueden utilizar el espacio de nombres completo:

minecraft:stone

Los bloques de otro complemento deben incluir su espacio de nombres:

my_addon:custom_block

Para inspeccionar el identificador del bloque que estás mirando:

;blockid

Estados de bloques

Los estados de bloques controlan propiedades como la orientación, el eje, el crecimiento, la variante o la colocación superior e inferior.

Utiliza corchetes después del identificador del bloque:

block[state=value]

Separa varios estados con comas:

block[state1=value,state2=value]

Ejemplo:

stone_slab[stone_slab_type=brick,top_slot_bit=true]

Cuando se omite un estado, WorldEdit utiliza el estado predeterminado de ese bloque.

Valores de datos

Algunas variantes antiguas de bloques pueden utilizar un valor de datos numérico:

block:value

Ejemplo:

wool:1

Para inspeccionar un identificador de bloque junto con su valor de datos:

;blockid -d

No combines un valor de datos y estados de bloque en el mismo patrón:

wool:1[state=value]

Para construcciones nuevas, utiliza preferentemente identificadores de bloques escritos y estados explícitos.

Mezclas aleatorias

Una mezcla aleatoria selecciona uno de varios patrones para cada posición afectada.

Separa las entradas con comas y no añadas espacios:

stone,andesite,gravel

Sin pesos, cada entrada tiene aproximadamente la misma probabilidad:

Otro ejemplo:

spruce_planks,stripped_spruce_wood,mangrove_wood

Mezclas aleatorias ponderadas

Coloca un peso antes de % para controlar la frecuencia con la que se selecciona cada entrada.

weight%pattern,weight%pattern

Ejemplo:

70%stone,20%andesite,10%gravel

Los pesos también pueden ser relativos y no necesitan sumar 100:

7%stone,2%andesite,1%gravel

La proporción 7/2/1 equivale a 70/20/10.

Normalizar pesos relativos

Utiliza esta fórmula para convertir pesos relativos en porcentajes:

porcentaje = peso individual / suma de todos los pesos × 100

Para los pesos 7, 2 y 1:

peso total = 7 + 2 + 1 = 10
stone        = 7 / 10 × 100 = 70%
andesite     = 2 / 10 × 100 = 20%
gravel       = 1 / 10 × 100 = 10%

Cada entrada ponderada también puede ser otro tipo de patrón:

20%*wool,80%stone

En este ejemplo:

• 20%*wool utiliza estados válidos aleatorios para la lana.
• 80%stone utiliza un patrón fijo de piedra.

Cantidades estimadas de bloques

La selección aleatoria produce totales exactos diferentes en cada ejecución, pero puedes calcular una estimación.

bloques estimados = posiciones totales × porcentaje / 100

Para 10,000 posiciones y la siguiente mezcla:

70%stone,20%andesite,10%gravel

La distribución estimada es:

Para 3,456 posiciones:

stone       = 3456 × 0.70 = 2419.2
andesite    = 3456 × 0.20 = 691.2
gravel      = 3456 × 0.10 = 345.6

Los bloques no pueden ser fraccionarios, por lo que los resultados reales serán números enteros cercanos y pueden variar porque el patrón es aleatorio.

Calcular un porcentaje a partir de una cantidad deseada

porcentaje = bloques deseados / posiciones totales × 100

Para obtener aproximadamente 750 bloques de glowstone en 5,000 posiciones:

750 / 5000 × 100 = 15%

El patrón resultante puede escribirse así:

15%glowstone,85%stone

Estados aleatorios con *

El prefijo * selecciona estados válidos aleatorios para el identificador de bloque indicado.

*block

Ejemplo:

*log

Otro ejemplo:

*oak_stairs

El resultado depende de los estados admitidos por ese identificador de bloque.

*log no garantiza todos los tipos de madera porque varias maderas utilizan identificadores diferentes.

Conservar o cambiar estados con ^

El prefijo ^ cambia un tipo de bloque o estados seleccionados mientras intenta conservar las propiedades restantes.

Cambiar el tipo y conservar los estados

^acacia_stairs

Esto puede cambiar el material de una escalera mientras intenta conservar su orientación y colocación.

Cambiar únicamente estados específicos

^[growth=7]

Esto conserva el tipo de bloque actual y cambia únicamente el estado especificado.

También se pueden combinar un tipo de bloque y estados:

^block[state=value]

Patrón del portapapeles

#clipboard utiliza el contenido copiado como un patrón repetitivo.

#clipboard

Utiliza un desplazamiento para mover el origen del patrón:

#clipboard@[x,y,z]

Ejemplo:

#clipboard@[0,1,0]

Esto desplaza el origen del patrón repetitivo un bloque hacia arriba.

Patrón de la mano

#hand utiliza el bloque sostenido en la mano principal.

#hand

El objeto sostenido debe representar un bloque válido.

El patrón void

void no coloca ningún bloque en esa posición.

void

Resulta útil cuando se combina con otros patrones:

stone,void

Aproximadamente la mitad de las posiciones recibe piedra, mientras que las demás permanecen sin cambios.

Una versión ponderada proporciona mayor control:

25%glowstone,75%void

Comparación entre void y air

air

air reemplaza el bloque existente con aire.

void

void omite la posición y conserva el bloque existente.

Degradados

Un degradado crea una transición ordenada entre varios niveles de patrones.

Crear un degradado

;gradient create <name> <pattern1> <pattern2> <pattern3>

Ejemplo:

;gradient create nature stone dirt grass_block

Los espacios separan los niveles del degradado.

Las comas crean una mezcla aleatoria dentro de un nivel:

;gradient create terrain stone,andesite dirt,coarse_dirt grass_block,moss_block

Los niveles se interpretan así:

stone,andesite
      ↓
dirt,coarse_dirt
      ↓
grass_block,moss_block

Referenciar un degradado guardado

Un degradado guardado utiliza el prefijo $:

$nature

El prefijo $ es obligatorio.

Direcciones absolutas

$nature.north
$nature.south
$nature.east
$nature.west
$nature.up
$nature.down

Aquí no se utilizan direcciones relativas como left, right, forward o back.

Degradado radial

$nature.rad

Un degradado radial avanza desde el centro de la operación hacia su límite exterior:

primer patrón = centro
último patrón = límite exterior

Definición de ejemplo:

;gradient create light deepslate_gold_ore spruce_planks glowstone birch_planks

Utilízalo como patrón radial:

$light.rad

Degradado desde el jugador

$nature.lit

Esto utiliza la posición del jugador como referencia del degradado.

Crear un degradado a partir de una selección

;gradient create -s <name>

Ejemplo:

;gradient create -s wall

WorldEdit lee la selección a lo largo de su lado más largo y la utiliza como mapa del degradado.

Controlar la transición

;gradient create -f <fade> <name> <patterns...>

Ejemplo con una transición brusca:

;gradient create -f 0 contrast black_concrete white_concrete

Administrar degradados guardados

;gradient list
;gradient delete nature

Crear un degradado con un nombre existente reemplaza su definición anterior.

Comprender el orden del degradado

Un degradado es ordenado, no ponderado aleatoriamente.

inicio → A → B → C → D → final

Para un degradado radial:

centro → A → B → C → D → límite exterior

Invierte la lista de patrones para invertir la transición:

D C B A

La cantidad exacta de bloques asignada a cada etapa depende de la forma, el tamaño y la dirección de la operación.

Patrones blob

Un patrón blob agrupa los materiales en manchas en lugar de seleccionar cada posición de manera independiente.

#blob<size>(patterns)

Ejemplo básico:

#blob5(stone,dirt)

Un número menor crea grupos más pequeños:

#blob2(stone,andesite)

Un número mayor crea grupos más amplios:

#blob10(stone,andesite)

Los patrones blob pueden contener entradas ponderadas:

#blob6(70%stone,30%andesite)

Ejemplo con varios materiales de terreno:

#blob8(dirt,coarse_dirt,podzol)

Combinar tipos de patrones

Se pueden anidar o mezclar distintos tipos de patrones.

Material aleatorio con posiciones sin cambios

20%glowstone,80%void

Estados aleatorios con un bloque fijo

25%*log,75%stone

Blob con varios materiales

#blob5(stone,andesite,gravel)

Blob ponderado

#blob6(70%stone,20%andesite,10%gravel)

Degradado creado con mezclas aleatorias

;gradient create terrain stone,andesite dirt,coarse_dirt grass_block,moss_block

En esta definición:

• Las comas crean una mezcla aleatoria dentro de un nivel.
• Los espacios separan los niveles ordenados del degradado.

Selector de patrones

El selector de patrones es un objeto incluido en el kit de WorldEdit. Permite seleccionar materiales sin escribir manualmente sus identificadores.

Para obtener el kit:

;kit

Utiliza el selector de patrones sobre un bloque sin agacharte para elegir un patrón.

Agáchate y úsalo sobre bloques adicionales para añadir esos materiales a la mezcla.

La documentación no define un identificador de patrón para comandos como $picker. En los comandos escritos, introduce el patrón explícitamente.

Ejemplo mínimo de uso

Esta página se centra en la sintaxis de los patrones y no en los comandos que los utilizan. El siguiente ejemplo solo muestra dónde aparece el argumento de patrón:

;set 60%stone,25%andesite,15%gravel

La parte correspondiente al patrón es:

60%stone,25%andesite,15%gravel

El mismo patrón puede utilizarse en cualquier lugar donde WorldEdit espere un argumento <pattern>.

Errores comunes

Traducir identificadores de bloques

Incorrecto:

birch_planks_in_spanish

Correcto:

birch_planks

Confundir troncos y bloques de madera

oak_log
oak_wood
stripped_oak_log
stripped_oak_wood

Inspecciona el identificador exacto del bloque cuando sea necesario:

;blockid

Confundir void con air

air  = reemplaza el bloque actual con aire
void = deja la posición actual sin cambios

Olvidar $ en un degradado

Incorrecto:

wood.rad

Correcto:

$wood.rad

Añadir espacios dentro de una mezcla aleatoria

Evita:

stone, andesite, gravel

Utiliza:

stone,andesite,gravel

Confundir comas y espacios en los degradados

stone,andesite dirt,coarse_dirt grass_block

• Las comas mezclan patrones dentro de un nivel.
• Los espacios separan diferentes niveles del degradado.

Suponer que el selector de patrones tiene un identificador

No existe un identificador de patrón documentado como $picker para utilizarlo en comandos escritos.

Referencia rápida

Plantillas reutilizables

<block>

<block1>,<block2>,<block3>

<weight>%<block1>,<weight>%<block2>

*<block>

^<block>[state=value]

#blob<size>(<pattern1>,<pattern2>)

$<name>.rad