Máscara

Una máscara es una condición que decide si un bloque o una posición puede participar en una operación.

<mask>

El marcador no se escribe literalmente. Reemplázalo con una expresión de máscara válida.

Una máscara no determina qué bloque se coloca. Solo determina qué bloques o posiciones existentes cumplen la condición.

;replace stone dirt

En este ejemplo:

• stone es la máscara.
• dirt es el patrón.

Máscaras de bloques

La máscara más sencilla es un identificador de bloque.

stone

Un identificador de bloque sin estados coincide con ese bloque sin importar sus estados actuales.

Se puede incluir un espacio de nombres:

minecraft:stone

Los bloques de otro complemento deben utilizar su propio espacio de nombres:

my_addon:custom_block

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

;blockid

Máscaras de estados de bloques

Una máscara de bloque puede exigir uno o varios estados exactos.

block[state=value]

Separa varios estados con comas:

block[state1=value,state2=value]

Ejemplo:

oak_stairs[weirdo_direction=0,upside_down_bit=false]

Los nombres de los estados y sus valores admitidos pueden cambiar entre versiones de Minecraft.

Unión con ,

Una coma representa O. Solo una condición necesita coincidir.

mask1,mask2,mask3

Ejemplo:

stone,dirt,gravel

Esto coincide con piedra, tierra o grava.

No añadas espacios después de las comas dentro de una unión.

Intersección con espacios

Un espacio representa Y. Todas las condiciones deben coincidir.

mask1 mask2

Como los comandos también utilizan espacios para separar argumentos, encierra toda la expresión de máscara entre comillas:

"stone #surface"

Esto coincide con bloques que son piedra y, al mismo tiempo, bloques expuestos en una superficie.

Agrupación con paréntesis

Los paréntesis agrupan partes de una expresión compleja y hacen explícita la prioridad de los operadores.

"(stone,andesite) #surface"

Esto significa:

(stone O andesite) Y surface

Utiliza paréntesis al combinar uniones, intersecciones, negaciones o máscaras desplazadas.

Negación con !

El prefijo ! invierte una máscara.

!mask

Coincide con todo excepto el aire:

!air

Excluye un grupo completo:

!(sand,gravel,dirt)

La negación también puede aplicarse a máscaras avanzadas:

"#surface !#shadow"

Bloques existentes con #existing

#existing coincide con todos los bloques que no sean aire.

#existing

Es aproximadamente equivalente a:

!air

#existing significa que no es aire. No significa necesariamente que sea sólido. Puede incluir fluidos, vegetación y otros bloques que no sean aire.

Máscaras desplazadas con < y >

Las máscaras desplazadas inspeccionan un bloque vertical vecino.

Coincide con tierra que tenga aire encima:

"dirt <air"

Coincide con aire que tenga piedra debajo:

"air >stone"

Las condiciones desplazadas pueden contener máscaras agrupadas:

"air >(dirt,grass_block)"

El analizador actual admite desplazamientos anidados:

<<air

Esto comprueba dos bloques por encima de la posición evaluada. Prueba los desplazamientos anidados en un área pequeña antes de utilizarlos en una operación grande.

Máscaras aleatorias con %

Una máscara aleatoria evalúa cada posición de forma independiente con la probabilidad especificada.

%percentage

Coincide aproximadamente con el 20 % de todas las posiciones evaluadas:

%20

Combínala con otra máscara para que coincida aproximadamente con el 20 % de la piedra:

"stone %20"

El resultado es probabilístico, no una cantidad exacta de bloques. Repetir la misma operación puede hacer que coincidan posiciones diferentes.

Máscaras únicamente de estados

Las máscaras únicamente de estados comparan estados de bloques sin exigir un identificador de bloque específico.

Hay dos modos disponibles:

• Flexible: ^[state=value]
• Estricto: ^=[state=value]

Coincidencia flexible de estados

^[state=value]

La forma flexible coincide cuando:

• El bloque tiene el estado con el valor solicitado, o
• El bloque no tiene ese estado.

Por este motivo, puede coincidir con más bloques de los esperados.

Coincidencia estricta de estados

^=[state=value]

La forma estricta exige que el bloque contenga el estado y que tenga exactamente el valor solicitado.

Ejemplo:

^=[pillar_axis=0]

Utiliza la forma estricta cuando el estado deba existir.

Varias condiciones de estado

^[state1=value,state2=value]

^=[state1=value,state2=value]

Máscaras de superficie

#surface coincide con un bloque que no sea aire y que tenga al menos un bloque de aire directamente adyacente.

#surface

Alias:

#exposed

Se comprueban las seis direcciones adyacentes:

• Arriba
• Abajo
• Norte
• Sur
• Este
• Oeste

Combínala con una máscara de bloque:

"stone #surface"

