Это высокоуровневое описание основных возможностей плагина. Для более подробного списка текущих доступных функций вы можете посмотреть расширенный список функций.

Краткий обзор функций

Это высокоуровневый обзор основных функциональных возможностей.

• Универсальная архитектура и анализ активов: Генерация, модификация, рефакторинг и получение подробных объяснений для Blueprints, Materials, Behavior Trees, Animation Blueprints и Widget Blueprints. Экспорт любого описания на диск для документации.
• Управление проектом и активами: Создание новых активов на лету, включая Structs, Enums, Blueprints и папки, прямо из промпта.
• Управление сценой в реальном времени: Спавн, выбор и манипуляция актерами прямо в окне уровня с помощью разговорных команд. (Экспериментально)
• Разговорный дизайн UI: Проектирование и прототипирование целых UMG макетов, создание отдельных виджетов и изменение их свойств с использованием естественного языка. (Экспериментально)
• Интеллект на уровне проекта: Сканирование всего проекта (Blueprints, Materials и т.д.) для поиска проблемных мест производительности и задания контекстных вопросов о вашей кодовой базе.
• Внешний анализ C++: Чтение и запись во внешние исходные файлы C++ (.cpp/.h) для анализа или модификации внешних кодовых баз.

После приобретения плагина вам просто нужно открыть Epic Games Launcher, зайти в библиотеку Unreal Engine, найти этот плагин и установить его в движок.

Откройте Unreal Engine и перейдите во вкладку Plugins.

Включите BP Generator и убедитесь, что эти другие плагины включены, затем перезапустите редактор.

Перезапустите редактор.

Вот и все, вы можете использовать плагин прямо сейчас, но продолжайте читать следующие детали:

Плагин по умолчанию имеет ~100k токенов бесплатного использования через API-ключ, который я добавил. Когда эти ~100k токенов закончатся, вам нужно будет использовать свой API-ключ. Вы можете использовать практически любого провайдера, а также подключить плагин к локальной LLM, если ваша машина достаточно мощная.

Gemini предлагает бесплатный API-ключ. Более подробная информация об API-ключах в разделе API KEYS.

Версия 0.3.5, выпущенная 26 января, полностью интегрирует плагин в Unreal Editor без необходимости использования сторонних приложений и соединений, таких как Claude Desktop, Cursor, или подключения плагина через расширение браузера к DeepSeek.

Плагин все еще можно использовать как обычно через Claude Desktop и другие десктопные приложения, такие как Cursor, Github Copilot, Google Antigravity и т.д., а также локальные LLM (с версией 0.3.5).

НАСТРОЙКА API-КЛЮЧА GOOGLE GEMINI (бесплатно и рекомендуется)

Видеообзор

Перейдите на веб-сайт Google Studio, чтобы создать новый API-ключ.

Нажмите на кнопку Create API key.

Второй вариант, если у вас еще нет созданного проекта в Google Cloud.

Скопируйте сгенерированный ключ и вернитесь к своему проекту Unreal Engine.

Добавьте ключ и сохраните.

НАСТРОЙКА API-КЛЮЧА OPEN AI (chatgpt)

Хотя я рекомендую Gemini, OpenAI также является жизнеспособным выбором.

Перейдите на https://platform.openai.com/usage.

После входа нажмите на текст Edit Budget во вкладке Usage.

В открывшемся новом окне найдите раздел Billing.

Выберите Add to credit balance, и вы можете выбрать минимальные 5$ кредита. После добавления кредитного баланса вы сможете получить доступ к разделу API keys и создать новый ключ.

Скопируйте сгенерированный ключ и перейдите к своему проекту Unreal Engine.

Claude, DeepSeek API KEY работают так же, как OpenAI - вам нужно пополнить кредиты на их веб-сайте, чтобы API-ключ работал, или у вас должна быть действующая подписка на них, и вы сможете получить ключ.

Этот вариант является модульным и будет работать практически с любым API-провайдером. Я тестировал его с Z.ai и Venice.ai.

Для опции пользовательского провайдера вам нужно заполнить API endpoint, имя модели и API Key. Вы найдете эти детали на веб-сайте провайдера.

Ultimate Blueprint Generator поддерживает локальные OpenAI-совместимые серверы, такие как Ollama и LM Studio. Это позволяет использовать офлайн, повышенную конфиденциальность и отсутствие затрат на API.

ВАЖНО: URL эндпоинта

Ваш эндпоинт ДОЛЖЕН заканчиваться на /v1/chat/completions, чтобы плагин работал корректно.

НЕ используйте пути типа /chat, /generate или просто базовый URL. Они не будут работать.

Настройка Ollama

Шаг 1: Установка и запуск Ollama

