Документация RoCode

Что такое RoCode

RoCode (RoCode.app) это ИИ-агент для Roblox Studio. Вы описываете функцию в веб-чате на rocode.app. Затем бесплатный плагин RoCode из Roblox Creator Store выполняет шаги агента в открытом у вас плейсе: читает объекты и скрипты, нужные для шага, пишет Luau, создаёт или правит Script, LocalScript, ModuleScript и другие объекты и проверяет свои скрипты на ошибки компиляции в Studio, прежде чем закончить.

DeepSeek V4 Flash, GLM 5.3 Flash, Claude Sonnet 5.5, Claude Opus 5.5 и GPT-6 Astra это сторонние модели, которые RoCode запускает через OpenRouter со своими инструкциями и инструментами Studio. Собственных моделей у RoCode нет.

Что нужно

Не нужны: десктопное приложение, командная строка, файлы конфигурации, MCP-сервер и ваш пароль Roblox. RoCode никогда не просит пароль Roblox.

Установка плагина и подключение к чату

Установка и подключение по шагам

1. Создайте бесплатный аккаунт. Войдите на rocode.app по коду на почту, через Google, Roblox или Discord.
2. Установите плагин. Откройте плагин RoCode в Creator Store и установите его. Установленные плагины появляются на вкладке Plugins в Studio. В менеджере плагинов RoCode называется RoCode AI.
3. Дайте разрешения. Когда Studio спросит, разрешите HTTP-запросы к relay.rocode.app и Script Injection.
4. Откройте плейс в Roblox Studio: игру, над которой работаете, или новый Baseplate.
5. Откройте чат. Откройте rocode.app/chat в браузере на компьютере. Если Studio вошёл в тот же аккаунт Roblox, которым вы вошли в RoCode или привязали к нему, он подключится сам (плагин 3.9.13 или новее). Если чат показывает Connect Studio, нажмите эту кнопку.
6. Или используйте код сопряжения. Если Studio не подключился сам, панель RoCode показывает код из 8 символов; если его не видно, нажмите Use a pairing code. В карточке чата Connect to Roblox Studio введите код и нажмите Connect.
7. Подтвердите в Studio. После кода панель RoCode показывает строку подтверждения с вашим аккаунтом. Нажмите там Connect (или Allow). Она ждёт до 2 минут, затем показывает новый код.

Вход

• Код на почту: RoCode присылает одноразовый код входа. Пароля нет.
• Google и Discord: вход через соответствующий аккаунт.
• Roblox: вход через аккаунт Roblox, RoCode никогда не просит пароль Roblox. Вход через Roblox не привязывается к уже существующему аккаунту RoCode, поэтому если вы уже пользуетесь RoCode, входите как обычно, чтобы сохранить план и чаты. Добавить почту потом можно по желанию: она нужна для чеков и для входа без Roblox.

Разрешения Studio, которые просит плагин

Одна настройка Studio необязательна и остаётся за вами: Enable Studio Access to API Services. Она нужна, чтобы тестировать сохранение в DataStore в Studio, и RoCode не может её изменить. В Studio откройте File > Experience Settings > Security, включите её и нажмите Save. Плейс сначала нужно опубликовать. Studio тогда использует те же хранилища данных, что и живая игра, поэтому Roblox советует включать это только в отдельной тестовой копии.

Как работает сопряжение

Первый запуск

Чат не отправит сообщение, пока Studio не подключён: кнопка отправки неактивна, а при наведении показывает Connect the plugin first. Когда Studio подключён, опишите одно изменение.

Хороший первый промпт

• Одна функция за раз. Так получается лучше, чем целая игра в одном сообщении.
• Скажите, что должно происходить, обычными словами, можно на русском. Знать названия классов и куда идут скрипты не нужно.
• Укажите важное. Введите / в поле сообщения, чтобы прикрепить точный путь к объекту Studio, например к скрипту, который нужно поменять. Кнопкой + можно прикрепить до 12 текстовых файлов (всего 20 000 символов) и до 4 изображений на сообщение, на любой модели.
• Просто вопрос? Переключите поле ввода в режим Ask, и в плейсе ничего не изменится.
• Или надиктуйте. Кнопка микрофона записывает промпт; расшифровка попадает в поле сообщения, где её можно поправить и отправить.

