Handles para mover waypoints en Unity

Contenido del curso

Introducción a las herramientas de desarrollo para videojuegos

Dibujando en el editor

Prácticando en el editor

Herramientas de Editor

Cierre del curso

20
Cierre del curso
01:10 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0014:59

Handles para mover waypoints en Unity

Curso de Herramientas de Unity

Clase 8 de 20

Clase 8 / 20

Recursos

Los handles en Unity son la herramienta que necesitas cuando quieres editar objetos directamente desde la escena sin perder tiempo seleccionando piezas individuales. Aprenderás a dibujar trazos visuales, crear controles de posición arrastrables y registrar cambios en el sistema Undo de Unity, ideal para desarrolladores que construyen herramientas de edición más amigables.

Qué son los Handles y en qué se diferencian de los Gizmos

Los handles son representaciones visuales que puedes colocar en la escena, igual que los gizmos, pero con una diferencia clave: aceptan inputs. Eso significa que puedes arrastrarlos, rotarlos o crear controles personalizados similares a los que Unity usa por defecto para mover y rotar objetos.

Piensa en un personaje con rig completo. Si quieres mover solo el brazo o la pierna, lo tradicional sería seleccionar cada hueso. Con un handle personalizado, puedes exponer controles directamente sobre el rig y editar todo sin perder el contexto visual [00:35].

¿Cuál es la diferencia entre Handles y Gizmos en Unity? Los gizmos solo dibujan elementos visuales, mientras que los handles permiten interacción del usuario, como arrastrar un punto para cambiar su posición.

Cómo dibujar el trazado de waypoints con Handles

En el ejemplo trabajamos con un zombi que se mueve de forma periódica entre puntos de control definidos en una lista de transforms. El problema es que sin visualización no sabes por dónde va a pasar.

La solución se escribe dentro de OnSceneGUI en el custom editor, no en el bloque de gizmos, porque solo desde ahí puedes aprovechar los inputs de los handles [04:10].

El flujo para dibujar el camino es así:

Recorrer la lista de waypoints con un for.
Tomar el waypoint actual y calcular el siguiente usando el operador módulo (%) para que regrese al inicio cuando llegue al final del array.
Validar que ninguno sea nulo para evitar crashes.
Dibujar la línea con Handles.DrawDottedLine, que recibe dos posiciones y un tamaño de pantalla.

csharp for (int i = 0; i < zombie.Waypoints.Count; i++) { Transform waypoint = zombie.Waypoints[i]; Transform nextWaypoint = zombie.Waypoints[(i + 1) % zombie.Waypoints.Count];

if (waypoint == null) continue;
if (nextWaypoint == null) continue;

Handles.color = Color.white;
Handles.DrawDottedLine(waypoint.position, nextWaypoint.position, 5f);

}

El color funciona igual que con gizmos, así que puedes asignar blanco para que resalte sobre la escena [06:20].

Cómo agregar un PositionHandle interactivo

Las líneas punteadas ya muestran el recorrido, pero editar los puntos desde la jerarquía sigue siendo engorroso. Aquí entra Handles.PositionHandle, el mismo control que usa Unity para mover objetos.

La función pide una posición y una rotación, y retorna un Vector3 con la nueva posición:

csharp Vector3 newPosition = Handles.PositionHandle(waypoint.position, waypoint.rotation); waypoint.position = newPosition;

Un detalle importante: si intentas dibujar gizmos dentro del custom editor aparece el error "Gizmo drawing function can only be used on drawn gizmos". La esfera amarilla que marca cada punto debe ir en OnDrawGizmosSelected dentro del MonoBehavior del zombi, recorriendo los waypoints con un foreach [09:15].

¿Dónde debo dibujar los Gizmos en un Custom Editor? Los gizmos van en OnDrawGizmos u OnDrawGizmosSelected del MonoBehavior, no en OnSceneGUI del editor. Ahí solo dibujas handles.

Cómo registrar cambios con BeginChangeCheck y Undo

Mover un handle sin más rompe algo crítico: Unity no detecta el cambio. Si presionas Ctrl+Z, no pasa nada, porque el sistema nunca registró la modificación.

La solución combina dos clases: EditorGUI para detectar cambios y Undo para registrarlos.

EditorGUI.BeginChangeCheck() le avisa a Unity que vas a vigilar un cambio.
EditorGUI.EndChangeCheck() retorna un booleano que es true cuando el valor cambió.
Undo.RecordObject(objeto, "nombre de la acción") guarda el estado anterior para que el sistema pueda revertirlo.

csharp EditorGUI.BeginChangeCheck(); Vector3 newPosition = Handles.PositionHandle(waypoint.position, waypoint.rotation); if (EditorGUI.EndChangeCheck()) { Undo.RecordObject(waypoint, "Move Waypoint"); waypoint.position = newPosition; }

El nombre que pasas a RecordObject aparece en el menú Edit de Unity como "Move Waypoint", y desde ahí puedes deshacer y rehacer con normalidad [12:40].

¿Por qué usar BeginChangeCheck antes de RecordObject? Porque registrar un objeto en cada frame consume muchos recursos. BeginChangeCheck solo dispara el guardado cuando hay un cambio real.

Por qué este patrón mejora tus herramientas de edición

