Neocortex Logo

Como criar um sistema de diálogo de NPC no Roblox Studio com IA

Monte um sistema de diálogo de NPC no Roblox Studio: objetos Dialog, árvores próprias ou respostas de IA, e depois misture escolhas com texto livre, ações e falas de reserva.

Sercan AltundasFounder of Neocortex

· 8 min de leitura

Monte um sistema de diálogo de NPC no Roblox Studio: objetos Dialog, árvores próprias ou respostas de IA, e depois misture escolhas com texto livre, ações e falas de reserva.

Um sistema de diálogo de NPC no Roblox Studio é o código e a interface que permitem aos jogadores conversar com os personagens: quem diz o quê, quais escolhas aparecem e o que acontece depois de cada resposta. A maioria dos tutoriais monta uma árvore de falas fixas. Este guia compara as três formas de fazer isso e depois mostra como adicionar respostas de IA da Neocortex sem abrir mão das escolhas criadas por você, das quais suas missões dependem.

Dois personagens conversando em balões de chat em uma experiência do Roblox Imagem: Roblox © Roblox Corporation

Três formas de criar diálogo de NPC no Roblox Studio

O objeto Dialog integrado

Coloque um objeto Dialog dentro da cabeça do NPC e adicione objetos DialogChoice abaixo dele. Cada escolha tem a fala do jogador e a resposta do NPC, e as escolhas podem ser aninhadas. O evento DialogChoiceSelected informa aos seus scripts qual opção foi escolhida, então uma escolha pode abrir uma loja ou iniciar uma missão.

Leva cinco minutos e não exige código. O menu, porém, tem a mesma aparência em todos os jogos, e cada fala precisa ser escrita antes.

Uma árvore de diálogo própria

A maioria dos tutoriais de diálogo no Roblox monta esta estrutura. As falas ficam em um ModuleScript, como uma tabela de nós, cada um com o texto do NPC e uma lista de escolhas que apontam para outros nós. Um ScreenGui mostra o texto com efeito de máquina de escrever, um retrato e botões. Você controla a aparência por completo, e ela escala para conversas longas.

O limite é o mesmo: os jogadores só podem dizer o que você escreveu para eles. Se perguntar ao ferreiro algo fora da lista, não há resposta.

Respostas de IA

O jogador digita qualquer coisa, um Script de servidor envia a mensagem para um personagem de IA, e a resposta é escrita para aquela pergunta exata. Os personagens da Neocortex têm personalidade, uma base de conhecimento com o seu lore e ações que o seu jogo pode executar, então o ferreiro responde como ferreiro. O guia de NPCs de IA no Roblox cobre a configuração: Allow HTTP Requests, o armazenamento de segredos e o script de servidor que chama a API.

O melhor dos dois: escolhas mais "diga qualquer coisa"

Você não precisa escolher um. O sistema de diálogo que funciona melhor na prática mantém a sua árvore e adiciona IA em volta dela:

  • Botões para os momentos que importam. "Aceitar a missão", "Pagar o pedágio" e "Comprar" continuam como escolhas definidas por você, para que a história e a economia não saiam do rumo.
  • Uma caixa de texto para todo o resto. Abaixo dos botões, um campo "Diga algo..." envia texto livre ao personagem. Os jogadores perguntam sobre o lore, brincam, discutem e recebem respostas reais.
  • Botões que também conversam com a IA. Uma escolha como "Pergunte sobre a tempestade" pode enviar uma mensagem fixa para a Neocortex, então até as opções roteirizadas ganham uma redação nova a cada vez.
  • Falas de reserva na árvore. Se um pedido falhar, toca a fala pronta da árvore.

O que volta da Neocortex

Cada pedido para /v3/chat retorna um sessionId e uma lista de mensagens. É tudo o que a sua interface de diálogo precisa:

CampoO que trazO que o seu sistema faz com ele
messages[].nameO personagem que falaDefine o nome e o retrato
messages[].lines[].textA resposta, uma ou mais linhasFiltra e depois digita o texto
messages[].lines[].emotionHAPPY, ANNOYED, SCARED e outrosEscolhe um retrato ou uma animação
messages[].actionsAções como GIVE_ITEM com um targetIdExecuta após uma verificação no servidor
messages[].flowStateUma palavra-chave de checkpoint de um Conversation FlowAvança a missão
sessionIdA conversa até o momentoSalvo por jogador para retomar na próxima vez

Encaminhando respostas e ações no servidor

Esta função de servidor recebe uma resposta e a transforma em linhas de diálogo e eventos do jogo. Ela só executa ações de uma lista que você permite, e filtra cada linha para o único jogador da conversa:

local ALLOWED = { OPEN_GATE = true, GIVE_ITEM = true, START_QUEST = true }

local function handleReply(player, npc, data)
	for _, message in data.messages do
		for _, line in message.lines do
			local ok, result = pcall(TextService.FilterStringAsync, TextService, line.text, player.UserId)
			if ok then
				local text = result:GetNonChatStringForUserAsync(player.UserId)
				DialogueLine:FireClient(player, message.name, text, line.emotion)
			end
		end
		for _, action in message.actions or {} do
			if ALLOWED[action.name] then
				runAction(player, npc, action.name, action.targetId) -- your own game code
			end
		end
		if message.flowState and message.flowState ~= "" then
			onCheckpoint(player, npc, message.flowState) -- your quest code
		end
	end
end