1. Скачайте с ollama.ai и установите
2. Загрузите модель: ollama pull llama3.2
3. Запустите модель: ollama run llama3.2
4. Ollama автоматически запускает свой API-сервер в фоновом режиме

Шаг 2: Настройка в плагине

В настройках API плагина:

• Провайдер: Выберите Custom API Provider
• URL API Endpoint: http://localhost:11434/v1/chat/completions
• Имя модели: В главном окне Blueprint Generator введите вашу модель (например, llama3.2)

Настройка LM Studio

Шаг 1: Запуск сервера

1. Откройте LM Studio и перейдите на вкладку Local Server (иконка </>)
2. Выберите модель из выпадающего списка для загрузки
3. Нажмите кнопку Start Server

Шаг 2: Настройка в плагине

В настройках API плагина:

• Провайдер: Выберите Custom API Provider
• URL API Endpoint: http://localhost:1234/v1/chat/completions
• Имя модели: В главном окне введите точное имя модели, показанное в выпадающем списке LM Studio

Устранение неполадок

Проблемы с подключением?

• Убедитесь, что ваш локальный сервер действительно запущен перед отправкой запросов
• Проверьте, что URL заканчивается на /v1/chat/completions (НЕ /chat или /generate)
• Проверьте, что порт совпадает (Ollama: 11434, LM Studio: по умолчанию 1234)
• Для сетевых машин замените localhost на IP (например, http://192.168.1.50:11434/v1/chat/completions)
• Проверьте, что ваш брандмауэр не блокирует соединение

Почему /v1/chat/completions?

Плагин использует формат OpenAI API, который является стандартом для локальных LLM-серверов. Эндпоинт /v1/chat/completions предоставляет структурированные JSON-ответы, которые плагин может правильно разобрать. Другие эндпоинты, такие как /chat или /generate, используют другие форматы и не будут работать.

Протестированные локальные модели

• Ollama minimax m2

Скачайте и установите с их веб-сайта: https://claude.ai/download

После установки запустите его и найдите Settings:

В настройках перейдите в Extensions → Advanced Settings

Установите расширение:

И перейдите туда, где на вашем компьютере установлена новая версия плагина. (например: C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/Extensions). И добавьте их по одному:

После установки обоих вы должны увидеть их работу во вкладке Developer.

Инициируйте Claude, сказав “how to use the connected tools?”

Это файл конфигурации MCP по умолчанию, но вам нужно изменить путь, чтобы он указывал на место, где Epic установил плагин:

{
  "mcpServers": {
    "unreal-handshake": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "unreal-handshake"
      ],
      "env": {
        "UNREAL_HOST": "localhost",
        "UNREAL_PORT": "9877"
      }
    },
    "filesystem-access": {
      "command": "python",
      "args": [
        "C:/Program Files/Epic Games/UE_5.7/Engine/Plugins/Marketplace/Ultimate3867945fbc2aV39/Content/Python/mcp_main_server.py",
        "--server-name",
        "filesystem-access"
      ]
    }
  }
}

!! Путь, который вы скопируете, будет иметь \ слеши вместо / слешей. Обязательно замените \ на / !!

Если вы столкнетесь с трудностями, обязательно проконсультируйтесь с AI, и он сможет направить вас дальше в настройке выбранного вами приложения.

Вы можете настроить поведение AI, добавив пользовательские инструкции, которые будут отправляться с каждым запросом.

Доступ к пользовательским инструкциям

Нажмите на кнопку “Instructions” внутри интерфейса плагина в Unreal Editor.

Добавление ваших инструкций

Во вновь открывшейся вкладке вы сможете добавить свои пользовательские инструкции. Эти инструкции отправляются с каждым запросом к AI, позволяя вам изменять поведение AI в соответствии с вашими конкретными потребностями.

Гораздо больше опций настройки будет добавлено в будущих обновлениях.

Если вы используете бесплатный API-ключ Gemini, вы можете столкнуться с определенными кодами ошибок из-за ограничения частоты запросов.

Распространенные коды ошибок

Вы можете ознакомиться с официальной документацией по кодам ошибок здесь: Устранение неполадок Gemini API

Работа с ограничениями частоты (Ошибка 429)

Если вы столкнулись с ошибкой 429 (Rate Limit):

• Создайте несколько бесплатных API-ключей, используя разные учетные записи Google
• В будущем обновлении будет добавлен простой способ переключения между API-ключами
• Комбинируйте бесплатный уровень Gemini с бесплатным уровнем Claude Desktop для минимизации ограничений
• Рассмотрите использование локальной LLM для офлайн-использования без затрат на API

Для получения более подробной информации или помощи присоединяйтесь к Discord серверу.