К основному содержанию
скилл CX Codex

roblox-analytics-liveops — скилл для Claude Code

Скилл roblox-analytics-liveops для Claude Code настраивает игровую аналитику, воронки, экономику и live-ops на Lua. Включается при добавлении событий, A/B-тестов или начислении наград.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-analytics-liveops -a claude-code
Открыть на GitHub

Что делает roblox-analytics-liveops

Скилл добавляет в проект готовые шаблоны на Lua для работы с AnalyticsService, ConfigService и BadgeService на стороне сервера Roblox. Код собирает данные экономики, шаги онбординга, кастомные события и выдаёт бейджи через защищенные вызовы с pcall. Динамические конфигурации подтягиваются из Creator Hub без перепубликации игры, а эксперименты и уведомления настраиваются через Open Cloud.

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

Какие задачи решает

  • собрать статистику экономики и воронки онбординга
  • настроить A/B-эксперименты и динамические конфиги игры
  • выдавать бейджи за достижения по коду сервера
  • отправлять уведомления игрокам через Open Cloud
  • реализовать ежедневные награды и сезонные пропуски

Примеры запросов агенту

  • Добавь логирование экономики через AnalyticsService для покупки предметов в магазине
  • Настрой получение конфигов с сервера без перепубликации плейса
  • Реализуй выдачу бейджей игроку на серверной стороне

Как установить roblox-analytics-liveops

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-analytics-liveops -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-analytics-liveops/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-analytics-liveops/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-analytics-liveops

Как установить roblox-analytics-liveops в Claude Code?

Выполните команду npx skills add EL4CTEO/roblox-skills --skill roblox-analytics-liveops -a claude-code, а затем обратитесь к файлу конфигурации ~/.claude/skills/roblox-analytics-liveops/SKILL.md.

Что делает скилл roblox-analytics-liveops?

Он помогает внедрять серверную аналитику, экономические события, динамические настройки ConfigService, эксперименты, бейджи и игровые уведомления для проектов на платформе Roblox.

Что нужно для работы скилла?

Пакет рассчитан на серверную разработку на Lua под Roblox с доступом к Creator Hub и Open Cloud для удаленных конфигураций и уведомлений.

Исходный текст

SKILL.md · MIT
---
name: roblox-analytics-liveops
description: Analytics and live ops - AnalyticsService economy/funnel/onboarding/progression/custom events, player segments, experience configs via ConfigService, A/B experiments, badges, experience notifications, timed events, daily rewards, season passes. Use when instrumenting a game, tuning economy or onboarding, running A/B tests or feature flags, or planning live events and re-engagement.
---

# Analytics and live operations

## Analytics events (server-side, `AnalyticsService`)

Standard events feed the Creator Hub dashboards automatically (economy, funnels, progression,
custom). The `Fire*` methods are deprecated; use the `Log*` family.

```luau
--!strict
local AnalyticsService = game:GetService("AnalyticsService")

local Analytics = {}

-- Currency sources and sinks → Economy dashboard.
function Analytics.coinsEarned(player: Player, amount: number, balance: number, source: string)
	AnalyticsService:LogEconomyEvent(
		player,
		Enum.AnalyticsEconomyFlowType.Source,
		"Coins", -- currency type
		amount,
		balance, -- ending balance
		Enum.AnalyticsEconomyTransactionType.Gameplay.Name, -- or a custom string like "QuestReward"
		source -- item SKU / source id
	)
end

function Analytics.itemBought(player: Player, price: number, balance: number, itemSku: string)
	AnalyticsService:LogEconomyEvent(
		player,
		Enum.AnalyticsEconomyFlowType.Sink,
		"Coins",
		price,
		balance,
		Enum.AnalyticsEconomyTransactionType.Shop.Name,
		itemSku
	)
end

-- First-session tutorial funnel (steps must be sequential, 1-based).
function Analytics.onboarding(player: Player, step: number, stepName: string)
	AnalyticsService:LogOnboardingFunnelStepEvent(player, step, stepName)
end

-- Recurring funnels (e.g. shop purchase flow); share a session id per attempt.
function Analytics.shopFunnel(player: Player, sessionId: string, step: number, stepName: string)
	AnalyticsService:LogFunnelStepEvent(player, "ShopPurchase", sessionId, step, stepName)
end

-- Level progression.
function Analytics.levelStarted(player: Player, level: number)
	AnalyticsService:LogProgressionStartEvent(player, "MainPath", level, `Level{level}`)
end
function Analytics.levelCompleted(player: Player, level: number)
	AnalyticsService:LogProgressionCompleteEvent(player, "MainPath", level, `Level{level}`)
end

-- Anything else: numeric custom events, sliced by up to 3 custom fields.
function Analytics.bossKilled(player: Player, bossId: string, seconds: number)
	AnalyticsService:LogCustomEvent(player, "BossKillTime", seconds, {
		[Enum.AnalyticsCustomFieldKeys.CustomField01.Name] = bossId,
	})
end

return Analytics
```

