Saltar al contenido Saltar al contenido
Flockbay

Importar un proyecto de Unity

Import from Unity crea un proyecto nuevo de Godot 4 a partir de un proyecto de Unity, sin abrir ni instalar Unity. Escenas, prefabs, modelos, sprites, tilemaps y ajustes se convierten al importar; el Port report lista lo que queda y la IA lo porta contigo.

Read this page in English

Importar el proyecto

El proyecto nuevo va donde van tus juegos nuevos, con el nombre del proyecto de Unity seguido de "(Godot)". El proyecto de Unity solo se lee: no se cambia nada en su carpeta y no hace falta tener Unity instalado.

Flockbay lee las escenas de Build Settings y todo lo que referencian, las carpetas Resources y StreamingAssets, y todos los scripts. Una carpeta que abres con Open project… y resulta ser un proyecto de Unity recibe la misma importación desde su tarjeta.

  1. En Home, abre el ▾ junto a Open project… y elige Import from Unity….
  2. Elige un proyecto de la lista Unity Hub projects, o elige Choose folder… y selecciona la carpeta que contiene Assets y ProjectSettings.
  3. Flockbay lee el proyecto bajo "Importing <carpeta>…". Cancel lo detiene y quita lo que había escrito.
  4. El proyecto nuevo de Godot se abre en el editor con el chat acoplado y la tarjeta del Port report encima del compositor.

Unity guarda las escenas y los prefabs como texto por defecto (Asset Serialization: Force Text). Un proyecto guardado en binario también se importa, más despacio.

Qué se convierte al importar

La importación se basa en Unidot Importer, de código abierto (MIT), que corre dentro del editor de Godot que viene con Flockbay. Los ejes de Unity son de mano derecha en Godot, así que X se refleja al entrar.

UnityGodot
Scene (.unity)Scene (.tscn)
Prefab, with its overrides in each sceneScene (.prefab.tscn), instanced
FBX and glTF models, rigs and animationsImported with Godot's own FBX and glTF import
Standard and URP Lit materialsStandardMaterial3D with the same colours and texture maps
Camera, AudioSourceCamera3D, AudioStreamPlayer and AudioStreamPlayer3D
Animator Controller and AnimationClipAnimationTree and AnimationPlayer
SpriteRenderer, sorting layers and orderSprite2D, z_index
Tilemap and its tilesTileMapLayer with a TileSet
Rigidbody2D and 2D colliders, triggersRigidBody2D, CharacterBody2D or StaticBody2D, CollisionShape2D, Area2D
Orthographic cameraCamera2D with the same framing
Physics layers, gravity, fixed timestep, windowProject Settings
Input Manager axes and .inputactionsInput Map actions

Qué porta la IA

Un componente que la importación no convierte se queda en la escena como un nodo provisional con el nombre de su clase de Unity, con todos los valores del Inspector guardados en él. Un MonoBehaviour conserva sus campos y el script que usaba; las referencias conservan el objeto al que apuntaban. La IA los lee con las herramientas de escena de siempre, así que un port parte de los valores que ajustaste en Unity, no de los valores por defecto.

Los scripts se portan a GDScript, o a C# si lo pides, en Windows y Linux. La API de Unity no es la de Godot, así que cada MonoBehaviour se reescribe como un script en el nodo al que pertenece: Start pasa a ser _ready, Update _process, una corrutina await, un UnityEvent una señal. Los canvas de uGUI pasan a ser nodos Control, los sistemas de partículas GPUParticles2D o GPUParticles3D, y los shaders propios se reescriben en el lenguaje de shaders de Godot.

Los paquetes propios de Unity (TextMeshPro, los render pipelines, Cinemachine, el Input System) no se copian al proyecto: su licencia no lo permite. La IA reconstruye con nodos de Godot lo que el juego usaba de ellos, y el Port report lista cada paquete.

El Port report

La tarjeta encima del compositor tiene tres columnas, Converted, Approximated y To port, cada una dividida por tipo: escenas, prefabs, scripts, UI, partículas, ajustes. Approximated es una conversión cercana pero no exacta, como un eje del ratón que Godot lee de los eventos de movimiento del ratón.

Finish port envía "Port the rest of this Unity project." al chat. La IA recorre la lista en orden, primero la entrada y la cámara, después la escena principal y lo que usa, y marca cada elemento como portado u omitido con un motivo. Después del primer turno la tarjeta dice "12 of 41 left" y el botón pasa a ser Continue port. Not now pliega la tarjeta a una línea.

Open report abre PORT_REPORT.md, la misma lista como archivo, con cada aproximación y cada omisión y su motivo. .flockbay/unity-port.json es la lista con la que trabaja la IA.

Cuando el port está terminado

Cuando no queda nada, la tarjeta dice Port finished. El port no se compara con el juego original: juégalo, compáralo con la build de Unity y di en el chat qué se siente distinto.

La importación guarda una copia de las fuentes de Unity en unity-source/, con el C# guardado como .cs.txt y un .gdignore para que Godot nunca lo importe. Delete Unity sources quita esa carpeta y la base de datos de assets de la importación. Tu proyecto de Godot no se ve afectado.

Traer un .unitypackage

El menú + del chat tiene Import Unity package…. Abre tu carpeta de descargas de la Asset Store; elige un .unitypackage y sus assets se importan en el juego abierto de la misma forma, en sus propias rutas de Assets/, con sus scripts añadidos al Port report y los ajustes del juego sin tocar. Cada paquete conserva su propia licencia: revísala antes de publicar el juego.

Tu propio agente

Claude Code, Codex o Cursor conectados por MCP reciben la misma herramienta de port, flockbay_unity_port: status, next, mark y language, y el mismo orden de trabajo en la guía unity_port. Conectar tu agente lo configura.

Descarga Flockbay

Flockbay es gratis para Windows, macOS y Linux. La app está en inglés; estas páginas explican en español lo que hace cada parte.

Descargar Flockbay

Flockbay es una app de escritorio para Windows, macOS y Linux. Regístrate y envía la descarga a tu equipo.

Registrarse

Sigue leyendo