roblox-testing · el4cteo — скилл для Claude Code: тесты Roblox
Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI.
MIT 1 300 установок ★ 131 обновлён 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/roblox-testing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/roblox-testing/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a codex2Вручную: положить файлы
.agents/skills/roblox-testing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a cursor2Вручную: положить файлы
.cursor/skills/roblox-testing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-testing2Вручную: положить файлы
.github/skills/roblox-testing/SKILL.md1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a gemini-cli2Командой платформы
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-testingВручную: положить файлы
.devin/skills/roblox-testing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-testing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.