Guidelines:
- Log from the **server** (trustworthy, and required by these APIs). Keep event names and custom-field
  values low-cardinality (IDs of categories, not free text or user IDs).
- Economy events need accurate `endingBalance`; log every source and sink or the dashboard misleads.
- Design funnels before building features (onboarding steps, shop flow, first purchase).
- `AnalyticsService:GetPlayerSegmentsAsync(player)` returns segment info (payer status, account age in
  your game, ...) at runtime to tailor onboarding and offers — `pcall` it.

## Experience configs (live values without republishing)

Create configs in Creator Hub (or Open Cloud) — balance numbers, feature flags, event toggles — and read them
on the server with `ConfigService`. Published changes arrive in running servers.

```luau
--!strict
local ConfigService = game:GetService("ConfigService")

local ok, snapshot = pcall(function()
	return ConfigService:GetConfigAsync()
end)

local function get(key: string, default: any): any
	if not ok then
		return default
	end
	local value = snapshot:GetValue(key)
	return if value == nil then default else value
end

local bossHealth = get("bossHealth", 500)
print("boss health", bossHealth)

if ok then
	snapshot.UpdateAvailable:Connect(function()
		snapshot:Refresh() -- apply newly published values at a safe moment (e.g. between rounds)
		print("new boss health", get("bossHealth", 500))
	end)
end
```

- Always code a default: configs may fail to load.
- **Experiments / targeted configs** evaluate per player: use `ConfigService:GetConfigForPlayerAsync(player)`
  (`GetConfigAsync` ignores targeting). Experiments run 14–60 days, up to two variants plus control; pick a
  goal metric and respect the minimum detectable effect. Manage via Creator Hub or the Open Cloud
  experimentation API (`roblox-open-cloud`). **Early Harm Detection** shows near-real-time playtime, payer
  conversion, and ARPU (every 5 min) for the first 24 h — stop a harmful variant early.
- Studio testing: `ConfigService:SetTestingValue(key, value)` / `ClearTestingValue`.

## Badges

`BadgeService:AwardBadgeAsync(userId, badgeId)` (server, `pcall`; skip if `UserHasBadgeAsync` or
`CheckUserBadgesAsync` already says owned). `AwardBadge`/`UserHasBadge` are deprecated. Badges are
great onboarding and progression milestones and show on players' profiles.

## Experience notifications (re-engagement)

1. Ask players to opt in at a meaningful moment: `ExperienceNotificationService:CanPromptOptInAsync()` then
   `PromptOptIn()` (client).
2. Create notification strings in Creator Hub; send from your backend via Open Cloud
   `POST /cloud/v2/users/{userId}/notifications` (e.g. "your crops are ready", "event starts now").
   Notifications are rate-limited and moderated; send ones players value.

## Live-ops patterns

- **Timed events**: schedule with UTC timestamps in a config (`eventStart`, `eventEnd`); compare with
  `os.time()` on the server; broadcast state via attributes; clients show countdowns from
  `workspace:GetServerTimeNow()`.
