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

roblox-performance · el4cteo — скилл для Claude Code

Скилл roblox-performance для Claude Code, который диагностирует производительность игр в Roblox, ищет утечки памяти и устраняет просадки кадров. Включается при лагах, падении FPS, зависаниях и высоком пинге.

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

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

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

Диагностирует узкие места в серверных расчетах, графике и сети, используя встроенные инструменты вроде MicroProfiler, Script Profiler и Scene Analysis. Скрипты размечаются через функцию debug.setmemorycategory и профилируются блоками debug.profilebegin. Оптимизирует горячие пути в Luau, настраивает параллельные вычисления через Actor и обрабатывает событие game.ServerLowMemoryWarning при нехватке памяти на сервере.

Клиентская часть ориентирована на стабильные 60 FPS на средних телефонах и удержание памяти в пределах 1–1.5 ГБ на слабых устройствах. Набор инструментов включает Developer Console по клавише F9, MicroProfiler по сочетанию Ctrl+Alt+F6 и статистику производительности по Ctrl+Alt+F7.

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

  • найти утечки памяти и неочищенные экземпляры
  • устранить просадки FPS на клиентских устройствах
  • снизить нагрузку от циклов в Luau
  • проверить сетевой трафик и репликацию
  • настроить параллельные вычисления с Actor

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

  • Продиагностируй просадки FPS и найди тяжелые скрипты
  • Найди утечку памяти в Luau-хипе
  • Оптимизируй цикл для обработки событий в реальном времени

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о roblox-performance

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

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

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

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

Какие инструменты диагностики упоминаются?

Developer Console, MicroProfiler, Script Profiler, Scene Analysis, Luau heap snapshots и симулятор сети.

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

SKILL.md · MIT
---
name: roblox-performance
description: Performance diagnosis and optimization - MicroProfiler, Script Profiler, Developer Console, Scene Analysis, Luau heap and memory categories, memory leaks, network/replication cost, rendering and physics cost, streaming, native codegen, Parallel Luau with Actors. Use when a game lags, stutters, drops FPS, crashes on mobile, has high ping, or before optimizing hot code.
---

# Roblox performance

**Measure before optimizing.** Identify whether the bottleneck is server compute, client compute
(CPU/GPU), memory, network, or load time, then use the matching tool.

## Tools

| Tool | Open | Use for |
| --- | --- | --- |
| Developer Console | F9 (in game) | Errors, server/client memory by category, network, script activity. Works in live servers. |
| MicroProfiler | Ctrl+Alt+F6 (⌘⌥F6); Dev Console for server | Per-frame timing; spikes; dump a frame for detail. |
| Script Profiler | Studio / Dev Console | Which functions consume Luau time (sampling). |
| Luau heap snapshots | Dev Console → Memory → Luau Heap | What tables/closures/instances are held and by what (leaks). |
| Scene Analysis | Studio | Script memory, unparented instances (leaks), instance composition, audio/animation memory, triangles. Also `SceneAnalysisService` via Studio MCP. |
| Performance Stats / Debug Stats | Ctrl+Alt+F7 / Shift+Ctrl+F1–F5 | Live CPU/GPU/memory/network overlays. |
| Network Simulator | Studio Device Simulator toolbar | Test with latency, jitter, packet loss (3G/4G/Wi-Fi profiles). |
| Performance dashboard | Creator Hub | Live aggregate FPS, server heartbeat, memory, crash rates by device. |

Label your own code in the MicroProfiler and memory views:

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

debug.setmemorycategory("EnemyAI") -- memory allocated by this thread is attributed to "EnemyAI"

