Подключите свою игру Roblox к Baseplate

Быстрый старт (2 минуты)

1. Создайте игру в разделе Добавить игру и скопируйте токен bpt_....
2. Установите плагин Baseplate Connect в Studio и вставьте одноразовый код или скачайте Baseplate.rbxmx и вставьте его в ServerScriptService.
3. Включите Game Settings → Security → Allow HTTP Requests.
4. Добавьте серверный Script в ServerScriptService, который вызывает Baseplate.start.
5. Нажмите Play в Studio. Точка подключения в мастере настройки загорится зелёным через 15 секунд.

1. Добавьте модуль в вашу игру

Вариант А — плагин Baseplate Connect (в один шаг): скачайте BaseplateConnect.rbxmx в папку плагинов Roblox Studio, нажмите Baseplate Connect на вкладке Plugins и вставьте код со страницы настройки игры. Плагин сам создаст модуль Baseplate, скрипт BaseplateLoader в ServerScriptService, включит HttpService.HttpEnabled и отправит 3D-слепок карты уровня.

Вариант Б — вручную через .rbxmx: скачайте Baseplate.rbxmx, в Roblox Studio нажмите правой кнопкой по ServerScriptService → Insert from File… и выберите скачанный файл. Появится ModuleScript с именем Baseplate (со вложенным клиентским скриптом Client).

Оставьте Client внутри Baseplate — при вызове Baseplate.start() модуль автоматически копирует его в StarterPlayerScripts, чтобы измерять FPS клиента, устройство, время бездействия (AFK), меню Escape и открытые окна ScreenGui.

2. Включите HTTP-запросы

В Roblox Studio откройте File → Game Settings → Security и включите Allow HTTP Requests. Если игра ещё не опубликована в Roblox, сначала сохраните её в Roblox или выполните в Command Bar: game:GetService("HttpService").HttpEnabled = true.

Рекомендуется для продакшена: храните токен в Creator Hub → Creations → [Ваша игра] → Settings → Secrets с именем baseplate_token и читайте через HttpService:GetSecret("baseplate_token"), чтобы токен не лежал в открытом тексте в файле места.

3. Запустите Baseplate

Создайте Script в ServerScriptService:

local HttpService = game:GetService("HttpService")
local Baseplate = require(game.ServerScriptService.Baseplate)

Baseplate.start({
    token = HttpService:GetSecret("baseplate_token"),
    studio = true, -- send data from Studio playtests too (kept separate from live)
})

Или при быстром тесте в Studio передайте токен строкой:

local Baseplate = require(game.ServerScriptService.Baseplate)

Baseplate.start({
    token = "bpt_your_token_here",
    studio = true,
})

Все опции Baseplate.start(options)

Плейтесты в Studio и живые данные

Сессии, записанные в Roblox Studio (studio = true), помечаются на сервере как тестовые. Они скрыты на всех графиках по умолчанию, поэтому ваши плейтесты никогда не испортят статистику удержания, выручки или причин ухода. Чтобы проверить их во время отладки, нажмите переключатель Studio в шапке кабинета.

Что собирается автоматически

Сразу после вызова Baseplate.start — без единой дополнительной строчки кода — вы получаете:

Справочник API (все вызовы необязательны)

Вызывайте эти функции из любого серверного Script после Baseplate.start. Каждый метод защищён внутренним pcall и никогда не вызовет ошибку в вашем коде.

Baseplate.event(player, "QuestComplete", {
    quest = "FindTheKey",
    seconds = 42,
    hard_mode = true,
})

-- Server-wide event (no player):
Baseplate.event(nil, "BossSpawned", { boss = "Dragon", level = 5 })

Baseplate.step(player, "1_Spawned")
Baseplate.step(player, "2_OpenedShop")
Baseplate.step(player, "3_BoughtStarterSword")
Baseplate.step(player, "4_EnteredFirstDungeon")

Baseplate.tutorial(player, 1) -- started step 1
Baseplate.tutorial(player, 2) -- reached step 2
Baseplate.tutorial(player, 0) -- finished!

Baseplate.currency(player, "Coins", 100, "QuestReward")
Baseplate.currency(player, "Coins", -50, "BuySword")
Baseplate.currency(player, "Gems", 5, "DailyBonus")

local MarketplaceService = game:GetService("MarketplaceService")

MarketplaceService.ProcessReceipt = function(receiptInfo)
    -- your code that grants the item to the player...

    Baseplate.receipt(receiptInfo)
    return Enum.ProductPurchaseDecision.PurchaseGranted
end

-- 50 / 50 split:
local group = Baseplate.variant(player, "starter_pack", { "control", "cheaper" })
if group == "cheaper" then
    -- show the 49 Robux price
else
    -- show the 99 Robux price
end

