Как сделать NPC с ИИ-диалогом и голосом в Roblox Studio

ИИ-NPC в Roblox можно собрать из трёх независимых частей: триггера игрока, TextGenerator для реплики и AudioTextToSpeech для голоса. Между генерацией и показом текста обязательна фильтрация Roblox. Мы сделаем гида с ProximityPrompt, короткой репликой на экране, 3D-голосом и безопасным запасным ответом.

Такой NPC может учитывать цель игрока, но не должен управлять наградами и прогрессом. Модель формулирует фразу, игровые правила остаются в серверном коде. Первая версия отвечает на фиксированный вопрос о кристаллах: prompt запускает генерацию, фильтр, BillboardGui и голос у головы NPC.

Как устроена цепочка ИИ-диалога и голоса

Создайте GuideNPC с Humanoid и Head. В Head добавьте ProximityPrompt, BillboardGui/TextLabel, AudioTextToSpeech, AudioEmitter и Wire. Свяжите Wire от TTS к Emitter. Включите нужные AI beta features, если они ещё не общедоступны. Скрипт в ServerScriptService получает объекты по точным путям. Фиксированный первый вопрос облегчает проверку длины и содержания.

Каждый объект имеет одну работу. Если голос молчит, можно отдельно проверить TTS и Wire. Если ответ не генерируется, запасная реплика всё равно покажет, что prompt, интерфейс и звук подключены правильно.

Текст становится видимым только после фильтра. Один отфильтрованный результат идёт в оба канала

Собираем NPC и серверный Luau-скрипт

Код ожидает объекты из таблицы. TextGenerator уже добавлен в GuideNPC. SystemPrompt ограничивает роль, MaxTokens сокращает ответ, а строка обрезается до лимита TTS. GenerateTextAsync и фильтрация работают в pcall. При любом сбое возвращается безопасная подсказка.

local TextService = game:GetService("TextService")
local npc = workspace:WaitForChild("GuideNPC")
local head = npc:WaitForChild("Head")
local prompt = head.ProximityPrompt
local label = head.BillboardGui.TextLabel
local voice = head.AudioTextToSpeech
local generator = npc.TextGenerator
local FALLBACK = "Ищи три кристалла у водопада."
local busy = false

generator.SystemPrompt = "Ты добрый проводник. Ответь одной фразой до 25 слов."

local function safeReply(player)
	local ok, response = pcall(function()
		return generator:GenerateTextAsync({
			UserPrompt = "Где искать кристаллы?", MaxTokens = 50})
	end)
	if not ok or not response.GeneratedText then return FALLBACK end
	local filteredOk, filtered = pcall(function()
		return TextService:FilterStringAsync(
			response.GeneratedText, player.UserId
		):GetNonChatStringForBroadcastAsync()
	end)
	if not filteredOk or filtered == "" then return FALLBACK end
	return string.sub(filtered, 1, 300)
end

prompt.Triggered:Connect(function(player)
	if busy then return end
	busy = true
	prompt.Enabled = false
	label.Text = "Думаю..."
	local reply = safeReply(player)
	label.Text = reply
	voice.Text = reply
	voice.TimePosition = 0
	voice:Play()
	voice.Ended:Wait()
	prompt.Enabled = true
	busy = false
end)

Модели подходит только одна сторона. Текст не является командой игровому серверу

Почему текст нужно фильтровать до показа и речи

TextGenerator возвращает GeneratedText, который нельзя сразу показывать или озвучивать. Roblox требует TextService:FilterStringAsync. Для общей реплики берём GetNonChatStringForBroadcastAsync. Только этот результат идёт в TextLabel и AudioTextToSpeech.Text. Строка ограничена 300 символами, busy и отключение prompt защищают от параллельных запросов.

AudioTextToSpeech ограничивает запросы и длину Text до 300 символов. Не запускайте генерацию на каждом Touched. Prompt, cooldown и кэш сокращают обращения. Храните несколько fallback-фраз и добавьте таймаут ожидания Ended. Генеративный текст отвечает за атмосферу, а число кристаллов, награды и условия квеста берёт сервер.

Проверяем задержку, повторные запросы и запасной ответ

Сначала отключите генерацию и верните FALLBACK напрямую. Проверьте prompt, BillboardGui, TTS и повторное нажатие. Затем включите TextGenerator и временно распечатайте только статус этапов, не полный пользовательский текст. Смоделируйте ошибку неверным именем NPC, отключённой beta feature и пустым GeneratedText. После восстановления запустите тест с двумя клиентами. Текущая версия использует общий busy, поэтому второй игрок ждёт окончания реплики. Это осознанное ограничение первого примера. Для персональных диалогов понадобится отдельное состояние по Player и решение, кому именно транслировать звук и субтитры.

Проверяем каждый слой отдельно. Сбой AI не ломает квест

Развиваем персонажа без передачи ему игровых правил

Дальше передавайте небольшой контекст: задание, найденные предметы и разрешённую подсказку. SystemPrompt запрещает менять правила, сервер фильтрует ответ. Кэшируйте одинаковые состояния, добавьте таймаут и оставьте субтитры. Фраза NPC «дам 100 монет» не является серверной командой.

Как изучить тему в Кодике

В Кодике сначала изучите обычного NPC: Model, Head, ProximityPrompt, события и свойства. Затем разберите pcall и серверные таблицы состояния. После этого подключите отдельно TTS и отдельно TextGenerator. Только когда оба компонента работают по одному, соединяйте их фильтрованной строкой.

В курсе Lua / Luau повторите функции, условия и события, затем соберите статического гида без генеративного API. В Кодике полезно нарисовать цепочку от Triggered до Play и подписать, на каком шаге появляется пользовательский контент и где он фильтруется.

Что получится в итоге

NPC показывает отфильтрованную подсказку над головой и произносит ту же строку в 3D-пространстве, сохраняя рабочий fallback при сбое AI.