View Categories

Integración Unreal Engine – Plugin

¡Transforma tu juego con NPCs que realmente cobran vida utilizando NPC Builder para Unreal Engine!
Presentamos la versión mejorada de nuestro SDK para Unreal Engine, perfectamente alineado con la última versión de NPC Builder. Este SDK está diseñado para revolucionar la forma en que interactúas con los NPCs en tus juegos, abriendo un nuevo mundo de posibilidades para la personalización profunda, interacciones dinámicas y la gestión sin fisuras de sesiones y contextos.

Requisitos Previos #

  • Unreal Engine: Versión 5.0 o superior.
  • Entorno de Desarrollo: Windows (objetivo principal), aunque es compatible con Mac y Linux para operaciones basadas en HTTP.
  • Conocimientos Básicos: Familiaridad con Blueprints y el sistema de configuración de Unreal Engine.

Instalación #

  1. Descargar e Instalar:
    Descarga el Plugin NPC Builder desde Unreal Marketplace y añádelo a tu proyecto. En el Editor de Unreal, ve a Edit → Plugins, haz clic en Install Plugin (o coloca el paquete del plugin en la carpeta Plugins de tu proyecto) y luego reinicia el editor.
  2. Verificar la Activación del Plugin:
    Una vez instalado, verifica que el plugin esté habilitado navegando a Edit → Plugins y comprobando que NPC Builder SDK aparezca en la categoría correspondiente.

Configuración: Configuración del DefaultGame.ini #

Antes de comenzar a usar el plugin, debes configurar tus credenciales de autenticación y el ID de juego. Estos ajustes se leen en tiempo de ejecución desde el archivo de configuración del proyecto.

  1. Abrir tu DefaultGame.ini:
    En la carpeta Config de tu proyecto, localiza y abre el archivo DefaultGame.ini.
  2. Agregar la Sección de NPC Builder:
    Inserta la siguiente sección en tu DefaultGame.ini, reemplazando los valores de marcador de posición por tus credenciales reales:
[/Script/NPCBuilderSDK.NPCBuilderSDKSettings]
; Set your authentication and game configuration details here.
BearerToken= ; Define here your bearer token obtained from our platform in case of temporary auth
ClientId= ; Define here your Client ID (from API Keys) obtained from our platform in case of permanent auth
ClientSecret= ; Define here your Client Secret (from API Keys) obtained from our platform in case of permanent auth
GameId= ; Define here your Game I
  • BearerToken: Token de autenticación temporal.
  • ClientId/ClientSecret: Utiliza estos para la autenticación permanente mediante claves API.
  • GameId: El identificador único de tu juego proporcionado por NPC Builder.
  1. Asegurar tus Credenciales:
    Recuerda que el almacenamiento seguro y el uso adecuado de las claves API es responsabilidad del desarrollador. No expongas estas claves en repositorios públicos.

Integración en Blueprints #

El Plugin NPC Builder expone un conjunto de nodos asíncronos en Blueprint que te permiten gestionar sesiones, actualizar datos de personajes e interactuar con los NPCs. Los siguientes pasos describen un flujo de trabajo genérico:

  1. Creación de Sesión:
    • Nodo Blueprint: Create Session
      Utiliza el nodo UAsyncCreateSession para crear una nueva sesión de jugador. Este nodo lee los ajustes de autenticación y juego (desde el DefaultGame.ini o mediante entrada manual) y retorna un Session ID, la clave de sesión y el Player ID.
  2. Actualización de Personaje:
    • Nodo Blueprint: Update Character
      Utiliza el nodo UAsyncUpdateCharacter para actualizar las propiedades del NPC (incluyendo la selección de modelo, comportamiento y eventos). El nodo retorna el contexto actualizado del personaje junto con su identificador único.
  3. Interacción con un NPC:
    • Nodo Blueprint: NPC Interaction
      Usa el nodo UAsyncNPCInteraction para enviar mensajes a un NPC y recibir respuestas. El historial de conversación (incluyendo tanto eventos de usuario como de personaje) se mantiene automáticamente. Este nodo soporta entrada en varios idiomas (inglés y español) según tu configuración.
  4. Reinicio de Conversación:
    • Función Blueprint: Reset Conversation
      Utiliza la función Reset Conversation para borrar el historial de conversación asociado a un personaje específico. Esto garantiza que las nuevas interacciones comiencen desde cero.

Ejemplo de Flujo en Blueprint #

A continuación se muestra un flujo de trabajo de ejemplo que ilustra la secuencia:

  1. Crear Sesión:
    • Arrastra el nodo Create Session a tu Blueprint.
    • Conecta los valores de DefaultGame.ini para pasar automáticamente BearerToken, ClientId, ClientSecret y GameId.
    • Al crear la sesión exitosamente, almacena el Session ID retornado.
  2. Actualizar Personaje:
    • Usa el nodo Update Character para modificar las propiedades del NPC.
    • Proporciona el Character ID y el payload de actualización (incluyendo la selección de modelo, eventos, etc.).
    • Almacena el contexto actualizado del personaje para referencia.
  3. Interacción con el NPC:
    • Invoca el nodo NPC Interaction para enviar un mensaje inicial (por ejemplo, “¡Hola NPC!”) y recibir una respuesta.
    • El historial de la conversación se actualiza automáticamente con los mensajes del usuario y del asistente, incluyendo cualquier evento disparado.
  4. Reiniciar Conversación:
    • Opcionalmente, utiliza la función Reset Conversation para limpiar el historial de interacción al comenzar una nueva secuencia de diálogo.

Características y Beneficios Adicionales #

  • Eventos de Usuario y de Personaje:
    Permite disparar eventos basados en las acciones del usuario o en las respuestas del personaje. Estos eventos (como “ataque”, “comercio” o acciones personalizadas) pueden impulsar mecánicas del juego como misiones o intercambios de objetos.
  • Selección de Modelo para Personajes:
    Elige entre diferentes modelos de IA para tus personajes, asegurando que su comportamiento y estilo de diálogo se alineen con la narrativa de tu juego.
  • Gestión de Sesiones y Contextos:
    Gestiona las sesiones de los jugadores de forma fluida utilizando nuestros nodos asíncronos dedicados, lo que garantiza que el contexto de juego (mundos, regiones, ubicaciones y personajes) se mantenga de manera persistente y consciente del estado.
  • Soporte Multiidioma:
    El SDK soporta inglés y español (en-US y es-ES), permitiéndote localizar las interacciones de los NPCs y hacer tu juego accesible a un público global.
  • Gestión del Contexto:
    Además de la gestión de sesiones, el plugin permite manejar de manera integral el contexto del juego, abarcando la administración de mundos, regiones, ubicaciones y personajes para garantizar un entorno de juego coherente.
  • Seguridad y Optimización:
    Con un robusto manejo de errores y diagnósticos a través de UE_LOG, el plugin ofrece un registro claro para la solución de problemas. Todas las operaciones asíncronas están optimizadas para baja latencia y consumo mínimo de memoria.

Resumen #

El Plugin NPC Builder para Unreal Engine es un SDK potente y repleto de funcionalidades que transforma tu juego al permitir interacciones dinámicas con NPCs, una gestión avanzada de sesiones y contextos, y soporte multiidioma. Con una integración sencilla a través de nodos Blueprint y una configuración detallada en el DefaultGame.ini, puedes potenciar la inmersión y la interactividad de tus juegos.
¡Empieza hoy mismo a transformar la experiencia de tus jugadores y crea NPCs inolvidables con NPC Builder para Unreal Engine!