Neocortex Logo

Cómo usar ChatGPT en los Blueprints de Unreal Engine

Usa ChatGPT en los Blueprints de Unreal Engine: llama a la API de OpenAI desde un nodo en C++, exponlo a los Blueprints y compáralo con un NPC con voz del plugin de Neocortex.

Sercan AltundasFounder of Neocortex

· 9 min de lectura

Usa ChatGPT en los Blueprints de Unreal Engine: llama a la API de OpenAI desde un nodo en C++, exponlo a los Blueprints y compáralo con un NPC con voz del plugin de Neocortex.

"¿Cómo uso ChatGPT en los Blueprints de Unreal?" suele significar: dejar que los jugadores hablen con un NPC y que un modelo de lenguaje responda. Unreal no tiene ningún nodo de Blueprint para peticiones web, así que el primer paso es un poco de C++. Esta guía construye un nodo de ChatGPT invocable desde Blueprints con el módulo HTTP de Unreal, después muestra lo que hace falta para publicarlo y cómo se ve el mismo NPC con el plugin de Neocortex.

Ruta 1: un nodo de ChatGPT para Blueprints

Necesitas un proyecto de C++, una clave de API de OpenAI, y los módulos HTTP y Json añadidos a PublicDependencyModuleNames en tu Build.cs. Este componente envía una línea del jugador al endpoint de chat completions y lanza un evento de Blueprint con la respuesta:

// NpcChatComponent.cpp: declare Ask as a BlueprintCallable UFUNCTION and OnReply as a
// BlueprintAssignable delegate with one FString parameter in NpcChatComponent.h
#include "NpcChatComponent.h"
#include "HttpModule.h"
#include "Interfaces/IHttpResponse.h"
#include "Dom/JsonObject.h"
#include "Serialization/JsonReader.h"
#include "Serialization/JsonSerializer.h"

static TSharedPtr<FJsonValue> ChatMessage(const FString& Role, const FString& Content)
{
    TSharedRef<FJsonObject> Message = MakeShared<FJsonObject>();
    Message->SetStringField(TEXT("role"), Role);
    Message->SetStringField(TEXT("content"), Content);
    return MakeShared<FJsonValueObject>(Message);
}

void UNpcChatComponent::Ask(const FString& PlayerLine)
{
    TSharedRef<FJsonObject> Root = MakeShared<FJsonObject>();
    Root->SetStringField(TEXT("model"), TEXT("MODEL_NAME"));
    Root->SetArrayField(TEXT("messages"), { ChatMessage(TEXT("system"), SystemPrompt), ChatMessage(TEXT("user"), PlayerLine) });
    FString Body;
    FJsonSerializer::Serialize(Root, TJsonWriterFactory<>::Create(&Body));

    TSharedRef<IHttpRequest, ESPMode::ThreadSafe> Request = FHttpModule::Get().CreateRequest();
    Request->SetURL(TEXT("https://api.openai.com/v1/chat/completions"));
    Request->SetVerb(TEXT("POST"));
    Request->SetHeader(TEXT("Content-Type"), TEXT("application/json"));
    Request->SetHeader(TEXT("Authorization"), TEXT("Bearer ") + ApiKey); // testing only, never ship it
    Request->SetContentAsString(Body);
    Request->OnProcessRequestComplete().BindWeakLambda(this, [this](FHttpRequestPtr, FHttpResponsePtr Response, bool bOk)
    {
        TSharedPtr<FJsonObject> Json;
        if (!bOk || !Response.IsValid() || !FJsonSerializer::Deserialize(TJsonReaderFactory<>::Create(Response->GetContentAsString()), Json)) return;
        const TArray<TSharedPtr<FJsonValue>>* Choices;
        if (Json->TryGetArrayField(TEXT("choices"), Choices) && Choices->Num() > 0)
        {
            OnReply.Broadcast((*Choices)[0]->AsObject()->GetObjectField(TEXT("message"))->GetStringField(TEXT("content")));
        }
    });
    Request->ProcessRequest();
}

Añade el componente a tu NPC, define SystemPrompt ("Eres Brannoch, un herrero gruñón...") y la clave, y en los Blueprints llama a Ask y enlaza On Reply con tu widget de diálogo. Sustituye MODEL_NAME por un modelo actual de la documentación de OpenAI. La respuesta llega en el hilo del juego, así que es seguro actualizar la interfaz desde el evento.

Esto envía una línea cada vez. Para una conversación, mantén un array de mensajes y envíalos todos con cada petición.

