Как подключить Gemini к Roblox Studio: 3 способа и готовый код для разработчиков из России

Roblox Studio хорош, когда нужно собрать игру на коленке. Но стоит задача посложнее, например, генерация диалогов или умные NPC, и Lua перестает радовать. На помощь приходит Gemini. Подключить его к студии можно тремя способами, и все они рабочие. Сейчас покажу, как это сделать, и заодно обойдем подводные камни для разработчиков из России.

Для подключения нужны три вещи

Roblox Studio актуальной версии, аккаунт Google и API-ключ от Gemini. Ключ создается бесплатно в Google AI Studio. Если вы уже пользуетесь другими сервисами Google, ключ появится за минуту. Останется только включить HTTP-запросы в настройках игры для способа через API.

Первый способ, который я покажу, не требует этих настроек. Он подойдет, если вы просто хотите пользоваться ИИ-ассистентом внутри редактора.

Способ 1. Встроенный ИИ-ассистент с ключом Gemini

Самый быстрый путь. В Roblox Studio есть встроенный AI Assistant, иконка в правом верхнем углу. Если его не видно, откройте через меню View. Дальше кликаете на три точки в окне ассистента и выбираете Manage API keys. Там нужно сменить провайдера с Roblox defaults на Google API, нажать Edit и вставить API-ключ от Gemini.

Ключ берется в Google AI Studio (ai.google.dev). В разделе API keys нажимаете Create API key. Сервис создаст строку вида AIza... Копируете и вставляете в Roblox Studio. Сохраняете, и ассистент начинает отвечать через Gemini.

Этот способ не требует кода, подходит для генерации скриптов прямо в редакторе. Но у него есть ограничения. Ассистент работает только в редакторе, а не в рантайме. Для боевых игровых функций, когда NPC должен вызывать нейросеть в процессе игры, вам нужен API.

Способ 2. Прямой API через ModuleScript на Lua

Тут мы делаем полноценную интеграцию. Бот или NPC сможет обращаться к Gemini прямо во время игры. Начнем с настройки.

В Roblox Studio откройте Game Settings, перейдите в Security и включите Allow Http Requests. Без этого игра заблокирует любые запросы наружу.

Теперь создайте ModuleScript с именем api_key. В него положите ваш ключ:

return {
    apiKey = "AIza..."
}

Другой ModuleScript назовите AIModule. Внутри нужен код для отправки запроса. Ключевые моменты: получить HttpService, получить ключ и собрать POST-запрос.

Создайте переменные в начале модуля:

local HS = game:GetService("HttpService")
local config = require(script.Parent:WaitForChild("api_key"))
local GEMINI_API_KEY = config.apiKey
local API_URL = "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent"

Дальше функция запроса. Берем текст от игрока, оборачиваем в нужную структуру JSON, отправляем POST и разбираем ответ.

local module = {}

function module.chat(prompt, history, behavior)
    local body = {
        contents = {
            {
                parts = {
                    { text = prompt }
                }
            }
        }
    }
    local requestBody = HS:JSONEncode(body)

    local requestData = {
        Url = API_URL .. "?key=" .. GEMINI_API_KEY,
        Method = "POST",
        Headers = {
            ["Content-Type"] = "application/json"
        },
        Body = requestBody
    }

    local response = HS:request(requestData)
    local decoded = HS:JSONDecode(response.Body)
    return decoded.candidates[1].content.parts[1].text
end

return module

Код выше собран по мотивам примеров из документации и гайдов на DevForum. Он реально работает, но следите за квотой. Бесплатный тариф Gemini Flash дает небольшое число запросов в минуту, для разработки хватает.

Здесь один нюанс. Если вы хотите, чтобы NPC помнил контекст беседы, передавайте в запрос не только текущую реплику, а весь массив history. В официальном API Gemini для этого используется поле contents, куда вы кладете список сообщений. Мы для простоты опустили этот код, но на практике это половина успеха для умного диалога.

Способ 3. MCP-сервер для продвинутых

MCP (Model Context Protocol) открывает доступ ассистента к файлам, данным и сервисам прямо из Roblox Studio. Фишка в том, что ИИ сам ищет информацию в ваших скриптах.

