The following is a list of common tags in the MicroProfiler, grouped by category. Understanding these tags can help you identify problematic code in your experience. The tables contain tag label, descriptions and performance advice for improving performance and optimizing your experience.
AI/Navigation
Label | Description | Performance Advice |
---|---|---|
rasterizeTile | Updates navigation tiles needed for a pathfinding request, usually followed by computePath which requires those tiles be up-to-date. Follows NavigationJob/preprocess on the main thread. | Reduce the number of pathfinding tile invalidations, as this causes those paths to need recomputing. This is caused by non-navigable parts moving. |
computePath | Calculates paths, typically after rasterizeTile. | Reduce the number and world extents of ComputePath calls. Try reusing paths for multiple agents if they are expected to start/end from approximately similar locations. |
preprocess/getPrimitivesOverlapping | Collects the world geometry for each pathfinding tile and schedules the rasterization tasks to be executed by the pathfinding thread. | Reduce the part count. |
Animation
Label | Description | Performance Advice |
---|---|---|
Simulation/gameStepped | Processing of game specific objects such as Humanoids, Animations and heartbeat callbacks | |
Simulation/gameStepped/StepLegacy | Humanoid state changes and movement.Called stepHumanoid on server now (parallel version) | Disable or reduce Humanoid states on NPCs, if you have them. Ladder state is most important to disable. Reduce callbacks to state changes such as Humanoid.Died or Humanoid.Running |
Simulation/gameStepped/stepAnimation | Animators will step forward in currently playing animations. | Reduce the amount of Animators or animated joints to lower the workload of this step. Reduce number of callbacks to animation events such as AnimationTrack.KeyframeReached or AnimationTrack.Ended |
Simulation/gameStepped/RunService.Stepped | Runs functions connected to the RunService.Stepped event. | Reduce the amount or workload of functions connected to this event. Consider delaying or replacing expensive calculations. Consider spreading computation across multiple frames. |
Audio
Label | Description | Performance Advice |
---|---|---|
Sound | Processing audio: locations, effects, volumes, etc. | |
DeveloperTag_Sounds | In-Memory Sounds: generally short sounds that are small enough to go in memory. Usually brief one-shot fx, not long-form music. | Use fewer short sounds. |
DeveloperTag_StreamingSounds | stream/StreamingSounds: these are larger sounds that get streamed from disk. Generally longer-form music files. | Use fewer long sounds. |
Networking
Label | Description | Performance Advice |
---|---|---|
Net PacketReceive | Receives network packets. If many objects or events are being replicated, this step takes longer. | Replicate fewer objects or events. |
Replicator/ProcessPackets | Processes contents of network packets, such as motion, event invocations and property changes. | Reduce the number or size of objects being replicated, or do this in incremental steps. May increase if map size increases, as larger maps tend to have more overall activity. |
Allocate Bandwidth and Run Senders/Dispatch Physics Senders and TouchSenders | Sends data about activity in the experience. | Reduce the amount of moving objects and/or touches. See following sections. |
Allocate Bandwidth and Run Senders/Dispatch StreamJob | Sends corresponding specific regions to specific clients in the "Streaming" feature. | Reduce the minimum and target streaming radii. |
Allocate Bandwidth and Run Senders/Dispatch Data Senders | Sends property changes, remote events, Humanoid state changes, animation start/stops. | Reduce the number of replicated changes to the data model |
Replicator SendCluster | Sends Terrain data to clients. | Reduce the amount or size of Terrain changes. |
ModelCompleteness Mega Job | Server only: completeness is an internal concept. When models are completely sent, model completeness events are sent. | Add or remove fewer instances. |
DeserializePacket | Low-level network packet processing. Prepares for Replicator ProcessPackets. | Send fewer updates. |
Rendering
Label | Description | Performance Notes |
---|---|---|
Prepare | Information is gathered from the main thread and updates various data structures used for rendering. This blocks the simulation threads, so it should be as small as possible. | See Prepare labels below. |
Prepare/Pass3dAdorn | Rendering various object adorns, such as text labels above objects. This step may include raycasting to determine if such objects are visible. | Reduce the number of visible adorned objects, such as BillboardGuis, Humanoid name/health labels, etc. |
Prepare/Pass2D | Readies 2D UI rendering (both player and Roblox UI). | Reduce the amount or complexity of UI elements. |
Prepare/UpdateInvalidParts | Updates parts that had some property changed or added. | Reduce the amount of properties changes on the world. If a script updates a large set of object properties, break it down across frames. |
Prepare/UpdateInvalidateFastClusters | Prepares geometry, typically "FastClusters" used to render Humanoids. Sub-markers specify the number of parts, vertices, and size of vertices. | Reduce the use of 'Humanoids' under objects that are not Humanoids. This should not be used to shorten draw calls as FastClusters consume much more memory. |
Prepare/UpdateDynamicParts | Updates positions for Humanoids, vehicles and other moving instances for rendering. | Reduce the number or complexity of moving Humanoids or vehicles visible. Combining parts of the same material and color into a union or MeshPart can help with this. |
Prepare/updateInstancedClusters | Prepares static geometry that uses instanced rendering (parts and mesh parts). Labels "Clusters" and "Instances" indicate the number updated. | Use less overall mesh and material variation. You can also create clusters by using objects that have similar appearances - size, color, material. |
Perform | When actual rendering commands are created and issued. | See Perform labels below. |
Perform/fillGuiVertices | UI rendering. Fills buffers with UI vertices for adorns. "Gui count" label indicates the amount of elements in the renderer list. | If the cost is high, reduce the amount of UI being updated by disabling it when it is not used by ensuring it is hidden correctly. |
Perform/Scene/queryFrustumOrdered | Applies frustum culling so that objects not visible are not rendered. | If there is a high cost that means there are a lot of elements. Perhaps use some larger meshes where a single mesh has more details as opposed to many small individual pieces. |
Perform/Scene/computeLightingPerform | Computation of lighting near the camera. | Manipulate the number of light sources or move the camera less to reduce the time it takes to recalculate lighting. |
Perform/Scene/computeLightingPerform/LightGridCPU | Updates the voxel lighting. Lights are only rendered in Voxel Lighting mode, but occupancy and sky light are computed in all lighting modes. | If updating chunk occupancy takes too long, consider using lower resolution geometry, or reducing the number of parts. If the other sub-markers take too long, consider reducing the number of lights. Consider using non-shadow casting geometry for objects that move and invalidate the occupancy. |
Perform/Scene/Glow, ColorCorrection, MSAA, SSAO, and SSAOApply | Post-processing rendering. | Reduce the number of post-processing effects, usually this is not significant. |
Perform/Scene/UI | UI rendering. In Id_Screen, there is a label with the number of batches, materials and triangles used. | Reduce the number of visible UI elements. Using CanvasGroups may help at the expense of increased memory use. |
Id_Opaque | Parts in the scene with a transparency value of 0. | |
Id_Transparent | Parts in the scene with a transparency value other than 0. | Reduce the use of partial transparency (values other than 0 and 1). |
Id_Decal | Decals in the scene. | |
Perform/Present | Waits for the GPU to finish rendering the previous frame; actually issues rendering commands to GPU; deals with low-level graphics resources. | Reduce scene complexity in general. If this step is taking a long time, you may be limited by the GPU. |
Perform/Present/waitUntilCompleted | Waits for the GPU to finish rendering the previous frame. | If this is generally happening a lot then the amount of things rendered is too high. FRM helps with balancing this, but if it remains high, try to use less detail. |
Scripts
Label | Description | Performance Advice |
---|---|---|
Render/PreRender/fireBindToRenderSteppedCallbacks | Running functions bound to render step via RunService:BindToRenderStep(). | Ensure functions in scripts using RunService:BindToRenderStep() do as little work as possible. |
Render/PreRender/RunService.RenderStepped | Runs functions connected to the RunService.RenderStepped event. | Similar to BindToRenderStep, ensure functions using this event do as little work as possible. |
WaitingHybridScriptJob | Resumes scripts waiting using wait. frames. | This step has an execution time budget to run waiting scripts, so if you have too many waiting scripts or scripts with a long runtime before yielding, this step can take multiple |
LuaGC | Lua garbage collection cycle. Label provides memory estimates on total allocation and how much was deallocated. | Pool lua tables and other collectable objects or try to reduce creating temporary tables or strings |
Heartbeat/RunService.Heartbeat | Runs functions connected to the RunService.Heartbeat event.Talk to simulation and scripts contacts. Current description is generic enough to be not wrong | Reduce the amount or workload of functions connected to RunService.Heartbeat. |
Simulation
Label | Description | Performance Advice |
---|---|---|
Distributed Physics Ownership | Determines whether the server or a client has authority over certain instances such as parts. | Distributed Physics Ownership. |
Simulation/assemble | Updates a tree of connected objects (assemblies) used by the physics engine. | Reduce the amount of joints being created or destroyed. |
Simulation/physicsStepped | Runs the physics simulation. | Reduce the amount and complexity of physically simulated bodies. |
physicsStepped/SpacialFilter/filterStep | Updates simulation islands, arranging parts according to network ownership, local simulation. Islands are non-interacting groups of parts which can be simulated independently. | Avoid setting network ownership frequently. Keep groups of parts far enough away from each other so they can be simulated separately. |
physicsStepped/worldStep/stepContacts | Updates contacts between objects. | Reduce the amount of bodies colliding at once, or use simpler collision boxes. Cubes are better than complex meshes. |
physicsStepped/worldStep/stepWorld OR stepWorldThrottled | Solves physics equations relating to connectors, buoyancy and Humanoids. When the engine is overloaded and unable to simulate everything in real time, some steps may be throttled (stepWorldThrottled) and only "real time assemblies" such as Humanoids are simulated. | Depends on where the time is going based on the following three phases: stepContacts: narrow phase collision detection geometry tests. Solver step: integrate time and resolve collisions and other constraints updateBroadphase: update positions of assemblies in collision detection system and find possibly colliding narrow phase pairs. |
NotifyMovingAssemblies | Helps track how long primitives have been sleeping. | |
Simulation/InterpolateNetworkedAssemblies | Interpolates assemblies not controlled by this network peer. | Set the network owner of parts to this peer to reduce this; although this will usually cause more physics work to be done elsewhere. |
Simulation/handleFallenParts | Removes parts that have fallen below Workspace/FallenPartsDestroyHeight. | Lower the destroy height or reduce the amount of parts that fall to the destroy height. |
Heartbeat/HeartbeatInternal/updateVisuallySleeping | Second part of NotifyMovingAssemblies. | |
Heartbeat/RunService.Heartbeat | Runs functions connected to the RunService.Heartbeat event.Talk to simulation and scripts contacts. Current description is generic enough to be not wrong | Reduce the amount or workload of functions connected to RunService.Heartbeat. |
worldStep/StepContacts | Helps physics simulation step many contacts at once. | Reduce the number of colliding objects. |
SolveBatch | Helps the physics simulation solve batches of objects' motion. | |
Mechanism Interpolation | Helps with InterpolateNetworkAssemblies. |
UI
Label | Description | Performance Advice |
---|---|---|
Render/PreRender/UpdateInput | Updates and fires all user input related events if the user has performed input since the last frame. | This is when events related to user input will fire. It is important to try and not do too much work directly as you get the input. Consider doing a minimal amount of processing for the input, and larger computations should be pushed off to another thread that happens later. |
Render/PreRender/TweenService | Updates objects being tweened using TweenService and calls completion callbacks, such as those used provided to TweenSize or TweenPosition. | Reduce the number of objects being tweened using TweenService and ensure callbacks do as little work as possible. |
Render/PreRender/UpdateUILayouts | Updates position and size of UI elements. | Reduce the amount of UI elements being resized or repositioned dynamically, such as those managed by UILayout. |
Heartbeat/TweenService | On server, updates objects tweened with TweenService. On the client, this is done in a PreRender step instead. | Reduce the amount of objects tweened by TweenService. |