Programming · Analysis
roblox-performance
/roblox-performance
Use when profiling or fixing Roblox performance: low FPS, lag, memory, network load, slow phones, hot paths.
For whom
- Author
- tabooharmony ↗
- Repository
- roblox-brain ↗
- Licence
- MIT
- Last repository change
- 14.10.2026
Assessment and security
100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 8
Deprecation
No signals detected. Repository changed on 14.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when profiling or fixing Roblox performance: low FPS, lag, memory, network load, slow phones, hot paths.
Original author description
Use when profiling or fixing Roblox performance: low FPS, lag, memory, network load, slow phones, hot paths.
How it works
- When to Load
- Quick Reference
Original SKILL.md headings · 47 lines, 297 words
SKILL.md preview
---
name: roblox-performance
description: "Use when profiling or fixing Roblox performance: low FPS, lag, memory, network load, slow phones, hot paths."
when_to_use: "Also when the game stutters, phones overheat or crash, server heartbeat drops, before adding many parts/effects/UI, and when auditing performance before release."
last_reviewed: 2026-10-02
sources:
- https://create.roblox.com/docs/en-us/performance-optimization/microprofiler
- https://create.roblox.com/docs/en-us/reference/engine/libraries/debug
- https://devforum.roblox.com/t/huge-memory-leak-prevention-for-everyone-or-most-people-atleast/3099605
- https://devforum.roblox.com/t/full-release-of-parallel-luau-v1/1836187
- https://luau.org/performance
- https://create.roblox.com/docs/reference/engine/classes/Actor
- https://create.roblox.com/docs/reference/engine/datatypes/SharedTable
- https://create.roblox.com/docs/scripting/multithreading
---
# Roblox Performance
## When to Load
Use for profiling and performance budgets. Pooling and lifecycle patterns: `roblox-luau-patterns`.
## Quick Reference
### Profiling Tools
- **MicroProfiler (Ctrl+F6)**: Frame breakdown of scripts, physics, rendering.
- **Developer Console (F9)**: Memory, network, rendering, and server stats.
- **Script Profiler (Ctrl+Alt+F5)**: Per-script CPU and heap.
- **Labels**: `debug.profilebegin`/`debug.profileend` mark regions; `debug.setmemorycategory` labels memory. Gate instrumentation behind a flag.
### Performance Targets
| Metric | Starting target | Investigate at |
|--------|-----------------|----------------|
| Server heartbeat | < 16ms | > 33ms |
| Client FPS (desktop) | 60 | < 30 |
| Client FPS (mobile) | 45 | < 30 |
| Memory | device-specific | sustained growth |
Optimize measured hot paths, not folklore. Throttle from measurements; re-profile after shipping.
### Parallel Luau
- Use Actors only after profiling identifies isolatable CPU work.
- Workers compute; synchronize before restricted DataModel writes.
- Do not rely on shared module state across Actors. `SendMessage` copies data; SharedTable supports shared state and atomic updates.
### Hot-loop cost model
- Luau optimizes global imports; avoid folklore function hoisting/unrolling. Environment impurity can disable optimizations. Profile allocations as well as CPU; GC cost may occur later.
### Object Pooling
Pre-clone and reuse. Canonical pool code (token-lease ownership): `roblox-luau-patterns`.
### StreamingEnabled Essentials
- **On by default**. Container-scoped: only Workspace descendants stream. `ModelStreamingBehavior = Improved` streams non-BasePart descendants with their parent Model; Legacy streams only BaseParts.
- **Streamed-out = parented to nil**, not destroyed. Luau refs persist if it streams back.
- **Config (Studio)**: target defaults 1024, min 64; set `StreamingIntegrityMode`; tune from data.
- **Gotcha**: `FindFirstChild("DistantPart")` returns nil if streamed out. Use WaitForChild with timeout.
### Mobile
- Profile geometry, textures, particles, UI, shadows on low-end devices.
> Full reference with code examples and API tables: [references/full.md](references/full.md)
Files in this package (2)
- SKILL.md 3 KB
- references/full.md 24 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · tabooharmony/roblox-brain | 100 | MIT |
| el4cteo/roblox-skills | 100 | MIT |
| gustavopiumbini/robloxcodingtoolkit | 90 | MIT |
Database snapshot: 13.11.2026 · package version ec969136cdbf (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100roblox-performance-audit
Measured performance fixes (MicroProfiler, memory, network, mobile budgets). Use for lag, low fps, spikes, growing memory, phone crashes. - 100scenario-roblox-performance
Use when a Roblox experience is slow, laggy, stuttering, crashing or out of memory, or before shipping or updating one: my game lags on mobile, low FPS, frame spikes, server lag or low heartbeat, physics lag, network lag or high KB/s, memory leaks or memory that keeps growing,… - 100roblox-testing
Test, debug, or profile Roblox experiences. Use for Studio debugging, TestEZ, logging, connection cleanup, memory or network diagnostics, MicroProfiler, Scene Analysis, and Script Profiler. - 91roblox-game-development
Use this skill for any Roblox related tasks - 100mobile-app-performance-fps-memory-profiling
Use this skill when profiling mobile frame drops, memory leaks, CPU spikes, and battery drain using Xcode Instruments and Android Profiler. - 100roblox-docs
Check the official Roblox docs (create.roblox.com) instead of memory - method signatures, properties, enums, datatypes, deprecations, guides. Use whenever unsure about any Roblox/Luau API, when planning with less common or new APIs, or when asked "how do I X in Roblox".