Roblox Performance

sentinelcore/roblox-skills/roblox-performance

作者 sentinelcoref2b1910a7fb898ed35cf2f856e2a2e48e38276bf無授權條款收錄於 2026年10月9日更新於 2026年10月9日

Use when optimizing a Roblox game for better frame rates, reducing lag, improving server or client performance, diagnosing FPS drops, handling large worlds, or when asked about streaming, draw calls, object pooling, LOD, MicroProfiler, or expensive loop operations.

僅含說明Software Development

AI 產生的概覽

指導 Roblox 開發者進行效能最佳化，以提升畫面更新率並減少延遲。

功能: 此技能提供 Roblox 遊戲效能最佳化的參考指引，涵蓋 StreamingEnabled、熱路徑迴圈最佳化、task 函式庫、物件池、細節層級（LOD）、減少繪製呼叫，以及使用 MicroProfiler 進行效能分析。內容包含 Lua 程式碼範例，以及常見畫面更新率殺手與常見錯誤的對照表與修正建議。它產出的是建議與程式碼片段，本身並不執行任何工具。
適用情境: 適用於最佳化 Roblox 遊戲以提升畫面更新率、減少延遲，或改善伺服器與用戶端效能的場合。也適合診斷畫面更新率下降、處理大型世界，或回答有關串流載入、繪製呼叫、物件池、LOD、MicroProfiler 或高成本迴圈操作的問題。
執行需求: 不包含任何指令碼或工具，僅為說明性指引。套用這些建議需要 Roblox 開發環境，例如 Roblox Studio 與 Roblox Lua 執行環境。

Roblox Performance Optimization

Quick Reference

Technique	Impact	When to Use
StreamingEnabled	High	Large open worlds
Object pooling	High	Frequent spawn/destroy
Cache references outside loops	High	Heartbeat/RenderStepped
`task.wait()` over `wait()`	Medium	All scripts
MeshParts over Unions	Medium	Many unique shapes
LOD (hide at distance)	Medium	Complex models
Anchor static parts	Medium	Reduce physics budget
Limit PointLights	High	Any scene with many lights

StreamingEnabled

Enable for large worlds — engine sends only nearby parts to the client.

lua

-- Studio: Workspace > StreamingEnabled = trueworkspace.StreamingEnabled = trueworkspace.StreamingMinRadius = 64workspace.StreamingTargetRadius = 128

-- Studio: Workspace > StreamingEnabled = trueworkspace.StreamingEnabled = trueworkspace.StreamingMinRadius = 64workspace.StreamingTargetRadius = 128

Parts outside the radius are nil on the client — always guard with if part then.
Set Model.LevelOfDetail = Disabled on models that must always be present.
Pre-stream an area before a cutscene or teleport:

Hot-Path Loop Optimization

RunService.Heartbeat and RenderStepped fire every frame (~60×/sec). Keep them lean.

Bad — searching the hierarchy every frame

lua

RunService.Heartbeat:Connect(function()    local char = workspace:FindFirstChild(player.Name)    local humanoid = char and char:FindFirstChild("Humanoid")    if humanoid then humanoid.WalkSpeed = 16 endend)

RunService.Heartbeat:Connect(function()    local char = workspace:FindFirstChild(player.Name)    local humanoid = char and char:FindFirstChild("Humanoid")    if humanoid then humanoid.WalkSpeed = 16 endend)

Good — cache references once, do work only when needed

lua

local humanoid = nil
Players.LocalPlayer.CharacterAdded:Connect(function(char)    humanoid = char:WaitForChild("Humanoid")end)
RunService.Heartbeat:Connect(function(dt)    if not humanoid then return end    humanoid.WalkSpeed = 16  -- cached reference, no searchend)

local humanoid = nil
Players.LocalPlayer.CharacterAdded:Connect(function(char)    humanoid = char:WaitForChild("Humanoid")end)
RunService.Heartbeat:Connect(function(dt)    if not humanoid then return end    humanoid.WalkSpeed = 16  -- cached reference, no searchend)

Rules:

Cache game:GetService() and part references outside the loop.
Never call FindFirstChild, GetChildren, or GetDescendants inside Heartbeat.
Throttle work that doesn't need every frame:

lua

local TICK_INTERVAL = 0.5local elapsed = 0
RunService.Heartbeat:Connect(function(dt)    elapsed += dt    if elapsed < TICK_INTERVAL then return end    elapsed = 0    -- expensive work here, runs 2×/sec instead of 60×/secend)

local TICK_INTERVAL = 0.5local elapsed = 0
RunService.Heartbeat:Connect(function(dt)    elapsed += dt    if elapsed < TICK_INTERVAL then return end    elapsed = 0    -- expensive work here, runs 2×/sec instead of 60×/secend)

task Library vs Legacy Scheduler

Always use task — wait() and spawn() throttle under load and are deprecated.

Object Pooling

Reuse instances instead of creating and destroying them every frame.

lua

-- ObjectPool ModuleScriptlocal ObjectPool = {}ObjectPool.__index = ObjectPool
function ObjectPool.new(template, initialSize)    local self = setmetatable({ _template = template, _available = {} }, ObjectPool)    for i = 1, initialSize do        local obj = template:Clone()        obj.Parent = nil        table.insert(self._available, obj)    end    return selfend
function ObjectPool:Get(parent)    local obj = table.remove(self._available) or self._template:Clone()    obj.Parent = parent    return objend
function ObjectPool:Return(obj)    obj.Parent = nil    table.insert(self._available, obj)end
return ObjectPool