Пример промпта написали мы. Названия инструментов настоящие, но что сделает запуск, зависит от вашего плейса.

Куда RoCode кладёт вещи

Что вы видите во время работы

• Пошаговый журнал. Чат показывает каждый шаг по названию инструмента. Каждое чтение и каждое удаление показывается с путём.
• Сколько это длится. Зависит от задачи, размера плейса и модели. Один запуск может длиться до 80 ходов модели или 5 часов. Чат показывает, сколько кредитов тратит запуск.
• Следующий промпт может ждать в очереди. Пока запуск идёт, можно поставить в очередь следующий. Одновременно может идти до 3 запусков.
• Никаких правок во время плейтеста. Если плейтест идёт, когда нужно изменение, RoCode сначала останавливает тест, включая запущенный вами. Если Studio всё ещё в Play через 20 секунд, он ничего не меняет и просит нажать Stop.

Stop и Continue

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

Режимы Build и Ask

Каждое сообщение выполняется в одном из двух режимов. Build включён по умолчанию и меняет плейс. Ask, добавленный 9 октября 2026 года, отвечает на вопросы об игре и ничего не меняет.

Чтобы переключить режим, нажмите на чип режима на панели под полем сообщения (слева, рядом с кнопкой + и статусом плагина) и выберите Ask или Build. Выбор запоминается в этом браузере, поэтому проверяйте чип перед отправкой изменения. Ask тоже нужен подключённый Studio, потому что он читает плейс. Промпт в очереди, повторённый или продолженный, выполняется в том режиме, в котором был отправлен.

Инструменты Ask, все только для чтения: List Children, Get Descendants, Find Child, Search Game, Search Scripts, Get Properties, Inspect Model, Read Script, Check Output и Check Script. Check Script только компилирует скрипт и никогда его не запускает. Все 27 инструментов, 12 готовых конструкций и 7 макетов UI перечислены в английской документации.

Проверки, Output и отмена

Что проверяет Check Script

Check Script прогоняет скрипт через компилятор Luau внутри Studio. Ошибка компиляции возвращается со строкой и столбцом. Ещё он предупреждает о wait(), spawn() и delay() (лучше task.wait(), task.spawn() и task.delay()), о loadstring, о require, который не указывает на ModuleScript, о ModuleScript без возвращаемого значения и о несуществующем имени в GetService. Он не проверяет типы, не делает lint и не запускает код, поэтому ловит ошибки компиляции и несколько рискованных шаблонов, а не ошибки логики. После каждого Create Script или Edit Script агенту велено проверить этот скрипт; если проверка не прошла, RoCode не может закончить, пока не пройдёт более поздняя проверка. После двух попыток он может закончить и говорит, что всё ещё не проходит.

Ошибки из ваших плейтестов

1. Нажмите Play в Studio и воспроизведите проблему.
2. Скажите RoCode, что сломалось. Можно сначала нажать Stop: строки Server и Client последнего плейтеста сохраняются.
3. Check Output читает Output, затем RoCode читает скрипт вокруг строки с ошибкой и правит его.
4. Сыграйте снова, чтобы проверить исправление.

Короткий плейтест и тестовый робот

С плагином 3.9 или новее запуск в режиме Build может нажать Play для теста до 30 секунд, собрать ошибки и предупреждения сервера и клиента и остановить тест. Если Studio не останавливается за 20 секунд, он просит нажать Stop. Не больше двух раз за запуск, плюс ещё один раз, чтобы проверить своё исправление; Ask никогда не запускает плейтест. Когда тестировать, решает агент, поэтому не каждая сборка его получает. С плагином 3.9.11 или новее тестовый персонаж ходит, прыгает и наступает на парты, а с 3.9.15 или новее ещё нажимает клавиши, кликает по кнопкам на экране и печатает. Потом он проверяет, что всё произошло (урон, значения, парты), и отмечает каждую проверку как пройденную или нет. Тест не делает скриншотов и проверяет только то, что выбрал агент, поэтому не скажет, интересна ли игра.