В настройках AI Assistant есть раздел MCP Servers. Включаете, вставляете JSON-конфигурацию, которую дал разработчик сервера. Еще понадобится утилита для запуска MCP, например, Anti-Gravity.

Этот способ не для всех: нужно уметь настраивать окружение, разбираться в JSON и эндпоинтах. Лично я пользуюсь вторым способом, он проще и прозрачнее.

Почему из России возникает боль, и как ее избежать

Тут начинается самое интересное. Google официально не работает в России. Создать аккаунт и получить ключ можно только через VPN, а для оплаты нужна иностранная карта. Бесплатного тарифа хватает на эксперименты, но для коммерческой игры это мучение. Плюс ключ могут заблокировать в любой момент.

Есть обходной путь: использовать сервис-агрегатор, который дает доступ к нейросетям из России напрямую. Например, 3GPT от 3SELLER. Это ИИ-роутер: там не нужны иностранные карты и VPN. Пополняете баланс российской картой, через СБП или крипту, и получаете доступ к флагманским моделям за 149 рублей. В подписку входят Chat GPT 6 Astra, Chat GPT 6.1 Sol, Chat GPT 5.5, Claude Fable 5, Claude Fable 5.1, Claude Opus 5.5, Nano Banana для генерации изображений и инструменты для создания видео.

Интеграция с Roblox Studio происходит точно так же, как с официальным Google API. Вы получаете API-ключ на сайте 3GPT и вставляете его в те же поля. Разница в том, что доступ стабилен из России, а стоимость в разы ниже, чем у прямых API.

Вот так выглядит интерфейс 3GPT:

Готовые ИИ-агенты для Роблокса

Пока вы подключаете Gemini, стоит посмотреть на готовые ИИ-агенты от 3GPT. Это уже настроенные сценарии под конкретные задачи: генерация текста, изображений, видео. Можно выбрать агента и общаться с ним в чате, менять модель прямо во время диалога.

Для Roblox-разработчика агент может сгенерировать описание предмета, написать диалог для NPC или придумать сюжет квеста. Например, агент для текстов за пару секунд выдаст описание меча "Пламя дракона", которое раньше пришлось бы выдумывать вручную. Это экономит время, которое уходит на промпты.

Посмотреть список агентов можно на странице 3SELLER AI Agents.

Вернемся к подключению. Если выбираете между способом с встроенным ассистентом и через ModuleScript, держите в голове сценарий. Ассистент в редакторе помогает писать код, но не работает в игре. API через ModuleScript - то, что нужно для живых NPC и интерактивных функций.

Типичные ошибки и как их чинить

Первая проблема: при запросе вы получаете 403 Forbidden. Значит, ключ введен неправильно, либо у вас не активирован доступ к Gemini API в Google Cloud. На Reddit в похожих обсуждениях чаще всего выясняется, что дело именно в неактивированном API, а не в коде. Зайдите в консоль разработчика и убедитесь, что проект существует и API подключен.

Вторая проблема: Roblox Studio пишет HTTP 400. Скорее всего, вы неправильно собрали JSON-структуру тела запроса. Проверьте, что вы передаете именно то поле, которое ждет модель. В примерах выше все уже собрано правильно.

Третья проблема: запрос уходит, но ответ приходит слишком долго или вообще не приходит. Причина в лимите бесплатного тарифа. Gemini Flash имеет ограничение по запросам в минуту. Попробуйте добавить паузу между вызовами или переключиться на платный тариф.

И последнее: не храните ключ в публичных скриптах на клиенте. Если вы делаете игру с открытым кодом, злоумышленники смогут украсть ваш ключ и нагенерировать много запросов. Лучше держать ключ в ServerScriptService и запрашивать через RemoteEvent.

С чего начать прямо сейчас

Подключить Gemini к Roblox Studio можно за десять минут. Встроенный ассистент с ключом - самый простой вариант для старта. Для боевой интеграции используйте API и HttpService. Если вы в России и не хотите зависеть от VPN и иностранных карт, зарегистрируйтесь в 3GPT от 3SELLER, получите ключ за 149 рублей и вставьте его в тот же код. Доступ к Chat GPT 6 Astra, Claude Fable 5.1 и другим флагманам будет стабильным уже через минуту. Официальный сайт: https://3seller.com/3gpt.