← Volver al blog

Plugin MCP para Unity Game Engine: Mejora tu flujo de trabajo de desarrollo de juegos

Guía del plugin MCP de Unity de VberAI: conecta Unity con IA mediante MCP y controla objetos, scripts y escenas con lenguaje natural.

Publicado
  • video
  • tutorial
  • unity
  • mcp
Ver en YouTube

Resumen

En este artículo, recorremos la demostración del Plugin MCP para Unity Game Engine presentada en el canal de YouTube de VberAI. El video muestra cómo conectar Unity con herramientas impulsadas por IA utilizando el Protocolo de Contexto de Modelo (MCP), lo que te permite generar y modificar objetos de juego, scripts y escenas mediante comandos en lenguaje natural. Esta guía escrita desglosa los pasos clave, los requisitos previos y consejos prácticos para que puedas seguirla y comenzar a usar el plugin en tus propios proyectos de Unity.

Lo que demuestra el video

El video de 98 segundos muestra el Plugin MCP de Unity en acción. MCP (Protocolo de Contexto de Modelo) es un estándar abierto que permite a los asistentes de IA interactuar directamente con herramientas de desarrollo. En este caso, el plugin conecta Unity con VberAI Studio (AI Studio), una plataforma que ejecuta modelos de IA capaces de comprender y ejecutar tareas de desarrollo de juegos.

Los aspectos más destacados del video incluyen:

  • Instalar el paquete del Plugin MCP de Unity
  • Configurar el plugin para conectarse con un modelo de IA local o en la nube
  • Usar comandos en lenguaje natural para crear nuevos GameObjects (por ejemplo, “añade una esfera”)
  • Modificar objetos existentes (por ejemplo, “cambia el color del cubo a rojo”)
  • Generar scripts de C# a partir de descripciones de texto
  • Ejecutar operaciones de escena como duplicar objetos o ajustar transformaciones

Todo el flujo de trabajo se realiza dentro del Editor de Unity, con la IA respondiendo a tus instrucciones escritas o habladas en tiempo real.

Requisitos previos

Antes de probar los pasos que se muestran en el video, asegúrate de tener lo siguiente:

Requisitos de software

  • Unity Hub y Unity Editor (se recomienda 2021.3 LTS o superior)
  • .NET SDK (versión 6.0 o superior) – requerido para las dependencias del plugin MCP
  • Python 3.8+ (si usas un modelo de IA local a través del puente MCP)
  • Git (para clonar el repositorio del plugin si es necesario)

Cuenta y configuración

  • Una cuenta de VberAI (disponible nivel gratuito) – necesaria para acceder a AI Studio
  • El Plugin MCP de Unity – descárgalo desde el repositorio oficial o el administrador de paquetes
  • Un endpoint de modelo de IA – ya sea un modelo local (por ejemplo, a través de Ollama) o una clave de API en la nube (por ejemplo, OpenAI, Anthropic)

Opcional pero útil

  • Familiaridad básica con la interfaz del Editor de Unity (Vista de escena, Jerarquía, Inspector)
  • Comprensión de conceptos de scripting en C# (para ejemplos de generación de scripts)
  • Un proyecto de prueba (crea un nuevo proyecto 3D vacío para experimentar de forma segura)

Guía paso a paso

Sigue estos pasos para replicar la demostración del video.

1. Instalar el Plugin MCP de Unity