La implementación comprueba específicamente si hay aire adyacente. Un bloque junto a agua o lava no se considera necesariamente expuesto.

Rangos de inclinación de superficie

Una máscara de superficie puede limitar el ángulo aproximado de inclinación.

#surface[min:max]

Ejemplos:

#surface[0:15]

#surface[10:45]

#surface[50:90]

Conceptualmente, el rango se mide entre 0° y 90°.

La vegetación, las flores y los bloques decorativos pequeños pueden afectar la inclinación calculada.

En latest, utiliza #surface[min:max] en lugar de la sintaxis anterior #slope[min:max].

Máscaras de sombra

#shadow coincide con los bloques que no son visibles desde la referencia de colocación actual de WorldEdit.

#shadow

Coincide con bloques expuestos ocultos:

"#surface #shadow"

Coincide con bloques expuestos visibles:

"#surface !#shadow"

Para obtener un mejor rendimiento, combina #shadow con #surface en lugar de evaluar cada bloque interno.

Máscaras de etiquetas de bloques

El analizador actual admite máscaras basadas en etiquetas de bloques.

##tag

Ejemplo con espacio de nombres:

##my_addon:natural_block

Las etiquetas disponibles dependen de Minecraft, los complementos instalados y las etiquetas expuestas por la API. No supongas que una etiqueta existe sin comprobarlo.

Máscaras globales con ;gmask

Una máscara global se almacena en la sesión de WorldEdit del jugador y se aplica a las operaciones compatibles.

;gmask [mask]

Establece una máscara global:

;gmask #existing

Establece una máscara global compuesta:

;gmask "stone #surface"

Limpia la máscara global activa ejecutando el comando sin ningún argumento:

;gmask

Una máscara global pertenece a la sesión del jugador actual. No es una regla para todo el servidor.

No todos los comandos utilizan la máscara global. Cuando un comando acepte un argumento directo <mask>, [mask] o -m <mask>, utiliza preferentemente esa máscara directa.

Selector de máscaras

El kit de WorldEdit incluye un selector de máscaras.

;kit

• Úsalo sobre un bloque sin agacharte para crear una nueva máscara global.
• Agáchate y úsalo sobre bloques adicionales para añadirlos como una unión.
• Limpia la máscara global resultante con ;gmask.

El selector de máscaras almacena la permutación completa del bloque elegido, incluidos sus estados. Una máscara escrita manualmente como oak_stairs es más amplia porque no exige una orientación exacta salvo que se especifiquen estados.

Máscaras de destino de pincel con ;mask

;mask controla qué bloques de destino puede modificar el pincel sostenido.

;mask [mask]

Establece una máscara de destino para el pincel:

;mask #existing

Límpiala:

;mask

La máscara pertenece a la configuración del pincel asociada con el objeto sostenido.

Máscaras de trazado de pincel con ;tracemask

;tracemask controla qué bloques puede seleccionar un pincel como objetivo o utilizar como punto de impacto.

;tracemask [mask]

Establece una máscara de trazado:

;tracemask stone

Límpiala:

;tracemask

La diferencia es:

Combinar máscaras activas

Las máscaras aplicadas mediante distintos sistemas se combinan como una intersección. Todas las condiciones activas deben coincidir.

Conceptualmente:

máscara directa
Y máscara global
Y máscara de pincel

Una combinación incompatible puede impedir que una operación modifique algo.

Antes de diagnosticar un problema con una máscara, limpia las máscaras temporales:

;mask
;tracemask
;gmask

Después, activa únicamente la condición necesaria para la operación actual.

Errores comunes

Confundir una máscara con un patrón

Una máscara selecciona el destino existente. Un patrón determina el resultado que se coloca.

Olvidar las comillas

Una intersección que contenga espacios debe escribirse entre comillas.

Incorrecto:

stone #surface

Correcto:

"stone #surface"

Añadir espacios después de las comas

Evita:

stone, dirt, gravel

Utiliza:

stone,dirt,gravel

Confundir < y >

<air   = aire arriba
>stone = piedra abajo

Considerar que #existing solo representa bloques sólidos

#existing significa cualquier bloque que no sea aire.

Utilizar coincidencia flexible cuando se necesita coincidencia estricta

Utiliza ^=[state=value] cuando el estado deba existir en el bloque.

Esperar un porcentaje aleatorio exacto

%20 es una probabilidad independiente para cada posición. No garantiza exactamente un 20 % del total.

Olvidar una máscara global o de pincel activa

Una máscara anterior puede combinarse silenciosamente con la actual y hacer que la condición final sea demasiado restrictiva.

Referencia rápida

Plantillas reutilizables

<block>

<mask1>,<mask2>,<mask3>

"<mask1> <mask2>"

!<mask>

"<mask> >(<mask1>,<mask2>)"

"<mask> %<percentage>"

^=[state=value]

#surface[min:max]