Как создать ИИ NPC в Godot | Руководство 2026
Как создать ИИ NPC в Godot в 2026 году: HTTPRequest и API модели, SDK Neocortex для Godot, локальная модель через NobodyWho и плагин Player2.
Sercan AltundasFounder of Neocortex
· 9 мин чтения

ИИ NPC в Godot создается так: то, что говорит игрок, отправляется языковой модели, а ответ показывается или озвучивается. Можно сделать это через собственный узел HTTPRequest Godot и API модели, через SDK персонажей или через дополнение, которое запускает модель на компьютере игрока. У Godot нет собственной функции ИИ-персонажей, поэтому каждый путь добавляет GDScript или дополнение.
Это руководство для разработчиков на Godot 4, которым нужны персонажи, отвечающие своими словами, а не по дереву диалогов. Здесь описаны четыре способа: HTTPRequest с API модели, SDK Neocortex для Godot, локальная модель через NobodyWho и плагин Player2 AI NPC. У каждого есть свои шаги, требования и стоимость, затем идут таблица сравнения, советы для любого способа и частые вопросы.
4 способа создать ИИ NPC в Godot
Все четыре начинаются с узла в сцене, который представляет персонажа, и поля ввода для игрока: LineEdit или микрофон. Различаются они тем, где работает модель, кто за нее платит и сколько GDScript вы пишете.
Способ 1: HTTPRequest и API модели
Этот путь использует только то, что входит в Godot. Узел HTTPRequest - это «узел, умеющий отправлять HTTP-запросы», поэтому скрипт может отправить реплику игрока провайдеру модели и прочитать ответ. В примере используется OpenAI Responses API.
Что нужно: ключ API у провайдера модели и немного GDScript.
- Создайте ключ API. Для OpenAI его создают на platform.openai.com/api-keys.
- Добавьте узел HTTPRequest. Сделайте его дочерним узлом сцены NPC и подключите его сигнал
request_completedк функции в скрипте NPC. - Опишите персонажа. Держите строку с системной инструкцией: имя персонажа, роль, тон и ограничения.
- Отправьте реплику. Соберите JSON-тело с моделью, инструкциями и сообщением игрока, затем вызовите
request()с адресомhttps://api.openai.com/v1/responses, заголовкамиAuthorization: Bearer <key>иContent-Type: application/json, методом POST и телом запроса. - Прочитайте ответ. В обработчике
request_completedразберите тело как JSON и выведите текст в Label или RichTextLabel над NPC. - Сохраняйте историю. Храните последние реплики в Array и отправляйте их с каждым запросом: модель между вызовами ничего не помнит.
- Добавьте дополнительное. Голос, синхронизация губ и действия - ваша работа: дополнительные вызовы API для речи и собственные правила, которые превращают ответы в игровые действия.
- Берегите ключ. Документация Godot рекомендует TLS и предупреждает против отправки чувствительных данных. Ключ в экспортированной игре можно прочитать, поэтому перед релизом поставьте свой сервер между игрой и провайдером.
Стоимость: сам Godot бесплатен. Вы платите тарифы провайдера за токены.
Где проигрывает: память, голос, действия, безопасность и сервер для ключа - все это вам строить и поддерживать.
Способ 2: SDK Neocortex для Godot
Neocortex - наш продукт, поэтому читайте этот раздел с этим в виду. Персонаж проектируется в визуальном редакторе в браузере, а затем используется в Godot через дополнение с открытым кодом (Apache 2.0). Личность, знания, эмоции, голос и действия - это узлы в редакторе; в Godot вы добавляете готовые узлы. Полный список есть на странице Godot AI NPC.
Что нужно: Godot 4.7 или новее и аккаунт Neocortex с ключом API.
- Создайте персонажа. В панели управления откройте Characters, нажмите Create New Character, введите имя и нажмите Create. Постройте его в редакторе узлов.
- Проверьте в браузере. Нажмите Play в правом верхнем углу редактора.
- Создайте ключ API. Откройте API Keys в панели управления.
- Установите дополнение. Скачайте последний релиз по адресу
https://github.com/neocortex-link/neocortex-godot-sdk/releases/latestи скопируйтеaddons/neocortex-godot-sdkв папкуaddonsвашего проекта. - Включите его. Откройте Project > Project Settings > Plugins и включите Neocortex. Вставьте ключ API в панель Neocortex.
- Добавьте чат в один шаг. Выберите Project > Tools > Neocortex > Complete Text Chat или Complete Voice Chat. Это добавит в сцену рабочий чат; персонажа выберите в выпадающем списке Inspector.
- Подключите к игре. Используйте узел
NeocortexSmartAgentдля персонажа,NeocortexAudioReceiverдля микрофона,NeocortexFaceAnimatorдля синхронизации губ по blend shapes в стиле ARKit,NeocortexInteractableдля объектов, о которых персонаж должен знать, иNeocortexEventLoggerдля событий. Узлы действий в редакторе передают имена действий, с которыми может работать ваш GDScript. - Откройте примеры. Семь демонстрационных сцен и лаунчер открываются из панели Neocortex: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating и Quiz Show.
Ограничения, которые стоит знать: запись останавливается через 29 секунд, звуки короче 0,15 секунды не отправляются, а запросы чата прерываются по таймауту через 30 секунд.
Стоимость: Starter 9 €, Pro 29 € и Team 99 € в месяц при оплате за год, либо 11 €, 35 € и 119 € при ежемесячной оплате. Для коммерческого использования нужен Pro или Team. См. цены.
Где проигрывает: персонажи работают в нашем облаке, поэтому игре нужно подключение. Экспортированная игра содержит ключ API, поэтому задайте для него лимиты использования. Групповой чат нужен Pro или Team, викторина нужна Team, а наша документация перечисляет не все цели экспорта.
Способ 3: локальная модель через NobodyWho
NobodyWho - открытый движок вывода, который запускает языковые модели на компьютере игрока, и у него есть дополнение для Godot. В его readme сказано, что он не требует «ключей API» и не имеет скрытых платежей.
Что нужно: Godot 4.6 или новее (по его документации для Godot) и модель в формате GGUF.
- Установите. В Godot откройте вкладку AssetLib, найдите NobodyWho, скачайте и импортируйте с галочкой Ignore asset root. Или скопируйте
addons/nobodywhoиз релиза в свой проект. Перезапустите или перезагрузите редактор. - Выберите модель. Подходит любая модель GGUF. В readme для начала предлагается Qwen3 0.6B; удаленные модели загружаются и кешируются при первом использовании.
- Создайте чат. В скрипте вызовите
await NobodyWhoChat.create(<model path>, {}). - Задайте вопрос. Вызовите
chat.ask(<player text>)и дождитесьcompleted()у результата черезawait. В документации сказано всегда сразу ждать возвращенное значение. - Задайте роль. Дайте чату инструкции персонажа, следуя разделу Chat в документации NobodyWho.
- Проверьте цели экспорта. NobodyWho поддерживает Godot на desktop и Android. Экспорта для iOS или веба нет.
Стоимость: бесплатно для коммерческого использования по лицензии EUPL-1.2. Если вы меняете собственный код NobodyWho, эти изменения нужно опубликовать в открытом доступе.
Где проигрывает: скорость и качество ответа зависят от железа игрока и размера модели, а модель увеличивает загрузку. Голосовые функции указаны для движка; проверьте, есть ли они в привязке для Godot, прежде чем на них рассчитывать.
Способ 4: плагин Player2 AI NPC
Player2 - настольное приложение с локальными API для игр и модов. Его плагин для Godot «использует бесплатные ИИ-API из приложения Player2» и подключается, когда приложение открыто.
Что нужно: Godot 4.5 (как указано в Asset Library), ID клиента разработчика Player2 и приложение Player2.
- Установите плагин. Возьмите его в Godot Asset Library или на GitHub и перетащите папку
addonsв свой проект. - Добавьте ID клиента. Создайте его на player2.game/profile/developer и введите в Project Settings > Player2 > Game Key.
- Добавьте узел NPC. Добавьте в сцену узел Player2 AI NPC и отредактируйте описание агента.
- Подключите чат. Вызовите функцию
chatузла с текстом игрока и подключите его сигналchat_received, чтобы показывать ответы. Вызывайтеnotify, чтобы сообщить агенту о событиях в мире. - Добавьте голос. Задайте Voice ID в Character Config или добавьте узел
Player2TTS; для распознавания речи добавьтеPlayer2STTи включите ввод аудио в Project Settings > Audio. - Запустите Player2. Откройте приложение Player2; плагин подключится автоматически.
Стоимость: бесплатно для авторов, по данным страниц Player2. Плагин распространяется по GPLv3.
Где проигрывает: сайт Player2 указывает, что локальные API работают только при открытом приложении, поэтому продумайте, что увидят игроки без него. Сверьте лицензию GPLv3 с вашим проектом.
Сравнение четырех способов
| Фактор | HTTPRequest и API | SDK Neocortex | NobodyWho | Плагин Player2 |
|---|---|---|---|---|
| Где описан персонаж | Строки в GDScript | Визуальный редактор узлов в браузере | Ваш GDScript | Описание узла в Godot |
| Где работает модель | Облако провайдера | Облако Neocortex | Устройство игрока | Через приложение Player2 |
| Версия Godot | 4.x с HTTPRequest | 4.7 или новее | 4.6 или новее | 4.5 по списку |
| Голос | Делаете сами | Включен, с синхронизацией губ | Указан для движка | Узлы TTS и STT |
| Лицензия дополнения | Не нужна | Apache 2.0 | EUPL-1.2 | GPLv3 |
| Стартовая стоимость | Тарифы провайдера за токены | От 9 € в месяц | Бесплатно | Бесплатно для авторов |
| Нужные навыки | GDScript, HTTP, сервер | Копирование дополнения, добавление узлов | GDScript, выбор модели | Добавление узла |
HTTPRequest дает полный контроль ценой наибольшего объема кода. NobodyWho - офлайн-путь, привязанный к железу игрока. Neocortex хранит персонажей в облачном редакторе с голосом, синхронизацией губ и примерами. Player2 - самый быстрый узел для добавления, и он зависит от своего приложения.
Советы для лучших результатов в Godot
Эти привычки помогают при любом способе.
- Не храните ключи в экспорте. Все, что есть в экспортированном проекте, можно прочитать. Храните файлы настроек с ключами вне системы контроля версий и используйте сервер или лимиты использования на игрока и на персонажа.
- Показывайте, что NPC услышал игрока. Переключайтесь на анимацию «думаю» или выводите метку в момент начала запроса, чтобы ожидание ответа никогда не выглядело как зависшая игра.
- Расскажите персонажу о сцене. Передавайте ближайшие объекты и недавние события с каждым сообщением, чтобы NPC говорил о комнате, в которой стоит.
- Пусть окончательное решение о действиях принимает GDScript. Держите короткий список действий, которые персонаж может запросить, и проверяйте каждое в коде перед запуском.
- Используйте дерево диалогов для сюжета. Реплики, которые двигают историю, держите в дополнении для сценарных диалогов, а ИИ-персонажа используйте для всего вокруг них. В нашем посте о плагинах Godot перечислены дополнения для сценарной части.
Как выбрать способ для Godot
HTTPRequest и API модели подойдут, если вам не нужны дополнения, нужен полный контроль над каждым запросом и вы можете поднять небольшой сервер для ключа.
SDK Neocortex подойдет, если вы хотите проектировать персонажей визуально, проверять их в браузере и получить голос, синхронизацию губ, действия и примеры в Godot 4.7, при этом тот же персонаж работает в Unity и Unreal Engine.
NobodyWho подойдет, если игра должна работать офлайн без постоянных расходов, на desktop или Android.
Плагин Player2 подойдет, если ваши игроки уже пользуются приложением Player2 или вы делаете прототип и хотите минимум шагов.
Больше вариантов - в посте о лучших инструментах ИИ NPC для Godot, а если вы еще выбираете движок, см. Godot или Unity.
Частые вопросы
Можно ли создать ИИ NPC в Godot бесплатно?
Да. NobodyWho бесплатен и запускает модель локально, Player2 бесплатен для авторов. API модели, который вы вызываете сами, берет плату за токены.
Есть ли в Godot встроенные ИИ NPC?
Нет. Godot дает узел HTTPRequest для веб-запросов, но ни языковой модели, ни системы персонажей в нем нет. Наш пост Godot AI описывает, что существует вокруг движка.
Какая версия Godot нужна?
Neocortex требует Godot 4.7 или новее, NobodyWho - 4.6 или новее, а плагин Player2 указывает 4.5. HTTPRequest входит в Godot 4.
Может ли ИИ NPC в Godot работать офлайн?
Да, с локальной моделью, например NobodyWho на desktop или Android. Облачные варианты, включая Neocortex, требуют подключения.
Открыт ли SDK Neocortex для Godot?
Да. Он выпущен по лицензии Apache 2.0, а исходный код лежит на GitHub по адресу neocortex-link/neocortex-godot-sdk. Сообщения об ошибках и идеи там приветствуются.
Работают ли ИИ NPC в Godot в веб-экспорте?
Это зависит от способа. У NobodyWho экспорта в веб нет. Для браузерных игр вне Godot у Neocortex также есть Web SDK.