GetNonChatStringForUserAsync filtra para um jogador, o que combina com uma janela de diálogo privada. Para um balão que todos por perto podem ver, use GetNonChatStringForBroadcastAsync.

Mantenha a história nos trilhos com Conversation Flows

A conversa livre é divertida até que quem dá a missão esqueça de dar a missão. Um Conversation Flow no editor da Neocortex define as etapas que uma cena deve cumprir, como cumprimentar, explicar o navio desaparecido e oferecer a recompensa, e devolve uma palavra-chave flowState em cada checkpoint. O código da sua missão escuta essas palavras-chave, então o jogador pode fugir do assunto e a cena ainda chega à recompensa.

Faça a janela de diálogo ser agradável

Um ProximityPrompt em uma porta de masmorra no Roblox Studio Imagem: Roblox © Roblox Corporation

  • Texto com máquina de escrever. Revele a linha filtrada alguns caracteres por vez, com MaxVisibleGraphemes no TextLabel. Isso também cobre o meio segundo que o pedido leva.
  • Retratos por emoção. Mantenha de quatro a cinco retratos por NPC e escolha um pela tag de emoção.
  • Estado de pensamento. Mostre "..." na janela enquanto o pedido roda, para que uma resposta lenta pareça o NPC pensando.
  • Fechar pela distância. Encerre a conversa quando o jogador se afastar, e salve o sessionId em um DataStore para retomar depois.

Falas de reserva quando a IA não responde

Chamadas de rede falham às vezes, e um sistema de diálogo precisa sobreviver a isso:

  1. Envolva cada pedido em pcall e verifique Success na resposta.
  2. Defina um Timeout curto em RequestAsync, para que o jogador não fique olhando para "..." por muito tempo.
  3. Volte para a árvore. Toque a fala pronta do nó e mantenha os botões funcionando.
  4. Adicione um cooldown de alguns segundos por jogador, o que também mantém você bem abaixo do limite do Roblox de 500 requisições HTTP por minuto por servidor.
  5. Limite o tamanho da mensagem antes de enviar, para que um bloco de texto colado não gere custo algum.

Primeiros passos com o seu sistema de diálogo no Roblox

  1. Monte a interface primeiro: nome, retrato, texto, alguns botões e uma caixa de texto.
  2. Escreva a árvore para os momentos que precisam acontecer, em um ModuleScript.
  3. Crie o personagem na Neocortex, com um Conversation Flow para a cena e as ações que ele pode devolver.
  4. Adicione o script de servidor do guia de NPCs de IA no Roblox e encaminhe as respostas por handleReply.
  5. Conecte a caixa de texto a um RemoteEvent, e dê aos botões mensagens fixas ou nós da árvore.
  6. Teste o caminho de falha desligando as requisições HTTP e conferindo se as falas de reserva tocam.

Filtragem e uso justo

O Roblox exige que os desenvolvedores filtrem qualquer texto que eles não controlam, e remove experiências que pulam essa filtragem, então cada linha de IA passa pelo TextService antes de chegar à interface. Diga aos jogadores que o NPC é uma IA. A criação e os testes acontecem no editor do navegador; um jogo que gera Robux é uso comercial, o que exige o plano Pro (€29 por mês) ou Team.

Resumo

Mantenha a árvore para o que precisa acontecer, e deixe a Neocortex cuidar de tudo o que os jogadores realmente querem dizer. Para mais ideias, leia ideias de NPCs inteligentes para o Roblox. Se você estiver construindo além do Roblox, NPCs de IA vs Yarn Spinner, Ink e articy:draft compara a IA com ferramentas de diálogo para outras engines, e NPCs de IA que dão missões aprofunda como manter os momentos da história intactos.

Verificado em outubro de 2026. A Neocortex não é afiliada à Roblox Corporation.

Perguntas frequentes

Como criar um sistema de diálogo de NPC no Roblox Studio?

Há três formas: o objeto Dialog integrado, para menus simples de clicar para falar; uma árvore própria em um ModuleScript com a sua interface; ou respostas de IA a partir de um Script de servidor. Com a Neocortex, você pode combinar as duas últimas, então as escolhas criadas por você e a digitação livre dividem a mesma janela de diálogo.

O que é o objeto Dialog no Roblox?

Dialog é um objeto integrado que você coloca dentro da cabeça de um NPC, com objetos DialogChoice abaixo dele para as opções do jogador. Ele oferece um menu sem código, mas com aparência fixa. As respostas da Neocortex podem alimentar uma interface própria, na qual os jogadores também podem digitar as próprias perguntas.

Os jogadores podem digitar as próprias respostas para um NPC do Roblox?

Sim, se o NPC for apoiado por um personagem de IA. O cliente envia o texto digitado ao servidor por um RemoteEvent, o servidor chama a Neocortex e filtra a resposta, e o jogador vê uma resposta escrita exatamente para o que perguntou.

Como impedir que um NPC de IA quebre a minha missão?

Mantenha os passos essenciais da missão como botões, dê ao personagem um Conversation Flow que devolva palavras-chave de checkpoint, e execute apenas ações de uma lista que o seu servidor permite. Os personagens da Neocortex conversam livremente, mas o código do seu jogo ainda decide o que realmente acontece.

O que acontece se o serviço de IA não responder?

Envolva o pedido em pcall, defina um timeout curto e volte para uma fala pronta da sua árvore de diálogo. A conversa continua, e o próximo pedido tenta a Neocortex de novo.

Artigos semelhantes

Continue lendo