Проверка внешнего вида

С плагином 3.9.14 или новее запуск в режиме Build, который построил или изменил что-то видимое, делает скриншоты в Studio перед завершением, не больше одного раза за запуск: обычно два, с противоположных углов, плюс один экранного UI, если строился UI. Они делаются в режиме редактирования, никогда во время плейтеста, а плагин потом возвращает камеру и выделение. RoCode отправляет их через OpenRouter в GLM 5.3 Flash, с DeepSeek V4.1 Flash в резерве, на любом плане. Модель перечисляет явные проблемы, например парты висят в воздухе или утоплены в землю, щели или неверный масштаб, а агент исправляет настоящие. Чат скриншоты не показывает, RoCode их не хранит.

Отмена по группам

RoCode ставит точку отмены в Studio до и после каждой группы изменений, поэтому Ctrl+Z (⌘Z на Mac) откатывает его работу по одной группе, пока Studio открыт. Запуск обычно состоит из нескольких групп, поэтому длинный запуск отменяется несколькими нажатиями. Кнопка Revert в чате откатывает только переписку, а не Studio.

Удаления

С 9 октября 2026 года RoCode удаляет или разгруппировывает объект, только если он создал этот объект раньше в том же чате, если ваше сообщение просит удалить или перестроить объект (по имени, по имени того, внутри чего он лежит, словами «всё» или пока он выделен в Studio), или если RoCode спросил, удалить ли, и вы ответили да. Иначе удаление отклоняется до Studio, и RoCode велено спросить вас. С плагином 3.8.5 или новее удалённый объект не уничтожается: плагин переносит его в папку RoCodeTrash в ServerStorage с записью исходного места, и скрипты в этой папке перестают работать. Папка сохраняется вместе с плейсом и хранит удаления последних 30 запусков (до 25 000 объектов); более старые и всё, что удалено изнутри корзины, исчезают навсегда.

Модели и кредиты

Кредит измеряет стоимость вычислений запуска. Сильные модели и длинные запуски тратят больше. По текущим ставкам сложная задача тратит около 4 кредитов, а обычная задача (DeepSeek V4 Flash) около 0,4. Это примерно 35 сложных или 375 обычных задач в месяц на Pro, около 80 или 800 на Studio и около 125 или 1 250 на Ultra. На бесплатной модели 1 кредита хватает на одну-две небольшие задачи. Starter получает 1 бесплатный кредит в день на DeepSeek V4 Flash; платные планы получают 2 в день, а кредиты плана тратятся после них.

Свой ключ OpenRouter есть только на платных планах: последняя карточка в выборе модели, ключ (sk-or-v1-...) и ID модели. Счёт выставляет OpenRouter, кредиты RoCode не тратятся. Подписки Claude, Claude Code и ChatGPT подключить нельзя. Ключ хранится в зашифрованном виде.

Пакеты кредитов на любом плане, на странице аккаунта: 50 кредитов за 4,99 $, 220 за 19,99 $, 580 за 49,99 $, 1 200 за 99,99 $ (в долларах США без налогов). Они тратятся после месячных кредитов и не сгорают. На Starter пакеты тратятся после бесплатных кредитов и работают на DeepSeek V4 Flash. Подробнее о пакетах в английской документации.

Ограничения

Чего RoCode сегодня не делает

• Не оценивает, интересна ли игра, и не играет за вас вне своих коротких плейтестов.
• Не делает скриншоты во время работы игры. Проверка внешнего вида снимает только построенное, в режиме редактирования. Свои скриншоты можно прикрепить на любой модели.
• Не лепит и не раскрашивает ландшафт вручную. Он может построить Terrain (холмы, горы, озёра, реки, острова и пляжи) сгенерированным скриптом; доработка руками остаётся за вами.
• Не генерирует меши, текстуры и анимации с нуля. Вместо этого Insert Model ставит уже существующие модели Creator Store: найденные по вашим словам или модель, декаль или меш по ID ассета или ссылке, которую вы дали.
• Не публикует и не сохраняет плейс и не меняет настройки опыта на сайте Roblox. Свойства плейса, например гравитацию, менять может, как любая правка в Studio.
• Не делает готовую, сбалансированную игру из одной фразы.
• Не работает на телефоне.

