Neocortex Logo

Как создать ИИ NPC в Godot | Руководство 2026

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

Sercan AltundasFounder of Neocortex

· 9 мин чтения

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

ИИ 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.

  1. Создайте ключ API. Для OpenAI его создают на platform.openai.com/api-keys.
  2. Добавьте узел HTTPRequest. Сделайте его дочерним узлом сцены NPC и подключите его сигнал request_completed к функции в скрипте NPC.
  3. Опишите персонажа. Держите строку с системной инструкцией: имя персонажа, роль, тон и ограничения.
  4. Отправьте реплику. Соберите JSON-тело с моделью, инструкциями и сообщением игрока, затем вызовите request() с адресом https://api.openai.com/v1/responses, заголовками Authorization: Bearer <key> и Content-Type: application/json, методом POST и телом запроса.
  5. Прочитайте ответ. В обработчике request_completed разберите тело как JSON и выведите текст в Label или RichTextLabel над NPC.
  6. Сохраняйте историю. Храните последние реплики в Array и отправляйте их с каждым запросом: модель между вызовами ничего не помнит.
  7. Добавьте дополнительное. Голос, синхронизация губ и действия - ваша работа: дополнительные вызовы API для речи и собственные правила, которые превращают ответы в игровые действия.
  8. Берегите ключ. Документация Godot рекомендует TLS и предупреждает против отправки чувствительных данных. Ключ в экспортированной игре можно прочитать, поэтому перед релизом поставьте свой сервер между игрой и провайдером.

Стоимость: сам Godot бесплатен. Вы платите тарифы провайдера за токены.

Где проигрывает: память, голос, действия, безопасность и сервер для ключа - все это вам строить и поддерживать.

Способ 2: SDK Neocortex для Godot

Neocortex - наш продукт, поэтому читайте этот раздел с этим в виду. Персонаж проектируется в визуальном редакторе в браузере, а затем используется в Godot через дополнение с открытым кодом (Apache 2.0). Личность, знания, эмоции, голос и действия - это узлы в редакторе; в Godot вы добавляете готовые узлы. Полный список есть на странице Godot AI NPC.

Что нужно: Godot 4.7 или новее и аккаунт Neocortex с ключом API.

  1. Создайте персонажа. В панели управления откройте Characters, нажмите Create New Character, введите имя и нажмите Create. Постройте его в редакторе узлов.
  2. Проверьте в браузере. Нажмите Play в правом верхнем углу редактора.
  3. Создайте ключ API. Откройте API Keys в панели управления.
  4. Установите дополнение. Скачайте последний релиз по адресу https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest и скопируйте addons/neocortex-godot-sdk в папку addons вашего проекта.
  5. Включите его. Откройте Project > Project Settings > Plugins и включите Neocortex. Вставьте ключ API в панель Neocortex.
  6. Добавьте чат в один шаг. Выберите Project > Tools > Neocortex > Complete Text Chat или Complete Voice Chat. Это добавит в сцену рабочий чат; персонажа выберите в выпадающем списке Inspector.
  7. Подключите к игре. Используйте узел NeocortexSmartAgent для персонажа, NeocortexAudioReceiver для микрофона, NeocortexFaceAnimator для синхронизации губ по blend shapes в стиле ARKit, NeocortexInteractable для объектов, о которых персонаж должен знать, и NeocortexEventLogger для событий. Узлы действий в редакторе передают имена действий, с которыми может работать ваш GDScript.
  8. Откройте примеры. Семь демонстрационных сцен и лаунчер открываются из панели 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.

  1. Установите. В Godot откройте вкладку AssetLib, найдите NobodyWho, скачайте и импортируйте с галочкой Ignore asset root. Или скопируйте addons/nobodywho из релиза в свой проект. Перезапустите или перезагрузите редактор.
  2. Выберите модель. Подходит любая модель GGUF. В readme для начала предлагается Qwen3 0.6B; удаленные модели загружаются и кешируются при первом использовании.
  3. Создайте чат. В скрипте вызовите await NobodyWhoChat.create(<model path>, {}).
  4. Задайте вопрос. Вызовите chat.ask(<player text>) и дождитесь completed() у результата через await. В документации сказано всегда сразу ждать возвращенное значение.
  5. Задайте роль. Дайте чату инструкции персонажа, следуя разделу Chat в документации NobodyWho.
  6. Проверьте цели экспорта. 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.

  1. Установите плагин. Возьмите его в Godot Asset Library или на GitHub и перетащите папку addons в свой проект.
  2. Добавьте ID клиента. Создайте его на player2.game/profile/developer и введите в Project Settings > Player2 > Game Key.
  3. Добавьте узел NPC. Добавьте в сцену узел Player2 AI NPC и отредактируйте описание агента.
  4. Подключите чат. Вызовите функцию chat узла с текстом игрока и подключите его сигнал chat_received, чтобы показывать ответы. Вызывайте notify, чтобы сообщить агенту о событиях в мире.
  5. Добавьте голос. Задайте Voice ID в Character Config или добавьте узел Player2TTS; для распознавания речи добавьте Player2STT и включите ввод аудио в Project Settings > Audio.
  6. Запустите Player2. Откройте приложение Player2; плагин подключится автоматически.

