Historial

Permite:

• Deshacer una o más acciones.
• Rehacer acciones deshechas anteriormente.
• Restaurar algunas selecciones asociadas con una operación.
• Limpiar toda la cadena de deshacer y rehacer.

;set stone
;undo
;redo

El historial es un sistema de seguridad temporal. No es una copia de seguridad permanente del mundo.

Acciones del historial

Una acción del historial representa una operación de WorldEdit completada.

Un comando puede modificar un bloque, miles de bloques o varias regiones separadas y aun así contar como una sola acción.

Ejemplos de comandos que normalmente crean acciones en el historial:

;set stone
;replace dirt grass_block
;paste
;move 10 east

Los comandos que no modifican directamente los bloques del mundo normalmente no crean entradas en el historial de bloques:

;copy
;gmask stone
;sel cuboid
;pos1
;pos2

Qué almacena una entrada del historial

Una acción completada puede almacenar:

• El estado de los bloques antes de la operación.
• El estado de los bloques después de la operación.
• Una o más regiones afectadas.
• Una selección opcional antes y después de la operación.
• El volumen potencial de bloques utilizado para comprobar los límites de cambios.

Conceptualmente:

UNDO = estado del mundo antes de la acción
REDO = estado del mundo después de la acción

redo restaura el resultado guardado. No vuelve a ejecutar el comando original.

Deshacer acciones

;undo restaura uno o más estados anteriores del historial.

;undo [times]

Valor predeterminado:

times = 1

Deshaz la acción más reciente:

;undo

Deshaz cinco acciones:

;undo 5

WorldEdit comienza con la acción disponible más reciente.

Si hay menos acciones disponibles que las solicitadas, procesa todas las disponibles y después se detiene.

Rehacer acciones

;redo vuelve a aplicar una o más acciones que fueron deshechas anteriormente.

;redo [times]

Valor predeterminado:

times = 1

Rehaz una acción:

;redo

Rehaz cinco acciones:

;redo 5

Las acciones se rehacen en orden cronológico.

Cadena de deshacer y rehacer

Considera esta secuencia de acciones:

A → B → C → D

Después de ejecutar:

;undo 2

El estado actual es, conceptualmente:

A → B
C y D están disponibles para rehacer

Después de ejecutar:

;redo

El estado pasa a ser:

A → B → C

Crear una nueva acción después de deshacer

Crear una nueva edición del mundo después de deshacer elimina la rama anterior de acciones disponibles para rehacer.

Cadena original:

A → B → C

Deshaz dos acciones:

;undo 2

Crea una nueva acción D:

A → D

La rama antigua B → C se elimina permanentemente del historial actual.

Limpiar el historial

;clearhistory elimina toda la cadena de deshacer y rehacer del jugador actual.

;clearhistory

Elimina:

• Las acciones disponibles para deshacer.
• Las acciones disponibles para rehacer.
• Los búferes temporales del historial.

No modifica:

• Los bloques actuales del mundo.
• La selección actual.
• El portapapeles.
• Los degradados.
• Las máscaras.
• Los pinceles ni las herramientas.

Limpiar el historial no se puede deshacer.

Tamaño del historial

La configuración predeterminada almacena hasta:

maxHistorySize = 25

El límite cuenta acciones, no bloques individuales.

Cuando una nueva acción supera el tamaño configurado del historial, se elimina la acción almacenada más antigua.

Un historial más grande puede consumir bastante más memoria, ya que una sola acción puede guardar tanto los estados anteriores como los resultantes de varias regiones.

Sesiones de jugador

El historial pertenece a la sesión individual de WorldEdit de cada jugador.

Jugador A → Historial A
Jugador B → Historial B

Los comandos actuales actúan sobre el historial del jugador que los ejecuta. No aceptan el nombre de otro jugador como destino del historial.

La retención predeterminada de una sesión desconectada es aproximadamente:

ticksToDeleteSession = 12000 ticks
12000 ticks ≈ 10 minutos

El historial puede seguir disponible después de volver a conectarse mientras:

• El mundo o servidor continúe activo.
• La sesión no haya expirado.
• No haya transcurrido el tiempo de retención configurado.

El historial se pierde cuando el mundo o servidor se cierra y las sesiones son eliminadas.

Acciones con varias regiones

Una sola acción del historial puede contener más de una región afectada.

Por ejemplo, mover una estructura puede registrar tanto:

región original
región de destino

Deshacer esa única acción intenta restaurar ambas áreas al mismo tiempo.

Varias copias creadas por una operación como stack también pueden almacenarse como una sola acción completada.

Historial de selección

El historial no es un sistema general para deshacer todos los comandos de selección.

No debes esperar que comandos como estos creen acciones normales en el historial:

;pos1
;pos2
;expand
;contract
;shift

Algunas operaciones que modifican el mundo registran explícitamente sus selecciones anteriores y resultantes.

Entre ellas se incluyen las operaciones que utilizan banderas de actualización de selección:

;paste -s
;paste -n
;move -s
;stack -s
;rotate -ws 90
;flip -ws east
;scale -ws 2

Deshacer estas acciones puede restaurar tanto el mundo como la selección anterior.

Una vista previa creada con ;paste -n puede generar una acción en el historial de selección aunque no coloque bloques.