У него также нет инструментов для геймпассов, продуктов для разработчиков, загрузки ассетов и включения API Services. Полный список лимитов в английской документации.

Безопасность: что видит RoCode и как всё откатить

RoCode никогда не просит пароль Roblox и никогда не загружает файл плейса. Плагин отправляет результаты шагов, которые просит запуск (в том числе полный текст скриптов), позицию камеры и до 8 выделенных объектов в начале запуска, скриншоты проверки внешнего вида (плагин 3.9.14 или новее) и название и id плейса при подключении. Собственное сетевое соединение текущего плагина идёт только к серверу RoCode relay.rocode.app, по зашифрованному каналу. Сам Studio обращается к Roblox, чтобы загрузить модели Creator Store для Insert Model и, с плагином 3.9.13 или новее, узнать имя Roblox, под которым он вошёл.

• Без публикации и трат. В плагине нет кода, чтобы публиковать или сохранять плейс, загружать ассеты или тратить Robux. Insert Model ставит только уже существующие ассеты Creator Store, найденные по вашим словам или по ID ассета или ссылке, которую вы дали, и снимает скрипты внутри модели.
• Одно окно Studio. К аккаунту подключено только одно окно Studio. Когда шаг просит, RoCode может прочитать любой объект или скрипт открытого там плейса.
• Ваши правки скриптов. Edit Script не заменит целиком скрипт, который изменился после последнего чтения RoCode, а мелкие правки применяются к текущему тексту, поэтому ваши изменения остаются.
• Выход. Sign out в панели RoCode удаляет ключ подключения, сохранённый в этом Studio. Disconnect Studio в чате отключает все Studio вашего аккаунта.
• Оплата. Оплата идёт в кассе Paddle, поэтому карту вы вводите у Paddle, а не в форме RoCode. RoCode не хранит данные карт.

Кто делает RoCode: индивидуальный предприниматель (sole trader) в Великобритании под названием RoCode (см. условия); почта support@rocode.app. Инструкции RoCode велят агенту считать текст внутри вашего плейса данными, а не инструкциями, и отказываться от эксплойтов, бэкдоров и скриптов, которые вредят игрокам или крадут данные. Что хранится и кто обрабатывает запрос, описано в разделе о приватности (на английском).

Решение проблем

Большинство проблем с настройкой это один из случаев ниже. Если нет, спросите в Discord RoCode, поддержка там.

Все случаи в английской документации.

Планы

• На каждом плане все 27 инструментов. Платные планы добавляют модели, свой ключ OpenRouter и отсутствие дневного лимита, а их запуски идут в очереди раньше запусков Starter.
• Discord не нужен ни для бесплатных кредитов, ни для оплаты.
• Годовые планы на 30 % дешевле 12 месяцев месячного плана, оплачиваются раз в год, кредиты те же и пополняются каждые 30 дней.
• Paddle проводит оплату как продавец (merchant of record): принимает платёж, начисляет налог или НДС, выставляет счёт.
• Если вам меньше 18 лет, спросите владельца карты перед покупкой. Отменить можно на странице аккаунта; план остаётся до конца оплаченного периода.
• Возврат: полностью в течение 14 дней после любого платежа, включая продления и пакеты кредитов, по любой причине и где бы вы ни жили. Запросить можно на paddle.net или ответом на чек Paddle. После возврата новые планы, повышения и пакеты приостанавливаются на 60 дней, а купленные тем платежом кредиты снимаются. После 14 дней платежи не возвращаются, кроме случаев, когда этого требует закон.

Повышение, понижение и полное сравнение на странице цен (на английском).

Частые вопросы

Источники и что почитать

• Плагин RoCode в Roblox Creator Store
• Полная документация RoCode (на английском). все 27 инструментов, лимиты и приватность
• Цены (на английском)
• Политика конфиденциальности (на английском)
• Условия использования (на английском)
• Roblox Creator Docs: Data stores (на английском). доступ Studio к API Services и тестовая копия