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

roblox-testing · el4cteo — скилл для Claude Code: тесты Roblox

Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI.

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

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

Что делает roblox-testing

Скилл показывает, как готовить код Roblox к тестированию: выносить игровую логику в чистые ModuleScripts и передавать сервисам зависимости, чтобы подменять их тестовыми объектами. Для тестов описаны Jest Lua и устаревший TestEZ, конфигурация .spec и запуск через runCLI.

Тесты можно запускать в Studio, через Studio MCP, run-in-roblox, Open Cloud Luau Execution или Lune; также есть сценарии многопользовательской проверки и QA-чек-лист перед выпуском. Для локального запуска Jest Lua 3 в Studio нужен флаг FFlagEnableLoadModule = true в ClientAppSettings.json. run-in-roblox требует установленный Studio, а облачный запуск — API-ключ с областью universe.place.luau-execution-session:write.

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

  • покрыть тестами игровую логику в ModuleScripts
  • подменить DataStore или другие сервисы тестовыми объектами
  • настроить запуск Jest Lua в Studio или CI
  • проверить сетевую игру с несколькими клиентами
  • пройти QA-проверки перед выпуском изменения

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

  • Добавь тесты Jest Lua для логики инвентаря в Inventory.spec.luau.
  • Настрой запуск тестов Roblox в CI через Open Cloud Luau Execution.
  • Составь QA-чек-лист для новой игровой функции и проверь сценарии с двумя клиентами.

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

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a claude-code

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

~/.claude/skills/roblox-testing/SKILL.md

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

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

Вопросы о roblox-testing

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

Выполни npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a claude-code. Файл скилла находится в ~/.claude/skills/roblox-testing/SKILL.md.

Что делает roblox-testing?

Скилл объясняет, как сделать код Roblox тестируемым, запускать тесты через Jest Lua и проверять игровые изменения в Studio, CI или многопользовательском режиме.

Что нужно для работы roblox-testing?

Для локального запуска Jest Lua 3 в Studio нужен флаг FFlagEnableLoadModule = true в ClientAppSettings.json. run-in-roblox требует установленный Studio, а Open Cloud Luau Execution — API-ключ с областью universe.place.luau-execution-session:write.

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

SKILL.md · MIT
---
name: roblox-testing
description: Testing Roblox code - testable modules with dependency injection, Jest Lua (runCLI, .spec files), legacy TestEZ, running tests in Studio, via Studio MCP, run-in-roblox, or CI with Open Cloud Luau Execution, Lune for pure Luau, multi-client playtests, QA checklist. Use when adding tests, setting up a test runner or CI, or verifying a gameplay change works.
---

# Testing Roblox games

## Make code testable first

- Keep game rules in **pure ModuleScripts** (inputs → outputs, no services, no yields): damage formulas,
  inventory operations, shop pricing, state machines, serialization, validation. These are trivially testable.
- Services take their dependencies as parameters (**dependency injection**) so tests can pass fakes
  instead of real DataStores, remotes, or `Players`.

```luau
--!strict
-- ReplicatedStorage/Shared/Inventory.luau — pure logic, no Roblox services.
export type Inventory = { [string]: number }

local Inventory = {}

function Inventory.add(inventory: Inventory, itemId: string, amount: number, maxStack: number): (boolean, string?)
	if amount <= 0 or amount ~= math.floor(amount) then
		return false, "invalid amount"
	end
	local current = inventory[itemId] or 0
	if current + amount > maxStack then
		return false, "stack full"
	end
	inventory[itemId] = current + amount
	return true, nil
end

return Inventory
```

```luau
--!strict
-- A service that receives its data store, so tests can inject an in-memory fake.
type Store = {
	GetAsync: (self: Store, key: string) -> any,
	SetAsync: (self: Store, key: string, value: any) -> (),
}

local function newCurrencyService(store: Store)
	local service = {}
	function service.award(userId: number, amount: number): number
		local key = `User_{userId}`
		local balance = (store:GetAsync(key) or 0) + amount
		store:SetAsync(key, balance)
		return balance
	end
	return service
end

-- In tests: a fake store backed by a table.
local fakeData: { [string]: any } = {}
local fakeStore: Store = {
	GetAsync = function(_self, key)
		return fakeData[key]
	end,
	SetAsync = function(_self, key, value)
		fakeData[key] = value
	end,
}
print(newCurrencyService(fakeStore).award(1, 50))

return newCurrencyService
```