Dibujar el trazo, exponer controles arrastrables y respetar el sistema Undo convierte una escena confusa en una herramienta cómoda. Tu yo del futuro y cualquier persona que trabaje contigo van a agradecer no tener que cazar transforms en la jerarquía.

Algunas ideas para experimentar:

Probar otros tipos de línea disponibles en Handles además de DrawDottedLine.
Cambiar el color y el tamaño según el estado del waypoint.
Agregar handles de rotación o escala usando Handles.RotationHandle o Handles.ScaleHandle.

¿Qué herramienta de edición personalizada construirías tú con handles? Cuéntanos en los comentarios qué workflow te gustaría simplificar.

Resumen

Qué son los Handles y en qué se diferencian de los Gizmos

¿Cuál es la diferencia entre Handles y Gizmos en Unity? Los gizmos solo dibujan elementos visuales, mientras que los handles permiten interacción del usuario, como arrastrar un punto para cambiar su posición.

Cómo dibujar el trazado de waypoints con Handles

La solución se escribe dentro de OnSceneGUI en el custom editor, no en el bloque de gizmos, porque solo desde ahí puedes aprovechar los inputs de los handles [04:10].

El flujo para dibujar el camino es así:

Recorrer la lista de waypoints con un for.
Tomar el waypoint actual y calcular el siguiente usando el operador módulo (%) para que regrese al inicio cuando llegue al final del array.
Validar que ninguno sea nulo para evitar crashes.
Dibujar la línea con Handles.DrawDottedLine, que recibe dos posiciones y un tamaño de pantalla.

csharp for (int i = 0; i < zombie.Waypoints.Count; i++) { Transform waypoint = zombie.Waypoints[i]; Transform nextWaypoint = zombie.Waypoints[(i + 1) % zombie.Waypoints.Count];

if (waypoint == null) continue;
if (nextWaypoint == null) continue;

Handles.color = Color.white;
Handles.DrawDottedLine(waypoint.position, nextWaypoint.position, 5f);

}

El color funciona igual que con gizmos, así que puedes asignar blanco para que resalte sobre la escena [06:20].

Cómo agregar un PositionHandle interactivo

La función pide una posición y una rotación, y retorna un Vector3 con la nueva posición:

csharp Vector3 newPosition = Handles.PositionHandle(waypoint.position, waypoint.rotation); waypoint.position = newPosition;

¿Dónde debo dibujar los Gizmos en un Custom Editor? Los gizmos van en OnDrawGizmos u OnDrawGizmosSelected del MonoBehavior, no en OnSceneGUI del editor. Ahí solo dibujas handles.

Cómo registrar cambios con BeginChangeCheck y Undo

Mover un handle sin más rompe algo crítico: Unity no detecta el cambio. Si presionas Ctrl+Z, no pasa nada, porque el sistema nunca registró la modificación.

La solución combina dos clases: EditorGUI para detectar cambios y Undo para registrarlos.

EditorGUI.BeginChangeCheck() le avisa a Unity que vas a vigilar un cambio.
EditorGUI.EndChangeCheck() retorna un booleano que es true cuando el valor cambió.
Undo.RecordObject(objeto, "nombre de la acción") guarda el estado anterior para que el sistema pueda revertirlo.

El nombre que pasas a RecordObject aparece en el menú Edit de Unity como "Move Waypoint", y desde ahí puedes deshacer y rehacer con normalidad [12:40].

¿Por qué usar BeginChangeCheck antes de RecordObject? Porque registrar un objeto en cada frame consume muchos recursos. BeginChangeCheck solo dispara el guardado cuando hay un cambio real.

Por qué este patrón mejora tus herramientas de edición

Algunas ideas para experimentar:

Probar otros tipos de línea disponibles en Handles además de DrawDottedLine.
Cambiar el color y el tamaño según el estado del waypoint.
Agregar handles de rotación o escala usando Handles.RotationHandle o Handles.ScaleHandle.

¿Qué herramienta de edición personalizada construirías tú con handles? Cuéntanos en los comentarios qué workflow te gustaría simplificar.

Introducción a las herramientas de desarrollo para videojuegos

Cómo crear herramientas propias en Unity

Qué son las herramientas en Unity

Herramientas comunes para crear videojuegos

Dibujando en el editor

Ciclo de vida del editor en Unity IMGUI

Controles: creando un botón

GUI.Box y Rects en las esquinas de pantalla

Gizmos en Unity para depurar IA visual

Handles para mover waypoints en Unity

Prácticando en el editor

Shortcuts útiles del editor

Menús contextuales en el Inspector de Unity

Menús personalizados con MenuItem en Unity

Herramientas de Editor

Cómo crear PropertyDrawers en Unity

Crea una base de datos RPG con Scriptable Objects

Serialized properties

Optimizando nuestro custom editor

Guardar y cargar data de herramientas: json, scriptable objects, txt y csv

Crea una Editor Window con AssetDatabase

Scroll view con botones en Unity Editor

Editor windows: agregando funcionalidades

Cierre del curso

Cierre del curso

Handles para mover waypoints en Unity

Progreso del curso

Introducción a las herramientas de desarrollo para videojuegos

Dibujando en el editor

Prácticando en el editor

Herramientas de Editor

Cierre del curso

Recursos

Recursos