Solución de problemas¶
La mayoría de los problemas de OTS son una de tres cosas: no había nada seleccionado, los nombres no coinciden, o el rango estaba mal. Esta página recorre los síntomas en el orden en que probablemente te los vas a encontrar.
La ventana no abre¶
No pasa nada cuando ejecutas el script.
Casi siempre es Python. Harmony lanza los scripts de usuario a través de un Python 3.9 del sistema en el PATH, y un intérprete 3.10 o más nuevo es ignorado en silencio — sin error, sin ventana.
Instala Python 3.9 de 64 bits, marca Add Python to PATH y reinicia Harmony.
Un diálogo de error que menciona una ruta. La carpeta harmony/ no está donde el launcher la espera. Debe ser una carpeta llamada octoTransformSync dentro de tu directorio <version>-scripts. Ver Instalación.
El botón del shelf no hace nada, o reporta un error de import. Maya no encuentra OTS en su path de Python. Vuelve a ejecutar el instalador de arrastrar y soltar — reescribe la entrada de userSetup.py y refresca el botón del shelf en el lugar.
No hay pestaña de OTS en la sidebar. El add-on no está habilitado. Revisa Edit → Preferences → Add-ons, busca Octo Transform Sync y márcalo. Después presiona N en el 3D view.
La lista de exportación está vacía¶
Presionaste + y no apareció nada. No había nada elegible seleccionado en la escena. Selecciona primero los pegs / joints / armature, y después presiona +.
En Blender, la caja Scene selection en la parte de arriba del panel te dice exactamente qué puede ver OTS — si dice "Select an armature in the viewport", ahí tienes tu respuesta.
Parte de la selección apareció, pero no toda. OTS solo escanea ítems que puede exportar de forma significativa. Los efectos, composites y otros nodos que no son de transformación no son transforms y no vienen con el resto.
Todo está ámbar al importar¶
Esto es normal en una escena vacía. Ámbar significa "no se encontró target en esta escena" — y todavía no hay nada que encontrar. Presiona Create Rig, no Apply.
Ver El árbol de coincidencias.
Algunas filas están ámbar¶
La fila de la cámara está ámbar. Es lo esperado. En una importación nueva no hay joint ni bone que lleve el nombre de la cámara — por eso las cámaras se cuentan aparte en la línea de resumen. Create Cameras se encarga.
Unas pocas filas con nombre están ámbar. Los nombres difieren entre las dos escenas. Arréglalo:
- Haciendo doble clic en la celda Target path y escribiendo la ruta correcta, o
- Renombrando en tu escena y presionando Browse… de nuevo, o
- Desmarcando la fila si no la quieres.
La mayoría de las filas están ámbar. Probablemente estás aplicando un archivo a la escena equivocada, o lo que quieres es Create Rig y no Apply.
Las filas siguieron ámbar después de Create Rig¶
Es lo esperado. La lista muestra el estado de coincidencia de cuando hiciste browse; construir el rig no la repinta. Presiona Browse… otra vez sobre el mismo archivo para volver a correr el match.
El rig en sí está bien — revisa tu escena, no la lista.
La animación está mal¶
Nada se movió después de Apply. Apply solo escribe en filas que están a la vez con coincidencia y marcadas. Busca filas ámbar y checkboxes desmarcados.
El plano quedó cortado. El rango de exportación no cubría toda la acción. Vuelve a exportar con Scene range.
Se mueve, pero la rotación está mal. Primero revisa que no estés mirando una escena Z-up de Maya, donde los handles por key se simplifican. Si los valores mismos están mal en vez de la forma de la curva, eso es un bug que vale la pena reportar — incluye el archivo, las versiones de ambas aplicaciones, y cuál debería haber sido la rotación.
Un bone está en el lugar correcto pero sus hijos no. Exportaste una cadena parcial y el parent respecto al cual se hizo relativa no está en el archivo. Exporta la cadena desde un ancestro común hacia abajo.
Las curvas llegaron como escalones. Los keys de origen eran stepped, o la rotación viajó como quaternion — en cuyo caso el tipo de interpolación sí viaja pero los handles por key no, por diseño. Ver Formato de archivo.
Algo sobre el archivo¶
"Unsupported version N". El archivo fue escrito por un build distinto de OTS. No hay migración hacia atrás, por diseño; vuelve a exportar desde la aplicación de origen.
"Missing 'pegs' key" o un error de formato. Cargaste un .pvt en la pestaña .anm, o al revés. Los file pickers filtran por extensión, así que esto suele significar que el archivo fue renombrado.
El archivo es enorme. Un rango de frames amplio sobre un rig grande. Ajusta el rango — solo se muestrean los frames con key más los límites del rango, pero cien pegs a lo largo de mil frames siguen siendo un montón de keys.
Cámaras¶
La cámara no se mueve. En un .anm el movimiento vive en el peg de la cámara. Asegúrate de que esa fila estaba marcada y de que también corriste Create Rig o Apply — Create Cameras por sí solo construye el lente, no el movimiento.
El encuadre está demasiado cerrado. Revisa el sensor / film fit en la aplicación de destino: debe ser vertical. Un fit automático u horizontal reinterpreta el FOV contra el eje equivocado y hace que todo se vea con zoom.
La cámara apunta hacia el lado equivocado. El apuntado entre aplicaciones es best-effort. Revisa primero el roll, después la inclinación. Las cámaras de Blender llevan una corrección de +90° en X por convención — si una cámara pasó por un round-trip a través de un archivo editado a mano, esa corrección puede terminar aplicada dos veces.
Ver Cámaras.
Rigs¶
Dos personajes llegaron como uno. Compartían un tag de rig al exportar. Dale a cada cadena raíz su propio nombre en la columna Rig y vuelve a exportar.
No puedo dividir esta cadena. Correcto — una cadena conectada nunca se puede dividir entre rigs, porque un bone en un armature distinto al de su parent no tiene parent. Fusionar raíces desconectadas está permitido; dividir una cadena conectada no. Ver Rigs y multi-rig.
Camera_1 y Camera_2 se intercambiaron. No deberían — las cadenas de cámara se ordenan por nombre antes de numerarse, precisamente para que los números sean estables entre sesiones. Si de verdad se intercambiaron, las cadenas fueron renombradas.
Específicos de Harmony¶
Un peg perdió su 3D path después de Apply. Deliberado, y documentado: aplicar una animación desvincula las columnas de 3D-path y quaternion-path y escribe curvas bezier de canal separado. Los valores están bien; el modo de autoría se fue. Aplica sobre un resultado de Create Rig en su lugar si necesitas mantener el peg original intacto.
Un archivo que da error limpio en Maya da un error raro en Harmony. Los lectores de Harmony no corren la misma validación estricta, así que un archivo malo se manifiesta de forma distinta ahí. Vuelve a exportar desde el origen.
Ver En Harmony.
Sigues atascado¶
Incluye esto en un reporte y se diagnosticará mucho más rápido:
- Ambas aplicaciones y sus versiones
- Qué dirección y qué formato
- La línea de resumen de la página de importación, textual
- El archivo mismo — es JSON pequeño y legible, y normalmente alcanza para encontrar el problema