RunService.Heartbeat:Connect(function(_deltaTime)
	debug.profilebegin("EnemyAI.think") -- shows as a labeled bar in the MicroProfiler
	-- ... work ...
	debug.profileend()
end)
```

## Targets

- Client: 60 FPS on mid-range phones (≈16.6 ms/frame); many players are on low-end Android.
- Server: heartbeat near 60 Hz; `Stats` (`workspace:GetRealPhysicsFPS()`, Dev Console Server Stats).
- Memory: mobile clients crash from OOM first. Keep client memory well under ~1–1.5 GB on low-end
  devices; watch `PlaceMemory`, `LuaHeap`, `GraphicsTexture`, `Sounds`, `Animation` categories.
- Server OOM: `game.ServerLowMemoryWarning` fires (server only, live servers and Team Test, not Studio
  playtests) when memory leaves normal levels, then every 60 s while it stays high. Use it to free memory
  fast (destroy debris/effects, pause spawning, unload empty map areas) and log it; it frees nothing itself.

```luau
--!strict
game.ServerLowMemoryWarning:Connect(function()
	warn("Server memory high: cleaning up")
	-- e.g. destroy temporary effects, pause NPC/item spawners until memory recovers
end)
```

## Most common problems → fixes

| Symptom | Usual cause | Fix |
| --- | --- | --- |
| Memory grows over time | Leaked connections, tables keyed by players/instances, destroyed-but-referenced instances, unparented instances | Disconnect/clean up per player & per character; clear tables on `PlayerRemoving`; use Scene Analysis "unparented instances" and heap snapshots. |
| Server lag with many players | Per-player loops each frame, `while true do task.wait() end` loops, heavy remote handlers, physics of many unanchored parts | Event-driven code, one scheduler loop, throttled think rates, anchor static parts, server-own fewer assemblies. |
| Client FPS drops | Too many parts/draw calls, shadows from many lights, transparency/particles overdraw, per-frame UI updates | Merge/instance meshes, `CastShadow = false` on small parts, fewer shadowed lights, limit particles, update UI on change only. |
| Spikes every N seconds | Autosave/GC bursts, synchronized loops across players, big `Clone()`s | Stagger with random offsets; pool objects; spread work across frames. |
| High ping / rubber banding | Remote spam, large payloads, replicating many property changes | Batch, delta-compress, throttle; tween on clients; see `roblox-networking`. |
| Long join times | Huge place, many unique assets, no streaming | Streaming, SLIM LOD, fewer unique meshes/textures, `ContentProvider:PreloadAsync` only for critical assets. |

## Luau hot paths

- Cache services, instances, and `RaycastParams` outside loops; avoid `FindFirstChild`/`GetDescendants`
  per frame. Replace `GetDescendants` scans with tags (`CollectionService`) or maintained sets.
- Use `deltaTime` from `Heartbeat`/`PreSimulation` rather than `task.wait()` loops for per-frame work.
- Avoid creating closures/tables per frame in hot loops; reuse buffers with `table.clear`.
- `--!native` (whole script) or `@native` (per function) for math-heavy code; typed parameters help
  the native compiler. Don't blanket-enable: compile time and a global native-code memory limit.
- `--!optimize 2` is how Roblox compiles live games already; don't rely on Studio timings for micro-benchmarks.

## Rendering and assets

- Parts: fewer, larger parts; `MeshPart`s with shared `MeshId` are instanced (cheap); unions (`PartOperation`)
  can be expensive — check triangle counts in Scene Analysis.
- `RenderFidelity = Automatic`/`Performance` for detailed meshes; `CollisionFidelity = Box`/`Hull` for
  decorative meshes; `CanCollide/CanQuery/CanTouch = false` for pure decoration.
- Lights: limit shadow-casting `PointLight`/`SpotLight`/`SurfaceLight`; limit `ParticleEmitter.Rate`
  and particle size (overdraw); `Beam`/`Trail` counts.
- Textures/images: reuse, keep resolutions reasonable (1024² max for most); `SurfaceAppearance` sparingly.
- Enable streaming (`roblox-architecture`), `Model.LevelOfDetail = SLIM` for static models, and let
  `StreamOutBehavior = Opportunistic` free memory.

## Physics

- Anchor everything that doesn't need to move. Welded decorative parts on moving assemblies add cost.
- Fewer, simpler collisions (`CollisionFidelity`, collision groups to skip pairs); `CanTouch = false`
  where `Touched` isn't needed.
- Avoid setting `CFrame` of unanchored parts every frame; use constraints or anchor + CFrame.
- `workspace:BulkMoveTo(parts, cframes, Enum.BulkMoveMode.FireCFrameChanged)` to move many anchored parts.
- Adaptive timestepping (`PhysicsSteppingMethod = Adaptive`) reduces physics CPU.

## Parallel Luau

Scripts under different `Actor` instances can run in parallel:

```luau
--!strict
-- Script parented under an Actor (one Actor per logical unit, e.g. per NPC group or chunk).
local RunService = game:GetService("RunService")