-- Custom weights (80% / 20%):
local layout = Baseplate.variant(player, "shop_layout", { old = 80, new = 20 })

-- After DataStore profile is ready and character is spawned:
Baseplate.loaded(player)

Baseplate.mark(player, "OpenedShop")
Baseplate.mark(player, "StartedBossFight")

Baseplate.start({
    token = HttpService:GetSecret("baseplate_token"),
    deaths = "manual",
})

-- Inside your combat / health system:
Baseplate.death(player, "Lava")
Baseplate.death(player, "SkeletonKing")

Baseplate.kick(player, "AFK timeout")

print(Baseplate.status())
-- { started = true, queued = 3, dropped = 0, sent = 4, lastStatus = 202 }

Как работают причины ухода (14 правил)

При выходе игрока Baseplate проверяет сигналы сессии сверху вниз — первое сработавшее правило определяет причину ухода:

Ключи и доступ команды

• Привязка к Universe ID: при первой живой пачке из Roblox игра автоматически привязывается к вашему game.GameId, поэтому чужой плейс не сможет слать события по вашему токену.
• Перевыпуск токенов: в разделе Настройки → Ключи можно создать новый токен и отозвать старый в один клик (в БД хранится только SHA-256 хеш).
• Команда: приглашайте коллег по одноразовой ссылке с ролью Member или Viewer (только чтение).

Оповещения в Discord и Telegram

В разделе Настройки → Оповещения подключите вебхук Discord или Telegram-бота. Проверка выполняется каждые 5 минут с паузой 2 часа между повторными срабатываниями:

Влияние обновлений

Каждая сессия и событие помечаются номером game.PlaceVersion. На вкладке Обновления Baseplate автоматически сравнивает каждую версию с предыдущей по 8 метрикам на игрока (время в игре, длина сессии, доля отскоков, ошибки на 100 сессий, FPS, конверсия, Robux на игрока и удержание D1).

«Почему изменилось»

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

Заметки на графиках и выгрузка CSV

Добавляйте заметки (релиз, промокод, реклама, событие) прямо под графиком Обзора, чтобы видеть показатели за 24 часа до и после отметки. Каждая таблица и график поддерживают выгрузку в CSV.

Данные и приватность

• Что мы храним: в рамках вашей игры сохраняются UserId, ник и DisplayName (зашифрованные AES-256-GCM в БД), страна, устройство, FPS/пинг, длительность сессии, причина ухода, покупки и ваши кастомные события.
• Чего мы никогда не собираем: чат, личные сообщения, голос, пароли, IP-адреса игроков, куки .ROBLOSECURITY и любые данные вне вашей игры. Мы никогда не связываем профили игроков между разными играми.
• Право на удаление (Right to Erasure): в разделе Настройки → Приватность введите любой Roblox UserId или подключите вебхук Roblox Right to Erasure для мгновенного удаления всех данных игрока.

Сроки хранения данных

Лимиты и бюджет HTTP

• Бюджет HttpService: не более 6 HTTP-запросов в минуту с одного сервера Roblox (~1,2% от лимита Roblox в 500 запросов/мин): 4 лёгких пинга присутствия + 1–2 пачки событий.
• Размер пачки: до 500 событий или 240 КБ за запрос; кольцевая очередь в памяти хранит до 6 000 строк.
• Кастомные поля: до 16 полей в событии; ключи — snake_case до 32 символов; строковые значения — до 200 символов.

Решение частых проблем

ИИ и CLI (MCP)

Baseplate включает официальный CLI и MCP-сервер (24 инструмента только для чтения), чтобы вы могли спрашивать Claude Desktop, Claude Code, Cursor, ChatGPT или терминал о своей игре и публичных чартах Roblox. Откройте ИИ и CLI, чтобы выпустить токен bpt_agent_....

npx baseplate login
npx baseplate games
npx baseplate live <gameId>
npx baseplate overview <gameId> --range 7d

HTTP-приём (для своих клиентов)

Модуль Luau отправляет сжатые JSON-пачки на POST /v1/ingest с заголовком Authorization: Bearer bpt_... и лёгкие пинги присутствия на POST /v1/presence каждые 15 секунд:

{
  "v": 1,
  "sdk": "0.10.3",
  "game": 1234567890,
  "place": 9876543210,
  "job": "server-job-uuid",
  "ver": 42,
  "seq": 1,
  "dropped": 0,
  "ids": {
    "player_token": "{\"u\":123456,\"n\":\"Player1\",\"d\":\"Player\"}"
  },
  "rows": [
    {
      "t": 1761560000,
      "e": "session_start",
      "p": "player_token",
      "s": "session_id",
      "q": 1,
      "v": 42,
      "j": "job8char",
      "n": 12,
      "d": { "is_new": true, "source": "friend", "country": "US" }
    }
  ]
}