El plugin se distribuye como un paquete de Unity. Puedes agregarlo a través del Administrador de Paquetes usando una URL de Git:

  1. Abre tu proyecto de Unity.
  2. Ve a Window > Package Manager.
  3. Haz clic en el botón + y selecciona “Add package from git URL…”
  4. Ingresa la URL del repositorio Git del plugin (por ejemplo, https://github.com/vberai/unity-mcp-plugin.git)
  5. Haz clic en Add.

Alternativamente, si tienes un archivo .unitypackage, impórtalo a través de Assets > Import Package > Custom Package.

2. Configurar la conexión MCP

Una vez instalado, debes indicarle al plugin dónde encontrar tu modelo de IA.

  1. En Unity, abre Window > MCP Plugin > Settings.
  2. En el campo Endpoint, ingresa la URL de tu modelo de IA:
    • Para VberAI Studio: usa el endpoint de API proporcionado (por ejemplo, https://api.vberai.com/v1/chat)
    • Para modelos locales: usa la dirección de tu servidor local (por ejemplo, http://localhost:11434/v1)
  3. Si es necesario, pega tu clave de API en el campo Auth.
  4. Establece el nombre del modelo (por ejemplo, gpt-4, claude-3 o llama3).
  5. Haz clic en Save.

El plugin ahora intentará un apretón de manos. Un indicador verde “Connected” confirma el éxito.

3. Envía tu primer comando

Con la conexión activa, abre la ventana de comandos MCP: Window > MCP Plugin > Command Input.

Escribe una instrucción simple como:

Crea un cubo rojo en la posición (0, 1, 0)

Presiona Enter o haz clic en Send. La IA procesará el comando y lo ejecutará en tu escena de Unity. Deberías ver aparecer un cubo rojo en la vista de juego.

4. Comandos avanzados

El video demuestra varias operaciones más potentes. Prueba estos ejemplos:

  • Modificar objetos: Cambia la escala del cubo a 2 en todos los ejes
  • Añadir componentes: Añade un Rigidbody a la esfera
  • Generar scripts: Crea un script de C# llamado "Rotator" que rote el objeto alrededor del eje Y
  • Gestión de escena: Duplica el cilindro y colócalo 3 unidades a la derecha

Cada comando es analizado por la IA, que luego llama a las funciones apropiadas de la API de Unity a través del puente MCP.

5. Flujo de trabajo de generación de scripts

Una de las características más útiles es la escritura de scripts asistida por IA. Cuando pides un script, el plugin:

  1. Genera el código C# en un búfer temporal
  2. Crea un nuevo archivo .cs en la carpeta Scripts de tu proyecto
  3. Adjunta el script al GameObject seleccionado actualmente (si corresponde)

Puedes revisar y editar el script generado en tu IDE antes de usarlo.

Consejos prácticos y problemas comunes

Aquí hay algunas ideas del video y del uso en el mundo real para ayudarte a evitar errores.

Estructura de comandos

  • Sé específico: “Crea una esfera azul con radio 0.5” funciona mejor que “Haz una pelota”
  • Usa terminología de Unity: “Añade un componente BoxCollider” es más confiable que “Hazlo sólido”
  • Para escenas complejas, divide las solicitudes en varios comandos

Solución de errores de conexión

Si el plugin muestra “Disconnected”:

  • Verifica que tu clave de API sea válida y no esté caducada
  • Comprueba que tu firewall permita conexiones salientes al endpoint
  • Para modelos locales, asegúrate de que el servidor esté ejecutándose (ollama serve en la línea de comandos)
  • Reinicia Unity después de cambiar la configuración

Notas de rendimiento

  • Los modelos en la nube (como los de AI Studio) responden más rápido que los modelos locales
  • Las operaciones complejas de escena (por ejemplo, duplicar 100 objetos) pueden tardar unos segundos
  • Guarda tu proyecto de Unity antes de ejecutar comandos destructivos

Preguntas frecuentes

P: ¿Este plugin funciona con Unity 6? R: Sí, el plugin es compatible con Unity 2021.3 LTS y versiones posteriores, incluido Unity 6. Algunas funciones avanzadas pueden requerir Unity 2022.3+.

P: ¿Puedo usar cualquier modelo de IA con este plugin? R: El plugin admite cualquier modelo que exponga una API de chat compatible con OpenAI. Esto incluye modelos de VberAI, OpenAI, Anthropic y modelos locales a través de Ollama o LM Studio.

P: ¿Mis datos del proyecto están seguros al usar modelos en la nube? R: Los comandos y descripciones de escena se envían al endpoint de IA. Para proyectos sensibles, considera usar un modelo local que se ejecute completamente en tu máquina.

P: ¿Puede el plugin modificar scripts existentes? R: Sí, puedes pedirle que actualice un script. Por ejemplo: “Añade una variable pública float speed al script PlayerController.”

P: ¿Dónde puedo encontrar más ejemplos de comandos? R: La documentación del plugin incluye una referencia de comandos. También puedes experimentar preguntando a la IA: “¿Qué comandos puedes ejecutar en Unity?”

Próximos pasos

El Plugin MCP de Unity abre una nueva forma de interactuar con tus proyectos de juego. En lugar de hacer clic manualmente en menús o escribir código repetitivo, puedes describir lo que quieres y dejar que la IA se encargue de la implementación.

Para aprovechar al máximo este flujo de trabajo, explora VberAI Studio para obtener una selección curada de modelos de IA optimizados para tareas de desarrollo de juegos. La plataforma proporciona endpoints preconfigurados que funcionan perfectamente con el Plugin MCP de Unity, ahorrándote tiempo de configuración.

Para más tutoriales y actualizaciones, suscríbete al canal de YouTube de VberAI y consulta guías adicionales de plugins MCP para otros motores de juego.

Más guías que te pueden interesar