local results: { number } = {}

RunService.Heartbeat:ConnectParallel(function(_deltaTime)
	-- Parallel phase: read-only access to most instances, pure computation, thread-safe APIs (raycasts).
	for i = 1, 100 do
		results[i] = math.noise(i / 10, os.clock())
	end
	task.synchronize()
	-- Serial phase: write to instances, fire events, call thread-unsafe APIs.
end)
```

- `task.desynchronize()` / `task.synchronize()` switch phases; `ConnectParallel` starts in parallel.
- Scripts in the **same** Actor run serially relative to each other: split work across many Actors.
- Can't `require` or modify most instances while desynchronized. Communicate with `Actor:SendMessage` /
  `BindToMessageParallel` or `SharedTable` (`SharedTableRegistry`).
- Good fits: raycast validation, procedural generation, pathfinding-adjacent math, large simulations.
  Bad fits: tiny tasks (sync overhead), instance-heavy work.

Profiling walkthrough and memory-leak hunting: [references/profiling.md](references/profiling.md).

## Related skills

`roblox-architecture` (streaming), `roblox-networking` (bandwidth), `roblox-physics`, `roblox-npc-ai`,
`roblox-studio-mcp` (Roblox's `rbx-perf-profiling`/scene analysis via MCP).

© EL4CTEO · MIT · EL4CTEO/roblox-skills

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →

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

roblox-performance TabooHarmony Скилл roblox-performance задаёт правила и метрики профилирования игр в Roblox. Он помогает агенту находить просадки кадров, серверный лаг и утечки памяти. CX Codex +1 3 600установок roblox-performance sentinelcore Скилл roblox-performance для ИИ-агентов, который помогает находить узкие места в Roblox-игре: просадки FPS, лишние draw calls, тяжёлые циклы. CX Codex +1 911установок scenario-roblox-performance scenario-labs Скилл scenario-roblox-performance для Claude Code и Cursor отслеживает производительность игр на Roblox, диагностирует фризы, падения FPS и утечки памяти. CX Codex +1 363установок roblox-performance-audit LihFolk Скилл roblox-performance-audit для Claude Code проводит профилирование плейсов Roblox и устраняет просадки кадров, утечки памяти и сетевые лаги на основе точных замеров. CX Codex +1 ★ 98звёзд репо roblox-testing nonlooped Скилл roblox-testing для Claude Code собирает инструкции по отладке, профилированию и модульному тестированию плейсов в Roblox Studio с TestEZ и Luau. CX Codex +1 560установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-physics gamedev-skills Скилл roblox-physics для Claude Code настраивает физику и пространственные запросы в Roblox, включая сборки, ограничения и владение сетью. CX Codex +1 9 100установок roblox-building TabooHarmony Скилл roblox-building для сборки геометрии, карт и пропов в Roblox Studio через MCP или Luau. Помогает не угадывать координаты и доводить модель до проверяемого результата. CX Codex +1 4 200установок

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

Весь набор →
roblox-world-building Скилл roblox-world-building для Claude Code и других платформ, автоматизирующий создание 3D-миров и игровых механик в Roblox. Запускается при генерации окружения, уровней и визуальных эффектов. CX Codex +1 1 400установок roblox-code-review Скилл roblox-code-review для Claude Code проверяет Roblox-код на уязвимости, потерю данных и ошибки жизненного цикла. Запускается при ревью PR или скрипта, аудите игры и обновлении устаревшего кода. CX Codex +1 1 300установок roblox-security Скилл roblox-security для Claude Code помогает проектировать серверную защиту игр на Roblox против эксплойтов. Включается при написании серверных обработчиков, проверке репликации, рейтов и механик боя. CX Codex +1 1 300установок 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-testing Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI. CX Codex +1 1 300установок

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

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