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

"¿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:
- Clona el plugin en la carpeta
Pluginsde tu proyecto, actívalo y añade"Neocortex"a tuBuild.cs. - Pega tu clave de API en Project Settings > Game > Neocortex.
- Añade un componente Neocortex Smart Agent al NPC y define su Project Id.
- Llama a Send Message For Audio con la línea del jugador.
- 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 respuesta | Un componente en C++ y análisis de JSON | Nodos de Blueprint |
| Voz de entrada y salida | Hazlo tú | Componente de grabación, Sound Wave de salida |
| Emoción | Prompt y análisis | En cada respuesta |
| Acciones | Pedir JSON en el prompt y validarlo | Definidas en el editor, enviadas como palabra clave |
| Historial de conversación | Tu array, creciendo | Guardado en una sesión por personaje |
| Protección de la clave | Tu propio servidor | Límites por jugador y por personaje en cada clave |
| Diseño del personaje | Un prompt de sistema | Editor visual con pruebas en el navegador |
Problemas comunes de la ruta hazlo tú
- "La petición nunca responde." Comprueba que el módulo
HTTPestá en tuBuild.csy 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.