## Jest Lua (recommended framework)

Port of Jest (`describe`/`it`/`expect`, mocks, snapshots). TestEZ is legacy; Jest Lua 3 includes a
migration guide.

```toml
# wally.toml
[dev-dependencies]
Jest = "jsdotlua/[email protected]"
JestGlobals = "jsdotlua/[email protected]"
```

```luau
-- src/shared/Inventory.spec.luau
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local JestGlobals = require(ReplicatedStorage.DevPackages.JestGlobals)
local Inventory = require(ReplicatedStorage.Shared.Inventory)

local describe, it, expect = JestGlobals.describe, JestGlobals.it, JestGlobals.expect

describe("Inventory.add", function()
	it("stacks items up to the limit", function()
		local inventory = {}
		expect(Inventory.add(inventory, "Apple", 3, 5)).toBe(true)
		expect(inventory.Apple).toBe(3)
		local ok, reason = Inventory.add(inventory, "Apple", 3, 5)
		expect(ok).toBe(false)
		expect(reason).toBe("stack full")
	end)

	it("rejects fractional amounts", function()
		expect(Inventory.add({}, "Apple", 0.5, 5)).toBe(false)
	end)
end)
```

- Put a `jest.config.luau` (`return { testMatch = { "**/*.spec" } }`) in each test root.
- Runner script (Studio command bar, a test place Script, or cloud task):
  `require(ReplicatedStorage.DevPackages.Jest).runCLI(root, { ci = true }, { root }):awaitStatus()` →
  inspect `result.results.numFailedTests`.
- Jest Lua 3 needs the fast flag `FFlagEnableLoadModule = true` in Studio's `ClientAppSettings.json`
  when run locally.
- Map `DevPackages` into the DataModel only for test builds (separate Rojo project, e.g. `test.project.json`).

## Where tests run

| Runner | Use |
| --- | --- |
| Studio (command bar / test Script) | Local development. |
| Studio MCP (`execute_luau`, `start_stop_play`, `get_console_output`) | Agents running tests and playtests against the open place — see `roblox-studio-mcp`. |
| `run-in-roblox` | CLI that opens Studio, runs a script, pipes output (needs Studio installed; local/Windows/mac CI runners). |
| **Open Cloud Luau Execution** | Headless CI: runs a script in a real Roblox server for a published place version. |
| Lune | Pure-Luau modules with no Roblox API dependencies (fast, runs anywhere). |

Open Cloud Luau Execution flow (details and a script: [references/cloud-test-runner.md](references/cloud-test-runner.md)):
1. Build the test place (`rojo build test.project.json -o test.rbxl`) and upload it as a **Saved** version
   of a dedicated test place.
2. `POST /cloud/v2/universes/{u}/places/{p}/versions/{v}/luau-execution-session-tasks` with `{ "script": ... }`
   (API key scope `universe.place.luau-execution-session:write`; rate limit ≈ 5 tasks/min per key owner).
3. Poll the task `path` until `state` is `COMPLETE`/`FAILED`; read `output.results` and `.../logs`.

## Playtesting in Studio

- **Test** tab: Play (you + server), Run (server only, no character), **Clients and Servers** with 2+
  players to test replication, trading, and PvP. Most multiplayer bugs only appear with ≥ 2 clients.
- **Device Simulator** toolbar (Test → Device Simulator, top of the viewport): switch phone/tablet/console
  mid-playtest, with touch-control hints; its **Network Simulator** applies 3G/4G/Wi-Fi/wired or custom
  inbound/outbound latency, jitter, and packet loss to test lag compensation and loading/retry UX.
  Controller Emulator for gamepad input.
- Streaming: test with `StreamingTargetRadius = 64`.
- DataStores in Studio: enable API access and use a separate test universe or data store names.

## QA checklist before shipping a feature