- **Season pass / rotating shops**: rotation seed = `math.floor(os.time() / 86400)` for daily shops; store
  claimed rewards per season id in player data.
- **Daily rewards/streaks**: store `lastClaimDay` (UTC day number) and streak count; grant on the server.
- Ship content behind config flags, validate with a small rollout/experiment, then roll out to 100%.
- Watch Creator Hub dashboards: retention (D1/D7/D30), session length, conversion, ARPPU, funnels, and
  performance (crash rate, FPS, memory) after every release. Discovery impressions/plays use a new
  measurement pipeline from Oct 12, 2026 (higher counts, slightly lower play-through rate) — don't read the
  jump as a real change.
- **Before launch**: invite up to 10 friends or group members as early testers from the publish flow.
- **Player Support** (early access, age-checked 13+): add an in-game "report a problem" button that calls
  `SocialService:PromptFeedbackSubmissionAsync({ FeedbackType = Enum.FeedbackType.PlayerSupport })`
  (client, `pcall`); reports arrive with device info and screenshots in Creator Hub → Audience → Player Support.

## Related skills

`roblox-monetization` (offers, pricing), `roblox-data-stores` (streaks, season data),
`roblox-open-cloud` (configs/experiments/notifications APIs), `roblox-game-systems`.

© EL4CTEO · MIT · EL4CTEO/roblox-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
roblox-analytics TabooHarmony Скилл roblox-analytics для Claude Code и Codex по аналитике Roblox: работа с AnalyticsService, событиями, экономикой, воронками и лимитами. Помогает найти, где игроки отваливаются, и правильно инструментировать фичи. CX Codex +1 3 200установок roblox-luau gamedev-skills Скилл roblox-luau для Claude Code помогает писать Luau-код для Roblox и проверять его статическими инструментами. Подключается, когда не запускается LocalScript, клиент получает nil после входа или пора заменить wait(). CX Codex +1 12 300установок roblox-ui gamedev-skills Скилл roblox-ui для Claude Code помогает проектировать интерфейсы Roblox с учётом экранов телефонов и геймпадов. CX Codex +1 9 900установок roblox-performance sentinelcore Скилл roblox-performance для ИИ-агентов, который помогает находить узкие места в Roblox-игре: просадки FPS, лишние draw calls, тяжёлые циклы. CX Codex +1 911установок roblox-luau-types TabooHarmony Скилл roblox-luau-types для аннотаций типов Luau: дженерики, юнионы, сужение типов, строгий режим, экспорт типов из модулей. Пригодится при миграции на --!strict. CX Codex +1 3 400установок roblox-datastores sentinelcore Скилл roblox-datastores для Claude Code с референсом по DataStoreService в Roblox. Включается, когда в скрипте нужно сохранить статистику игрока, инвентарь или собрать таблицу лидеров. CX Codex +1 680установок

Из того же набора22

Весь набор →
roblox-physics Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок roblox-teleport-matchmaking Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService. CX Codex +1 1 200установок roblox-input Скилл roblox-input для Claude Code настраивает ввод игрока и камеры в Roblox. Он подключается к задачам с клавишами, способностями, транспортом, сенсорными кнопками или собственной камерой. CX Codex +1 1 200установок roblox-audio Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится. CX Codex +1 1 200установок roblox-networking Скилл roblox-networking для Claude Code управляет сетевым взаимодействием клиента и сервера на Roblox, помогая настраивать RemoteEvent, RemoteFunction и оптимизировать трафик. CX Codex +1 1 200установок roblox-data-stores Скилл roblox-data-stores для Claude Code помогает проектировать сохранение данных игроков и облачные сервисы Roblox. Включается при настройке таблиц лидеров, очередей или устранении потери и дублирования данных. CX Codex +1 1 200установок roblox-studio-mcp Скилл Claude Code подключает ИИ-агент к встроенному серверу Roblox Studio через протокол MCP для проверки и правки игровых миров. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой