Herramientas del editor de Unity: ediciones de propiedades que se puedan deshacer y conserven los overrides de prefab

Trata una acción del editor como un cambio de autoría

Una herramienta de editor útil necesita una respuesta clara a qué cambió el usuario y a qué objeto pertenece ese cambio. Actualizar lo que muestra el Inspector, modificar el estado serializado, crear una entrada de Undo y guardar un archivo son responsabilidades distintas. Define el objetivo de la acción y el resultado esperado antes de añadir un botón de conveniencia. El comportamiento de la API descrito aquí se basa en las referencias citadas de Unity 6.0. [1][2][3]

Prioriza el flujo de propiedades serializadas

SerializedObject y SerializedProperty ofrecen un flujo de edición para campos serializados e integran los cambios con Undo y con los overrides de prefab. En un flujo que se conserva entre llamadas, invoca Update antes de leer valores actualizados, modifica las propiedades deseadas y vuelca los cambios con ApplyModifiedProperties. Si hay flujos independientes que apuntan a los mismos objetos, es necesario sincronizarlos. [1]

Mantén la mutación detrás de la acción real del usuario. Redibujar el Inspector repetidamente no debería, por sí mismo, seguir cambiando valores de autoría. Además, valida los datos de forma deliberada: aplicar campos serializados no ejecuta la lógica de validación del setter de una propiedad de C# asociada. [1]

Haz predecible una herramienta concreta de lanzadores

Imagina un componente lanzador con un campo serializado launchSpeed. Un botón establece los lanzadores seleccionados, desde sus valores actuales, en 9 unidades de proyecto por segundo. Una instancia concreta de un prefab en la escena tenía antes el valor 6. El resultado buscado es un override en la instancia que se pueda deshacer hasta el valor anterior, mientras el prefab de origen conserva su valor por defecto.

Haz explícito el alcance del botón. Asignar el mismo valor a todos los lanzadores seleccionados no es lo mismo que sumar una cantidad relativa al valor existente de cada lanzador. El getter de una propiedad serializada con varios objetos devuelve el valor del primer objetivo, así que leerlo una vez y aplicar la aritmética a todos los objetivos no implementaría ajustes relativos independientes. [1]

Registra las mutaciones directas en el orden correcto

Si la herramienta cambia directamente propiedades de los objetos, llama a Undo.RecordObject sobre el objeto que se va a modificar antes de asignar los valores nuevos. En una instancia de prefab, llama después de la modificación a PrefabUtility.RecordPrefabInstancePropertyModifications para que se registre su override. Unity recomienda el flujo serializado cuando encaja con la edición. [2][3]

Registra el componente u objeto que realmente es el propietario, no un contenedor de selección sin relación. Esta API de registro de propiedades no cubre cambiar el padre de un transform, añadir un componente ni destruir un objeto; esas operaciones requieren las funciones de Undo específicas. No amplíes un editor de valores escalares que ya funciona suponiendo que todas las operaciones estructurales tienen el mismo contrato de registro. [2]

Revisa por separado Undo y la persistencia

En el ejemplo del lanzador, comprueba el valor cambiado, Undo, Redo y el override de prefab visible. Guarda y vuelve a abrir la escena para inspeccionar el resultado persistido, e inspecciona el prefab de origen para confirmar que el alcance es el previsto. Repite la prueba con varios objetos seleccionados que tengan valores iniciales distintos.

Estas comprobaciones responden a preguntas distintas: si la edición se produjo, si su estado anterior es recuperable y si el estado de autoría previsto sobrevive a la reapertura. La revisión propuesta no se ha ejecutado aquí. No incluyas los cambios en archivos externos ni otros efectos secundarios no serializados en lo que supones que puede restaurar un registro de Undo de propiedades normal.

Fuentes

1. SerializedObject — Unity Technologies.
2. Undo.RecordObject — Unity Technologies.
3. PrefabUtility.RecordPrefabInstancePropertyModifications — Unity Technologies.