Lo que te deja por construir

  • La clave. Una clave empaquetada con el juego puede extraerse y gasta toda tu cuenta de OpenAI. Necesitas tu propio servidor entre el juego y la API.
  • La voz. Voz a texto para el jugador, texto a voz para la respuesta, decodificar el audio en un Sound Wave, y mantener corta la espera. Consulta cómo funciona el flujo de voz de los NPC de IA.
  • Emoción y acciones. La respuesta es texto plano. Para dirigir la animación y la jugabilidad, pides JSON en el prompt, lo analizas y gestionas las veces que llega mal formado.
  • Historial y coste. Cada mensaje hace que la siguiente petición sea más grande, más lenta y más cara.
  • Mantenerse en personaje. Los jugadores intentarán romper un prompt de sistema en cuestión de minutos. Consulta cómo mantener a los NPC de IA en personaje.

Ruta 2: el mismo NPC con el plugin de Neocortex

Con Neocortex, el personaje se diseña en un editor del navegador, con personalidad, un mundo, una base de conocimiento, una voz y acciones, y el plugin de Unreal te da nodos de Blueprint para el resto:

  1. Clona el plugin en la carpeta Plugins de tu proyecto, actívalo y añade "Neocortex" a tu Build.cs.
  2. Pega tu clave de API en Project Settings > Game > Neocortex.
  3. Añade un componente Neocortex Smart Agent al NPC y define su Project Id.
  4. Llama a Send Message For Audio con la línea del jugador.
  5. Enlaza On Chat para el texto, la emoción y la acción, y On Audio para un Sound Wave que reproduces con Set Sound y Play.

Para la entrada de voz, el componente Neocortex Microphone Recorder graba y transcribe al jugador, así que un botón de pulsar para hablar son tres nodos de Blueprint. El recorrido completo está en cómo añadir NPC de IA a Unreal Engine 5.

Lado a lado

API de OpenAI desde C++Plugin de Unreal de Neocortex
Primera respuestaUn componente en C++ y análisis de JSONNodos de Blueprint
Voz de entrada y salidaHazlo túComponente de grabación, Sound Wave de salida
EmociónPrompt y análisisEn cada respuesta
AccionesPedir JSON en el prompt y validarloDefinidas en el editor, enviadas como palabra clave
Historial de conversaciónTu array, creciendoGuardado en una sesión por personaje
Protección de la claveTu propio servidorLímites por jugador y por personaje en cada clave
Diseño del personajeUn prompt de sistemaEditor visual con pruebas en el navegador

Problemas comunes de la ruta hazlo tú

  • "La petición nunca responde." Comprueba que el módulo HTTP está en tu Build.cs y que la petición no se recolecta como basura: mantén la llamada dentro de un componente que viva tanto como el NPC.
  • "El JSON se rompe con las comillas." Construye el cuerpo con FJsonObject, como arriba, en lugar de formatear cadenas a mano. Los jugadores escriben apóstrofes y comillas todo el tiempo.
  • "¿Puedo llamarlo desde proyectos solo con Blueprints?" No, sin C++ o un plugin HTTP de terceros.

Siguientes pasos

Para el lado del diseño, lee cómo dar personalidades únicas a los NPC y cómo hacer que los NPC de IA actúen según lo que dicen. Todos los tutoriales están en la guía para crear NPC de IA.

Revisado en noviembre de 2026. Neocortex no está afiliado a OpenAI ni a Epic Games.

Preguntas frecuentes

¿Puedo usar ChatGPT en los Blueprints de Unreal Engine?

No con los nodos integrados. Unreal no tiene un nodo de Blueprint para peticiones HTTP, así que escribes una pequeña función en C++ con el módulo HTTP y la expones a los Blueprints, o instalas un plugin. El plugin de Neocortex te da un personaje de IA completo con nodos de Blueprint y voz.

¿Necesito C++ para llamar a un LLM desde Unreal?

Para una llamada directa a la API, unas pocas líneas de C++ o un plugin HTTP de terceros. Con Neocortex, el proyecto debe ser un proyecto de C++ para que el plugin compile, pero todo lo que usas es un nodo de Blueprint.

¿Es seguro poner una clave de API de OpenAI en un juego de Unreal?

No. Cualquier cosa empaquetada con el juego puede extraerse, y una clave de OpenAI da acceso total al gasto de tu cuenta. Enruta las llamadas a través de tu propio servidor. Las claves de Neocortex pueden tener límites de uso por jugador y por personaje que aplican nuestros servidores, y puedes desactivar una clave desde el panel.

¿Cómo doy voz a un NPC de ChatGPT en Unreal?

Añadirías voz a texto para el jugador y texto a voz para la respuesta, y después convertirías el audio en un Sound Wave. El plugin de Neocortex devuelve la respuesta como un Sound Wave que puedes reproducir, y graba y transcribe la voz del jugador.

Artículos similares

Sigue leyendo