Стоимость: бесплатно для авторов, по данным страниц Player2. Плагин распространяется по GPLv3.

Где проигрывает: сайт Player2 указывает, что локальные API работают только при открытом приложении, поэтому продумайте, что увидят игроки без него. Сверьте лицензию GPLv3 с вашим проектом.

Сравнение четырех способов

ФакторHTTPRequest и APISDK NeocortexNobodyWhoПлагин Player2
Где описан персонажСтроки в GDScriptВизуальный редактор узлов в браузереВаш GDScriptОписание узла в Godot
Где работает модельОблако провайдераОблако NeocortexУстройство игрокаЧерез приложение Player2
Версия Godot4.x с HTTPRequest4.7 или новее4.6 или новее4.5 по списку
ГолосДелаете самиВключен, с синхронизацией губУказан для движкаУзлы TTS и STT
Лицензия дополненияНе нужнаApache 2.0EUPL-1.2GPLv3
Стартовая стоимостьТарифы провайдера за токеныОт 9 € в месяцБесплатноБесплатно для авторов
Нужные навыкиGDScript, HTTP, серверКопирование дополнения, добавление узловGDScript, выбор моделиДобавление узла

HTTPRequest дает полный контроль ценой наибольшего объема кода. NobodyWho - офлайн-путь, привязанный к железу игрока. Neocortex хранит персонажей в облачном редакторе с голосом, синхронизацией губ и примерами. Player2 - самый быстрый узел для добавления, и он зависит от своего приложения.

Советы для лучших результатов в Godot

Эти привычки помогают при любом способе.

  1. Не храните ключи в экспорте. Все, что есть в экспортированном проекте, можно прочитать. Храните файлы настроек с ключами вне системы контроля версий и используйте сервер или лимиты использования на игрока и на персонажа.
  2. Показывайте, что NPC услышал игрока. Переключайтесь на анимацию «думаю» или выводите метку в момент начала запроса, чтобы ожидание ответа никогда не выглядело как зависшая игра.
  3. Расскажите персонажу о сцене. Передавайте ближайшие объекты и недавние события с каждым сообщением, чтобы NPC говорил о комнате, в которой стоит.
  4. Пусть окончательное решение о действиях принимает GDScript. Держите короткий список действий, которые персонаж может запросить, и проверяйте каждое в коде перед запуском.
  5. Используйте дерево диалогов для сюжета. Реплики, которые двигают историю, держите в дополнении для сценарных диалогов, а ИИ-персонажа используйте для всего вокруг них. В нашем посте о плагинах 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.

Похожие статьи

Читайте также