- [ ] Works for a player who joins **after** the feature started (late joiners), and after respawn.
- [ ] Works with 2+ clients; server state is authoritative; UI updates on all clients.
- [ ] Player leaving mid-action (trade, purchase, round) leaves no broken state or leaked tables.
- [ ] Remotes rejected when spammed or sent malformed arguments.
- [ ] Data saves and reloads (rejoin), including teleports between places.
- [ ] Mobile, gamepad, and keyboard all work; UI readable on a phone.
- [ ] No errors/warnings in Output (server and client).

## Related skills

`roblox-tooling` (CI, Rojo), `roblox-studio-mcp` (agent-driven playtests), `roblox-open-cloud`,
`roblox-code-review`.

© EL4CTEO · MIT · EL4CTEO/roblox-skills

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

Все скиллы по теме «Тесты и QA» →

Сначала — roblox-testing от других авторов.

roblox-testing nonlooped Скилл roblox-testing для Claude Code собирает инструкции по отладке, профилированию и модульному тестированию плейсов в Roblox Studio с TestEZ и Luau. CX Codex +1 560установок scenario-roblox-tooling scenario-labs Скилл scenario-roblox-tooling для Claude Code помогает настраивать пайплайны Roblox, синхронизировать код и запускать тесты вне Studio. CX Codex +1 350установок roblox-studio-workflow gamedev-skills Скилл roblox-studio-workflow для Claude Code и Codex выстраивает безопасный процесс правок в проектах Roblox и Rojo. Запускается при редактировании плейсов .rbxl, работе через Studio MCP и проверке изменений. CX Codex +1 9 300установок scenario-roblox-expert scenario-labs Скилл scenario-roblox-expert для Claude Code помогает создавать, исправлять и проверять проекты в Roblox Studio. Он подключается к задачам с Luau, Rojo, игровыми тестами и управлением Studio через MCP. CX Codex +1 411установок roblox-debugging LihFolk Скилл roblox-debugging для Claude Code направляет поиск багов в Luau от воспроизведения до проверки исправления. Включается при ошибках рассинхронизации, гонках состояний и сбоях физики в Roblox. CX Codex +1 ★ 98звёзд репо roblox-performance-audit LihFolk Скилл roblox-performance-audit для Claude Code проводит профилирование плейсов Roblox и устраняет просадки кадров, утечки памяти и сетевые лаги на основе точных замеров. CX Codex +1 ★ 98звёзд репо roblox-luau gamedev-skills Скилл roblox-luau для Claude Code помогает писать Luau-код для Roblox и проверять его статическими инструментами. Подключается, когда не запускается LocalScript, клиент получает nil после входа или пора заменить wait(). CX Codex +1 12 300установок

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

Весь набор →
roblox-characters-animation Скилл roblox-characters-animation для Claude Code описывает работу с персонажами и анимацией в Roblox. Подключается к задачам про движение, урон, респаун, аватары, оружие и твины. CX Codex +1 1 300установок roblox-game-systems Скилл roblox-game-systems для Claude Code и Codex помогает собирать игровые механики Roblox с серверной валидацией. Включается при создании экономики, раундов, инвентаря, боевой системы или чекпоинтов. CX Codex +1 1 300установок roblox-luau Скилл roblox-luau для Claude Code помогает писать и разбирать скрипты Roblox на Luau. Включается при создании, рефакторинге и объяснении скриптов, исправлении ошибок типов и обновлении старого Lua-кода. CX Codex +1 1 300установок roblox-ui Скилл roblox-ui для Claude Code и Codex формирует адаптивный интерфейс в Roblox. Включается при сборке HUD, инвентарей, магазинов или починке вёрстки под мобильные экраны и консоли. CX Codex +1 1 300установок roblox-open-cloud Скилл roblox-open-cloud для Claude Code помогает работать с Open Cloud API Roblox и HttpService. Включается при создании внешних инструментов, ботов и CI/CD для игр. CX Codex +1 1 200установок roblox-text-chat Скилл roblox-text-chat для Claude Code и Cursor, который настраивает TextChatService, фильтрацию текста и чат в Roblox. Включается при добавлении чата, команд или табличек с текстом игроков. CX Codex +1 1 200установок roblox-monetization Скилл roblox-monetization для Claude Code помогает настраивать монетизацию в Roblox и разбирать сбои покупок. Подключается при работе с магазинами, пропусками, подписками, рекламой и платными случайными предметами. CX Codex +1 1 200установок roblox-physics Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок

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

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