Historial y estado del portapapeles

El historial y el portapapeles son sistemas independientes.

• ;copy cambia el portapapeles, pero no el mundo.
• ;cut cambia el mundo y puede deshacerse.
• ;paste cambia el mundo y puede deshacerse.
• ;rotate, ;flip y ;scale aplicados solo al portapapeles no crean acciones en el historial del mundo.
• Las transformaciones que utilizan -w modifican el mundo y pueden entrar en el historial.

Deshacer restaura las regiones del mundo registradas. No restaura un portapapeles anterior ni transformaciones anteriores del portapapeles.

Rehacer resultados aleatorios

Rehacer restaura el resultado exacto almacenado de la acción original.

;set 50%stone,50%andesite
;undo
;redo

La operación de rehacer restaura la misma distribución aleatoria guardada. No genera un nuevo patrón aleatorio.

Volver a ejecutar el comando ;set original puede producir una distribución diferente.

Entidades

Los búferes actuales del historial regional se centran en los bloques y no incluyen entidades de manera predeterminada.

Por lo tanto, las operaciones que involucren entidades pueden no restaurarse por completo al deshacer.

Entre las posibles limitaciones se incluyen:

• Las entidades eliminadas podrían no regresar.
• Las entidades duplicadas podrían permanecer.
• La posición o los datos de una entidad podrían no reconstruirse.
• Los jugadores no se incluyen como entidades del portapapeles.

Crea una copia de seguridad independiente antes de editar áreas que contengan entidades importantes.

Efectos indirectos de Minecraft

El historial registra los cambios directos realizados por WorldEdit. No registra automáticamente todas las consecuencias posteriores producidas por Minecraft.

Entre los ejemplos se incluyen:

• Agua o lava en movimiento.
• Propagación del fuego.
• Explosiones.
• Redstone o actualizaciones de bloques.
• Cambios causados por otro complemento.

Por ejemplo, deshacer la colocación de agua puede restaurar la región editada directamente, mientras que el agua que fluyó fuera de esa región podría permanecer.

Dimensiones

Por seguridad, ejecuta deshacer y rehacer en la misma dimensión donde se realizó la edición original.

La implementación actual puede cargar los búferes almacenados utilizando la dimensión actual del jugador.

realizar la edición en Overworld
volver a Overworld
;undo

Antes de deshacer:

1. Regresa a la dimensión original.
2. Acércate a la región afectada.
3. Permite que se carguen los chunks necesarios.
4. Ejecuta ;undo o ;redo.

Operaciones grandes y activas

Las operaciones grandes pueden ejecutarse mediante el sistema de trabajos de WorldEdit, y el historial podría seguir registrándose mientras la edición está en progreso.

Durante ese tiempo, los comandos del historial pueden indicar que el historial todavía se está registrando.

Espera a que finalice el trabajo actual antes de utilizar:

;undo
;redo
;clearhistory

Cancelar una operación en ejecución no garantiza una reversión completa. Un trabajo cancelado puede dejar cambios parciales sin una acción de historial confirmada.

Problemas comunes

No hay nada que deshacer

Posibles causas:

• No se completó ninguna acción registrada que modificara el mundo.
• El historial fue limpiado.
• La acción superó el intervalo almacenado del historial y fue eliminada.
• La sesión del jugador expiró.
• El mundo o servidor se cerró.
• La operación falló antes de que se confirmara el historial.
• Otro jugador realizó la acción.

No hay nada que rehacer

Posibles causas:

• No se ha deshecho ninguna acción.
• Todas las acciones deshechas ya fueron rehechas.
• Se creó una nueva acción después de deshacer.
• El historial fue limpiado.
• La sesión expiró.

El mundo no se restauró por completo

Posibles causas:

• Fluidos, fuego, explosiones o actualizaciones posteriores del juego.
• Entidades.
• Cambios realizados por otro complemento.
• Áreas fuera de los búferes registrados.
• Una operación cancelada.
• Deshacer o rehacer ejecutado en otra dimensión.

Confundir acciones con bloques

El número de ;undo 5 significa cinco acciones del historial, no cinco bloques.

Esperar que se recupere el portapapeles

Deshacer no restaura contenidos anteriores del portapapeles.

Esperar que rehacer vuelva a ejecutar un comando

Rehacer restaura el estado resultante guardado en lugar de volver a ejecutar el comando.

Prácticas recomendadas

• Prueba las ediciones grandes primero en una selección pequeña.
• Permanece en la dimensión original hasta confirmar el resultado.
• Espera a que terminen los trabajos grandes antes de utilizar los comandos del historial.
• Evita depender de deshacer para fluidos, fuego, explosiones o entidades.
• No limpies el historial hasta estar seguro de que ya no lo necesitas.
• Aumenta maxHistorySize con precaución.
• Conserva una copia de seguridad independiente del mundo para construcciones importantes.

Referencia rápida

;undo [times]
;redo [times]
;clearhistory

maxHistorySize       = 25 acciones
ticksToDeleteSession = 12000 ticks
retención de sesión   ≈ 10 minutos

deshacer → nueva acción → se elimina la rama anterior de rehacer

cambios directos de WorldEdit = normalmente registrados
efectos posteriores de Minecraft = no garantizados