-- ObjectPool ModuleScriptlocal ObjectPool = {}ObjectPool.__index = ObjectPool
function ObjectPool.new(template, initialSize)    local self = setmetatable({ _template = template, _available = {} }, ObjectPool)    for i = 1, initialSize do        local obj = template:Clone()        obj.Parent = nil        table.insert(self._available, obj)    end    return selfend
function ObjectPool:Get(parent)    local obj = table.remove(self._available) or self._template:Clone()    obj.Parent = parent    return objend
function ObjectPool:Return(obj)    obj.Parent = nil    table.insert(self._available, obj)end
return ObjectPool

lua

-- Usagelocal pool = ObjectPool.new(ReplicatedStorage.Bullet, 20)
local function fireBullet(origin)    local bullet = pool:Get(workspace)    bullet.CFrame = CFrame.new(origin)    task.delay(3, function() pool:Return(bullet) end)end

-- Usagelocal pool = ObjectPool.new(ReplicatedStorage.Bullet, 20)
local function fireBullet(origin)    local bullet = pool:Get(workspace)    bullet.CFrame = CFrame.new(origin)    task.delay(3, function() pool:Return(bullet) end)end

Level of Detail (LOD)

Built-in: Set Model.LevelOfDetail = Automatic — engine merges distant parts into an imposter mesh automatically.

Manual distance-based LOD:

lua

-- LocalScriptlocal INTERVAL = 0.2local LOD_DISTANCE = 150local elapsed = 0
RunService.Heartbeat:Connect(function(dt)    elapsed += dt    if elapsed < INTERVAL then return end    elapsed = 0
    local dist = (workspace.CurrentCamera.CFrame.Position - model.PrimaryPart.Position).Magnitude    local visible = dist < LOD_DISTANCE    for _, v in model:GetDescendants() do        if v:IsA("BasePart") then            v.LocalTransparencyModifier = visible and 0 or 1        end    endend)

-- LocalScriptlocal INTERVAL = 0.2local LOD_DISTANCE = 150local elapsed = 0
RunService.Heartbeat:Connect(function(dt)    elapsed += dt    if elapsed < INTERVAL then return end    elapsed = 0
    local dist = (workspace.CurrentCamera.CFrame.Position - model.PrimaryPart.Position).Magnitude    local visible = dist < LOD_DISTANCE    for _, v in model:GetDescendants() do        if v:IsA("BasePart") then            v.LocalTransparencyModifier = visible and 0 or 1        end    endend)

Reducing Draw Calls

Merge parts that share a material into one MeshPart (export from Blender as .fbx).
MeshParts batch better than CSG Unions (Unions re-triangulate at runtime).
Reuse materials — 10 parts sharing SmoothPlastic costs far less than 10 unique textures.
Use TextureId on a single MeshPart instead of stacking Decals on many parts.

Profiling with MicroProfiler

Press Ctrl+F6 in-game to open MicroProfiler.
Press Ctrl+P to pause and inspect a single frame.
Look for wide bars in heartbeatSignal (Lua), physicsStepped (physics), or render (GPU).
Label your own code:

lua

RunService.Heartbeat:Connect(function()    debug.profilebegin("MySystem")    -- your code    debug.profileend()end)

RunService.Heartbeat:Connect(function()    debug.profilebegin("MySystem")    -- your code    debug.profileend()end)

Common FPS Killers

Cause	Fix
Thousands of individual parts	Merge into MeshParts
Unanchored static geometry	`Anchored = true` on anything that never moves
Many `PointLight` / `SpotLight` instances	Limit to ~10–20 dynamic lights per area
High-rate ParticleEmitters	Lower `Rate` and `Lifetime`; disable when off-screen
`wait()` under heavy load	Replace with `task.wait()`
`FindFirstChild` chains inside Heartbeat	Cache on load
StreamingEnabled off on large maps	Enable it
`Model.LevelOfDetail = Disabled` everywhere	Use `Automatic` where safe

Common Mistakes

Mistake	Fix
`workspace:FindFirstChild` every frame	Cache reference on character/model load
Destroying and re-creating bullets/effects	Use an object pool
`wait()` in tight loops	`task.wait()`
All parts with unique materials	Standardize to a small set of shared materials
ParticleEmitters enabled off-screen	Disable `Enabled` when particle source is not visible
Physics on decorative parts	`Anchored = true`

來源與署名

來源：sentinelcore/roblox-skills位於roblox-performance提交f2b1910

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Legacy	Modern
`wait(n)`	`task.wait(n)`
`spawn(fn)`	`task.spawn(fn)`
`delay(n, fn)`	`task.delay(n, fn)`
`coroutine.wrap(fn)()`	`task.spawn(fn)`

Roblox Performance

Roblox Performance Optimization

Quick Reference

StreamingEnabled

Hot-Path Loop Optimization

Bad — searching the hierarchy every frame

Good — cache references once, do work only when needed

task Library vs Legacy Scheduler

Object Pooling

Level of Detail (LOD)

Reducing Draw Calls

Profiling with MicroProfiler

Common FPS Killers

Common Mistakes

來源與署名

更多來自 sentinelcore/roblox-skills 的技能

Roblox Security

Roblox Monetization

Roblox Remote Events

Roblox Gui

Roblox Datastores

Roblox Animations

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices