Portapapeles

El portapapeles es un almacenamiento temporal asociado con la sesión de WorldEdit del jugador actual.

Puede almacenar:

• Bloques de una selección cuboide
• Estados de bloques
• Aire, salvo que se excluya
• Entidades, cuando se solicite
• La posición relativa del jugador al crear la copia
• La dimensión y ubicación originales
• Transformaciones pendientes de rotación, volteo y escala

Crear una nueva copia reemplaza el contenido anterior del portapapeles.

Flujo de trabajo básico

El flujo habitual del portapapeles es:

1. Crea una selección cuboid o extend.
2. Colócate en el punto que funcionará como referencia de la estructura.
3. Copia o corta la selección.
4. Muévete al destino.
5. Pega el portapapeles.

;sel cuboid
;pos1
;pos2
;copy -a
;paste

Selecciones compatibles

Se puede crear directamente un portapapeles a partir de:

• cuboid
• extend

Los siguientes modos de selección no pueden copiarse directamente:

• sphere
• cyl
• convex

Para una estructura irregular, crea una selección cuboide alrededor de ella y excluye el aire:

;copy -a

Punto de referencia del portapapeles

Cuando se copia una región, WorldEdit registra la posición del jugador con respecto a la esquina mínima de la selección.

Ese desplazamiento relativo se reutiliza al pegar de forma normal.

Conceptualmente:

desplazamiento = esquina mínima de la selección - posición del jugador
posición de pegado = posición actual del jugador + desplazamiento

Colócate en una ubicación coherente antes de copiar. Por ejemplo, sitúate encima de un puente si quieres que los pegados posteriores coloquen el puente debajo de ti.

Utiliza una vista previa cuando el punto de referencia no esté claro:

;paste -n
;drawsel

Copiar con ;copy

;copy almacena la selección cuboide actual sin modificar el mundo.

;copy [-a] [-e] [-m <mask>]

Copia normal

;copy

Una copia normal incluye el aire y excluye las entidades.

Excluir el aire con -a

;copy -a

Utiliza -a cuando el espacio vacío copiado no deba borrar bloques en el destino.

Se recomienda para casas, árboles, estatuas, decoraciones y estructuras irregulares colocadas sobre terreno existente.

Incluir entidades con -e

;copy -e

Los jugadores no se incluyen.

Filtrar el origen con -m

;copy -m stone

La máscara filtra los bloques de la selección de origen.

Al utilizar una máscara, normalmente es más seguro combinarla con -a:

;copy -a -m stone

Sin -a, las posiciones del origen que no coincidan pueden convertirse en aire dentro del portapapeles y borrar bloques del destino al pegar.

Combinar banderas de copia

;copy -ae -m #existing

Una nueva copia también restablece a sus valores predeterminados la rotación y escala pendientes del portapapeles.

Cortar con ;cut

;cut copia la selección y reemplaza el área original con un patrón.

;cut [-a] [-e] [fill] [-m <mask>]

El patrón de relleno predeterminado es aire.

;cut

Utiliza otro patrón de relleno para el área original:

;cut stone

Filtra el origen con una máscara:

;cut -a dirt -m stone

En este ejemplo:

• stone es la máscara de origen.
• dirt es el patrón que queda en el área original.
• -a evita que las posiciones que no coinciden se conviertan en aire al pegar.

Incluye y elimina entidades con -e:

;cut -ae air -m #existing

Cortar modifica el mundo y puede deshacerse, pero deshacer la operación no limpia ni restaura el propio portapapeles.

Pegar con ;paste

;paste coloca el portapapeles actual en el mundo.

;paste [-o] [-s] [-n] [-m <mask>]

Pegado relativo

;paste

Un pegado normal utiliza:

• La posición actual del jugador
• El desplazamiento relativo guardado al copiar o cortar
• Las transformaciones pendientes de rotación, volteo y escala

Pegar en la ubicación original con -o

;paste -o

Esto requiere los datos de la dimensión y ubicación originales creados por ;copy o ;cut.

En la implementación actual, -o pega en la ubicación original sin aplicar las transformaciones acumuladas del portapapeles.

Seleccionar el resultado con -s

;paste -s

La selección se actualiza para cubrir todos los límites del portapapeles transformado.

Vista previa sin pegar con -n

;paste -n

No se coloca ningún bloque. WorldEdit solo selecciona el área donde aparecería el portapapeles.

Filtrar el destino con -m

;paste -m air

La máscara de pegado filtra los bloques ya presentes en el destino.

;paste -m stone

Esto se diferencia de las máscaras de copia:

Pegar sin aire

No existe una bandera -a documentada para ;paste en la implementación actual.

Excluye el aire al crear el portapapeles:

;copy -a
;paste

Entidades durante el pegado

No existe una bandera -e para ;paste.

Las entidades se incluyen al crear el portapapeles:

;copy -e
;paste

Los pegados repetidos pueden duplicar las entidades almacenadas.

Limpiar el portapapeles

;clearclipboard

Esto elimina el portapapeles actual de la sesión del jugador.

No elimina la selección, el historial, las estructuras exportadas, los degradados, las herramientas ni los pinceles.

Inspeccionar el portapapeles

Muestra las dimensiones y la información de tamaño del portapapeles:

;size -c

Muestra la distribución de bloques almacenada:

;distr -c

Separa los bloques por estados o valores de datos:

;distr -cd

El aire almacenado puede aparecer en la distribución salvo que se haya excluido al copiar o cortar.

Aire en el portapapeles

El aire forma parte del portapapeles salvo que se excluya.

Incluir aire resulta útil cuando los espacios vacíos deben limpiar deliberadamente el destino, como en habitaciones, ventanas, túneles o cavidades internas.

Excluir el aire resulta útil cuando la estructura debe colocarse sobre bloques existentes sin eliminarlos.

;copy -a

Al filtrar bloques de origen, utiliza -a y -m para evitar que las posiciones rechazadas se conviertan en aire al pegar:

;copy -a -m stone,andesite

Entidades en el portapapeles

Las entidades se excluyen de forma predeterminada.

;copy -e

;cut -e

Los jugadores nunca se incluyen.

Las transformaciones del portapapeles pueden afectar la posición y orientación de las entidades. Prueba las estructuras con muchas entidades antes de utilizarlas en áreas importantes.

Transformaciones del portapapeles

Sin -w, los siguientes comandos modifican la transformación pendiente del portapapeles en lugar del mundo:

• ;rotate
• ;flip
• ;scale

La estructura original permanece sin cambios hasta que se pega el portapapeles transformado.

Rotar el portapapeles

;rotate <rotateY> [rotateX] [rotateZ]

Rota 90 grados alrededor del eje Y:

;rotate 90
;paste

Rota alrededor de X:

;rotate 0 90
;paste

Rota alrededor de Z:

;rotate 0 0 90
;paste

Los múltiplos de 90 grados suelen producir los resultados más predecibles en la cuadrícula de bloques.

Voltear el portapapeles

;flip [direction]

La dirección predeterminada es left.

;flip east
;paste

Las direcciones admitidas incluyen left, right, north, south, east, west, up y down.

Escalar el portapapeles

Escala uniforme:

;scale <scale>

Escalas horizontal y vertical separadas:

;scale <scaleXZ> <scaleY>

Escalas independientes por eje:

;scale <scaleX> <scaleY> <scaleZ>

Duplica el tamaño del portapapeles:

;scale 2
;paste

Evita una escala de 0. Reducir una estructura puede fusionar bloques y eliminar detalles, mientras que ampliarla repite bloques en el nuevo volumen.

Transformaciones acumuladas

Las transformaciones del portapapeles se acumulan hasta que se crea una nueva copia o se compensan manualmente.

;copy -a
;rotate 90
;flip east
;scale 1.5
;paste -s

Dos rotaciones de 90 grados producen una rotación total de 180 grados.

No existe un comando documentado por separado para restablecer las transformaciones del portapapeles. Crear una nueva copia es la forma más segura de restablecerlas.

La bandera -w transforma directamente en el mundo los bloques seleccionados. Esa es una transformación de región del mundo, no una transformación del portapapeles.

Patrón del portapapeles

#clipboard utiliza los bloques almacenados como un patrón tridimensional repetitivo.

#clipboard

Desplaza la alineación del patrón repetido:

#clipboard@[x,y,z]

Ejemplo:

#clipboard@[2,0,1]

A diferencia de ;paste, el patrón del portapapeles se repite para rellenar una operación.

La implementación actual lee directamente el búfer almacenado del portapapeles y no aplica las transformaciones pendientes de rotación, escala ni desplazamiento relativo del pegado.

Colocar el portapapeles a lo largo de una ruta

;path coloca copias repetidas del portapapeles a lo largo de los puntos de una selección convex.

;path [spacing]

Rota cada copia para que siga la ruta:

;path [spacing] rotated <offset>

Ejemplo:

;sel convex
;pos1
;pos2
;pos2
;pos2
;path 4 rotated 0

Crea el portapapeles con -a cuando no debas colocar aire a lo largo de la ruta.

path centra el portapapeles alrededor de los puntos calculados de la ruta y no utiliza el desplazamiento relativo del jugador guardado durante la copia.

Estructuras persistentes con ;export y ;import

El portapapeles normal es temporal. Las estructuras exportadas pueden volver a cargarse más adelante.

Exportar una selección

;export [-a] [-e] <name>

Ejemplo:

;export -a project:house

El analizador actual proporciona:

• -a para excluir aire
• -e para incluir entidades

El comportamiento exacto puede variar entre versiones, por lo que debes probar cómo se gestiona el aire exportado antes de depender de ello.

Importar al portapapeles

;import <name>

Ejemplo:

;import project:house
;paste

Importar carga la estructura en el portapapeles con la rotación y escala predeterminadas.

Las estructuras importadas no proporcionan los datos de ubicación original requeridos por ;paste -o. Utiliza un pegado relativo normal después de importar.

Duración y dimensiones del portapapeles

El portapapeles pertenece a la sesión del jugador.

Según el documento de origen, la sesión de un jugador desconectado normalmente se conserva durante aproximadamente 10 minutos mientras el servidor siga activo. Cerrar el mundo o servidor elimina la sesión y su portapapeles.

Un pegado normal puede realizarse en otra dimensión del mismo mundo activo porque utiliza la dimensión actual del jugador.

paste -o requiere la dimensión original.

Para transferir entre mundos distintos, utiliza estructuras exportadas y el proceso de transferencia externo compatible.

Modo de rendimiento

El modo de rendimiento de WorldEdit puede utilizar una representación más sencilla del portapapeles:

;worldedit perf

El documento de origen señala estas limitaciones del portapapeles en el modo de rendimiento:

• El aire siempre se incluye
• La rotación se limita al eje Y
• Las transformaciones avanzadas se reducen

Utilízalo principalmente para operaciones grandes y sencillas de copiar y pegar.

Errores comunes

Copiar una selección que no es cuboide

Utiliza cuboid o extend antes de ;copy o ;cut.

El aire pegado elimina bloques existentes

Crea el portapapeles con:

;copy -a

Una máscara de copia produce aire

Utiliza:

;copy -a -m <mask>

La estructura aparece demasiado lejos

El desplazamiento de referencia se determinó según tu posición al copiar. Vuelve a copiar desde un punto de referencia más útil o utiliza una vista previa con ;paste -n.

Utilizar ;paste -a

Actualmente no existe una bandera -a para el pegado. Excluye el aire al copiar o cortar.

El pegado original ignora la rotación

En la implementación actual, ;paste -o utiliza la ubicación original sin las transformaciones acumuladas del portapapeles.

Un portapapeles importado no puede utilizar ;paste -o

Las estructuras importadas no contienen los campos de ubicación y dimensión originales requeridos por -o.

El patrón del portapapeles ignora la rotación

#clipboard lee el búfer almacenado y no aplica las transformaciones pendientes del portapapeles.

El portapapeles desaparece

El portapapeles depende de la sesión. Exporta las estructuras importantes cuando deban conservarse después de que termine la sesión.

Referencia rápida

;copy [-a] [-e] [-m <mask>]
;cut [-a] [-e] [fill] [-m <mask>]
;paste [-o] [-s] [-n] [-m <mask>]
;clearclipboard

;size -c
;distr -c
;distr -cd

;rotate <Y> [X] [Z]
;flip [direction]
;scale <value>
;scale <XZ> <Y>
;scale <X> <Y> <Z>

#clipboard
#clipboard@[x,y,z]
;path [spacing]
;path [spacing] rotated <offset>

;export [-a] [-e] <name>
;import <name>