Common Issues And Solutions

A quick-reference for the performance problems that come up most, matched to their usual cause and fix. When a script is misbehaving, start here before diving into a full profile.

Lag spikes and stutter

Symptom: the game hitches periodically. Usual cause: a heavy operation running on a loop or event — creating many instances at once, or doing expensive work every frame. Fix: throttle it, spread the work across frames, and cache anything reused. Full detail in reducing script lag.

Steadily rising memory

Symptom: performance degrades the longer you play, sometimes ending in a crash. Cause: a memory leak — instances or event connections never cleaned up. Fix: :Destroy() what you create and :Disconnect() what you connect, as covered in managing resource usage.

Total freeze on run

Symptom: the game locks up the moment the script runs. Cause: almost always a loop with no wait — a while true do that never yields. Fix: add a task.wait() inside the loop so it gives time back to the engine.

This is the single most common beginner freeze.

Network delay in multiplayer

Symptom: actions feel laggy for other players even at good FPS. Cause: RemoteEvents fired too often or with large payloads. Fix: batch and shrink them — see best practices for multi-player scripts. When the cause is unclear, profiling your scripts pinpoints it.