How to post a Bug Report

:warning: Reports without the following information will NOT be investigated :warning:


Replies to bug reports must also follow these guidelines where possible. This means “Me too!” replies are not acceptable.

Basics

Your bug report must have:

  • An accurate title - Engineers should know what the bug is before opening the thread. Be specific!
  • A detailed description - Explain what you expect, and what happens instead.
  • Where it happens - Include links if it happens with specific places / users / groups / etc.
  • When it happens - Include the date and time (including timezone) when it started happening.
  • Videos and images - Include visuals to demonstrate the problem.
  • Reproduction instructions and files - See below
  • :exclamation: Required information - See below

See some examples.


Reproduction Steps

Provide step-by-step instructions that cause the bug to happen.
These steps must be:

  • Minimal - Simplify complicated steps or conditions as much as possible.
  • Specific - Steps must be clear and detailed. Don’t assume engineers know what you mean.
  • Consistent - Ideally, your steps reproduce the issue 100% of the time. Specifically mention how often your steps reproduce the bug (100% / 50% / Rarely?)

Reproduction Files

If your bug is with Studio or the Roblox engine, upload a very simple place file to your thread that can be used to reproduce the bug. This file should contain the bare minimum to cause the bug to happen.

Always include reproduction (repro) files for bugs that only happen with specific scripts / place setups / instances / etc!

If your repro file contains private content, you should DM it to the Logs / Crash Dumps / Other Bug Files group. Include a link to the DM in your thread. This link is only viewable by Roblox employees


:exclamation: Required Information :exclamation:

You must include this extra supporting information:

If your bug is happening on the website:

  • Make sure the bug still happens if you disable all of your browser extensions.

  • Include what browser version you are using.

If your bug only happens to a specific game / user / group / etc:

  • Make a repro file as simple as possible that causes the bug. Otherwise, include direct links to the affected game / user / group; engineers will not know what “my group” or “game-name” means.

If your bug is happening in Studio:

If you are crashing / freezing / disconnecting / having problems running Roblox or Studio:
(Review the difference between crashes, freezes, and disconnects, make sure you use the right word!)

If Roblox is lagging or running slowly:

If you have graphics problems or Roblox looks wrong:

759 Likes
Something's wrong with ROBLOX Player? [Discord overlay]
Closed, Thank you
How do I stop the server from kicking players trying to join
StarterGear not accessible from server
Camera stutters while interpolating at high velocities
Connection issues
Weird avatar bug
About the Mobile Bugs category
Future Is Bright Can't Load Unions
ROBLOXCRITICAL Wrongful Circular require errors?
Cilent Crashing Bug or 'Screen Freezing'
Can't run specific game ads
Roblox studio freezes when a certain place file is opened
Team Create Bugs. Post 'em Here!
Text delayed when typed into script (macOS Sierra)
Place saving bug
I can't play any games on my phone
Some places were reset; reverting impossible!
[ROBLOXCRITICAL.] Ordered data store GetAsync returning nil
Cant Remove the Shared places
VR doesn't work at all occasionally
About the Website Bugs category
100% Datastore GetAsync Error 502
The Flashy-Polygons Bug
ROBLOXCRITICAL Data Persistence CURL Error: Couldn't Resolve Host Name
Walking in straight lines impossible far from the origin
Roblox Studio Crashing on Startup
And now what error is there?
Mesh not loading problem
New Members - Post Approval Process 101
Weird joining issue when creating servers from New Zealand
Chat creating a gap between messages?
About the Engine Bugs category
Annoying lighting bug
Can't join places - Invalid JSON
Animation Editor 3.0
Official Rules of the Roblox Developer Forum
Physics sleep still an issue
[ROBLOXCRITICAL] Unable to join any game
Roblox motor bugs
Urgent kick message bug?
Chat is still selectable in my game, when SetCoreGuiEnabled disabled it
ROBLOX Studio disconnecting on server launch
Team Create/Unions
[Appears Fixed] Tools randomly disappearing
Mouse will not lock
Client consumes my internet connection
Handle Adornments have incorrect lighting with AlwaysOnTop
Can't open places in studio
Cannot change group logo
Textures render through completely non-transparent bricks at certain camera angles
Plugin settings are reset in Play Solo
Animation Play Broken
Leaderboards being broken
StarterCharacters no longer load shirts & pants
ROBLOX Sidebar glitches in Chrome
ROBLOXCRITICAL Random crashing? (Destroying sounds after playing)
My cursor is having a seizure when I hover it on solo mode
When I upload my Icon, it becomes black
Have to upload twice for Mesh to show
About the Studio Bugs category
About the Xbox Bugs category
Group Stores showing thousands of pages of seemingly random Catalog items
Unachored Parts and models not falling down
Studio freezes when inserting
Message Router Service disconnected
Recently played games tab broken
Known issue for Macbooks running macOS 10.12 (Sierra) and higher
Team Create takes three hours to load on new games
[Italian Translation] Official Rules of the Roblox Developer Forum - Regole Ufficiali del Roblox Developer Forum
Update 'How to post a Bug Report' to guide Members posting
Studio freezing when trying to debug
Pressing Play does absolutely nothing
UIGridLayout AbsoluteContentSize Incorrect (With UIScale)
Objects become invisible while Part with a certain SpecialMesh is present
Studio CollisionFidelity broken while building/placing Meshparts
Team Create Bugs. Post 'em Here!
Bug Server on a game I develop on is "broken"
How do I move a UI using mouse?!?!?!?
How do I move a UI using mouse?!?!?!?
Studio Move/Scale tools - poor performance
Incorrect “not in scope” in “My Watches” while debugging
Publishing not working
Enabling teamcreate deletes my game
[HELP] Terrain Issue
Centralized documentation for humanoid bugs
DataStore requests will constantly throw HTTP 429 errors, breaking my game
Studio is crashing on startup
Getting lots of studio crashes - extremely difficult to develop
Leaderboards all of a sudden random order
Everyone's Head Is Headless
Studio FPS Dropping with Lua widgets open
Studio freezing when trying to debug
Studio Crashes When Opening Saved Place
Studio Crashes immediately after 100% of loading whenever a place or file is opened
Terrain starts tearing / stops rendering when modified
Can't import meshes because Studio thinks I'm logged out (I'm not)
Studio Closing without an Error
Pasting an emoji in the script editor causes crash
"Sleeper" physics issues
Script Editor in Roblox Studio not moving to next line
"Fit to window" leaves space unused under Device Emulation
BillboardGuis do not handle AnchorPoint correctly
VR immediately crashes when you try to interact with any surface gui
Weird joining issue when creating servers from New Zealand
Health fails to appear after disabling and enabling Topbar
How do I find the source of an error message?
LocalScript replication is broken - game is unplayable
Recommended games show thumbnails instead of game icon
Exploiters crashing server
Lua Widgets make Script Editor Unusable due to Lag
Tickets currency back in the audit log section of group management
Roblox Game Crash Issue
Studio updater "file used by another process" bug
"Attachments must be parented to a PartInstance" error
Some developers cannot see the Robux per Visit graph under their game's Developer Stats
I think my place is interrupted not sure
BillboardGUIs with LightingInfluence=0 are still influenced by lighting
Image assets fail to load
Play Solo cannot connect, cannot test games
Packages getting Web Copy Error: Http fails
Can't upload or publish games
Please remove this post
Remote Servers / "Internet Connection" Error
Cannot start test servers on Mac OS
Immense Lag on Roblox Studio and Player
My client is verry slow
Insert Object menu is illegible
SpecialMesh Texture Not Rendering Correctly
UICorner [Live]
Verification might be broken
Error when trying to build on another place
Unable to open group place
Plugin Installed Tab Frozen
Announcing the Bug Report Wizard Beta
Studio Scripting Bugs
Game settings options screen can freeze/softlock studio
[Activated!] Sleeping Part Behavior Improvements
Pressing dot on Numpad doesn't work for In-Game Chat
Is this a corrupted place?
Animation does not play on Local Client, from which the LocalScript plays the animation. It plays on all other clients, and on server
Updated workflow when modified Package blocks Place publish
Series of Studio Game Settings bugs
Names showing before button purchase
Undo is not restoring an object from instance:Destroy()
Delay in selecting objects in explorer with large script open
Access code for private server is not valid when joining via game page
Oversized emulator breaks studio UI
Studio Freezing while debugging
Studio Random Freeze Bug On Test
Character + nearby geometry not being rendered
Some of NPC's parts aren't being animated
Opening Place Gives Error
Members can't post in #platform-feedback and it gets annoying
Constantly getting disconnected from Team Create
Bad alignment on dragging a set of parts
Cannot open new studio window from within studio
No popup windows will open in some places
SerializerPugi: Ill-Formed XML
Explicitly clarify that using Development Discussion to circumvent Platform Feedback post restrictions is not allowed and stop dismissing those flags
Unable to open file, I think roblox corrupted my place file?
Badges don't work in multi-place games
So many things Broken on Roblox Studio Mac
My draft disappeared, after reopening studio it came back but as a deleted script and I cannot get rid of it
Studio does not want to open at all
Animator has to be placed under humanoid or AnimationController
Script view in Studio performance drop with new highlighter
Shirt not showing on avatar when wearing it
Green Glitch Screen bug
Printing table with instance as key uses instance ID
About the Bug Reports category
ScrollingBar still being 'there' even when everything should make it not there?
Mmmm yes all my Studio Version Histories got corrupted
How do I fix the terrain tool?
MaxVisibleGraphemes not working anymore?
MarketplaceService is causing weird stuff to happen
When script is duplicated it removes all the code
Roblox Animation Editor IK issue
Decompiled PurchasePrompt Scam
CornerRadius Decreasing on UI Object Select
RichText [TextScaled Support Added]
New Part Collision Property: CanTouch [ACTIVATED]
Extreme Network Lag-spikes
HTTP Request Causing Studio to Break
Unable to see billboard guis from the servers point of view
GetRankInGroup failed because HTTP 0
Notification Number Isn't Centered
Script not running in Studio but working in game?
Lock #bug-report replies to Regular+
Roblox game sorts are incredibly unreliable, inaccurate and unfair
Studio crashing after clicking play, then stop
November 14th Incident Report
Instancing Rendering Bug with Neons
Neon texture not rendering
Disappearing Code
Cilent Crashing Bug or 'Screen Freezing'
[Minor] Game descriptions
Unions Aren't Loading
[Urgent Update] Game parts flashing
Xbox players are losing jump controls and more in Jailbreak
Studio crashing whenever I put code in a specific place?
VIP Server Purchases go to the old owner of the game (and group) rather than group funds
Purchasing the same developer product calls 'ProcessReceipt' one more time each time it is purchased
My ships become very unstable with the PGS physics solver
Physics in my game doesn't work correctly anymore
Meshpart collisions are broken
Stopping a Play Solo session while one of a WeldConstraint's parts are parented to nil will crash studio
Xbox memory WAY worse than PC
Frequent Server Crashes caused by LoadCharacter Usage
AnimationTrack: Not playing client sided, but works fine on Studio
User erroneously double-charged for gamepass
Tools randomly being removed from player in studio test servers
[SERIOUS] Group gamepass page blank
S9 isn't rendering Roblox correctly
Player.Team doesn't replicate to new players when first connecting
Chatting System Bug: Flashes Randomly
Circle looking like an oval on other screen sizes
Cannot Open Multiple Studios
ContentProvider acting strange
How to report and debug a crash of Roblox Studio when playing a game
How to stop studio randomly restarting?
Can't edit universe?
Computer stats and FPS show up in top left of player gui
Terrain generation flat out doesn't work
HipHeight changing on characters with custom scaling?
Particle Emitter Drag value ; Visual glitch
Random Lag after recent ROBLOX client update
Strange DataStore CURL error causing DataStore service to fail most, if not all, of the time across many games
Union Transparency Bug
Random surge of xbox players every few days
'Start server' caused my 3rd crash in 10 min [Incl. crashlogs]
Can't edit R15 character's body color
Graphical Gore: "Friends" on home page [FIXED]
Team Create Camera (Not Working)
CustomPhysicalProperties Won't Work
Unable to update
Can't use keyboard shortcuts while in test mode
Panels sometimes vanish; reopening them causes glitchy behaviour
Mesh Name Moderation In-Studio
Microprofiler keeps popping up, even after closed
Aiming and TeleportService
CSG shadow problem
Erroneous bloom, blur and glowing rendering artifacts in Studio
Opening new dev console freezes Roblox
Widespread Publishing Error Affecting Most Games
Update Bug Report Guidelines - Critical Situations
Studio Crashes when taking a Screenshot via screenshot tool in Roblox Studio
Studio crashes when I try to open any place
Block-Corner with Decals has weird AA
Studio not responding but not frozen - Mac OS X
Cannot move character with certain avatar packages / animations
Client-sided RemoteEvent memory leak
Announcing Three-Strike System of Moderation
Having issues with pathfinding on a game I am developing for
Super laggy script editor on Mac - fixed
Animation playing old version(temp cache)
Launcher freezes at 28% when opening a place
Can't edit games, randomly getting `Could not open the place "###" with exception: "Unable to open the place"`
Animation Editor Broken
Studio Play Button in Ribbon Deleting Explorer Content
I can't get past this new login security
ROBLOXCRITICAL Roblox client crashes using TeleportService
Studio deleting things from place
Render Perform and Present functions are too intensive?
Suddenly z-fighting glitches?
Set- & GetTeleportSetting doesn't persist across servers on the server
Add a topic template for bug reports

Example Bug Reports

Click to expand

Studio Bugs: Studio crashes when resizing any 5x5x5 part

Roblox Studio will always crash when you try to resize a 5x5x5 size part using the resize tool, the properties widget, or command bar. Parts of any other size do not crash.

This happens only in Studio.
This started happening on December 20.

Repro

With Resize tool or Properties widget:

  • Create a part and set its size to 5,5,5 using the properties widget.
  • Select the part and choose the resize tool, or select the size field in the properties widget.
  • Try to resize the part, Studio will crash.

With script run from command bar:

local p = Instance.new("Part", workspace)
p.Size = Vector3.new(5,5,5)
p.Size = Vector3.new(10,10,10) -- Crashes

Both methods will crash 100% of the time.

Crash Dump

https://devforum.roblox.com/t/link-to-dm-to-studio-bug-files/######




Engine Bugs: Character spawns with green head in live games

When your character spawns in-game, your head will always be green.
This does not happen in Studio, it only happens in a real game.

This started happening today.
As far as I can tell, this happens 100% of the time with both R6 and R15 characters.

Repro




Engine Bugs: Glass material renders completely black

In-game and in Studio the glass material renders completely black.

This happens 100% of the time for me, but other people I’ve asked don’t have this problem.
This has been happening since I got my new GPU on December 20.

Specs

OS: Windows 10 Home
GPU: NVIDIA GeForce GTX 1070

This is what a default part inserted in Studio and changed to the glass material looks like for me.

image




Engine Bugs: Lag when creating ParticleEmitters

Sometimes when a ParticleEmitter is created by either the server or the client, Roblox will have a brief lag spike. Parenting the ParticleEmitter is not required, simply creating it with a script will cause the problem.

This started happening today.
This happens in-game, and in Studio about 50% of the time a ParticleEmitter is created.
This only happens with ParticleEmitters.

Repro

  • Run the below code.
  • Roblox will freeze briefly about 50% of the time after “Creating” is printed.
while wait(1) do
	print("Creating")
	local p = Instance.new("ParticleEmitter")
	print("Created")
end

ParticleEmitterLagExample.rbxl (17.2 KB)

Demonstration

If you look closely, you can see Roblox freezing briefly.

https://gfycat.com/InsignificantPolishedAsiantrumpetfish

Microprofiler Dump

You can clearly see one of the lag spikes in this dump.
microprofile-20191220-022927.html (1.1 MB)



194 Likes

How to Find Log Files


NOTE:

  • :warning: These log files may contain sensitive information, so it’s important they’re NOT posted publicly, send them to Logs / Crash Dumps / Other Bug Files.

  • It is important you identify the correct log files! Make sure you are sorting by last modified or finding the most recent logs by timestamp.


Roblox / Studio successfully opens

Windows
  • Go to %localappdata%/Roblox/logs.
  • Sort the directory you opened by Last Modified.
  • Take the latest log_xxxxx_x.txt file.

Mac
  • Go to ~Library/Logs/Roblox.
  • Library can be found under Go > Library (you may need to hold down Option if it isn’t there).
  • Sort the directory you opened by Last Modified.
  • Take the latest log_xxxxx_x.txt file.

Roblox / Studio does not open properly

Include the logs from the above section if they exist.

Windows
  • Go to %localappdata%\Temp and sort the folder by Last Modified
  • Take the latest two RBX-xxxxxxxx.log files

Mac
  • Go to ~Library/Logs/Roblox and sort the folder by Last Modified
  • Library can be found under Go > Library (you may need to hold down Option if it isn’t there).
  • Take the latest bootstrapper_xxxxxx_x.txt file.

If the issue is freezing, loading forever, or similar, wait a few minutes before following these instructions to copy the log files so that there is enough time for long operations to get logged.


DM the log files to the Logs / Crash Dumps / Other Bug Files group. Include a link to the DM in your thread. This link is only viewable by Roblox employees.

153 Likes

How to Get Dump Files


NOTE:


How to find dumps automatically generated on crash

Crashes are when you get a crash dialog/popup or the program closes on its own. If you get a white screen / spinning beachball cursor, this is NOT a crash! See the freezes/hangs section below.

Windows
  • Go to %localappdata%/Roblox/logs and sort the folder by Last Modified.
  • Take the first .DMP file (if you don’t see one, it may be in /archive).

Mac
  • Open the terminal and run open $TMPDIR
  • Sort the folder by Last Modified.
  • Take the first .DMP file.

How to generate dump files for freezes/hangs

If your problem is with Studio, FIRST, make sure all plugins are disabled from File > Advanced > Manage Plugins to verify the cause is Studio. Include in your bug report that you tested with all plugins disabled.

Windows
  • Open the Task Manager with Ctrl+Shift+Escape.
  • Find RobloxStudio in either the Details (Windows 10) or Processes tab.
  • Right click and select “Create dump file”.
  • Take the .DMP file shown in the resulting popup dialog.

Mac
  • Open the Activity Monitor from within Applications > Utilities.
  • Select Roblox / Roblox Studio.
  • Click the action menu in the toolbar (Gear Dropdown) > Sample Process.
  • Take the .txt file saved in the proceeding dialog.

Generate 3 or more dump files like this, each a few minutes apart.


Once you have the dumps/samples from either of the above steps, they are too large to share on the forum. You will need to upload them to a file hosting service (e.g. Google Drive, Dropbox). Zipping and compressing these first will often make them a manageable size.

DM the dump files to the Logs / Crash Dumps / Other Bug Files group. Include a link to the DM in your thread. This link is only viewable by Roblox employees.

133 Likes

How to Get Microprofiler Dumps


If Roblox or Studio is stuttering or running slowly, but not completely frozen, you can provide a microprofiler dump to help engineers find the problem.

  • Open the microprofiler with Ctrl+F6.
  • Once the stuttering / slowness happens, press Ctrl+P to pause the microprofiler.
  • From the top menu bar, click Dump > 32 frames.
  • On Windows, go to %USERPROFILE%.
    • Server profiles will be in %localappdata%\Roblox\logs
  • On Mac, go to Go > Home.
  • Sort the folder by Last Modified.
  • Find the latest microprofile-yyyymmdd-xxxxxx.html file.
  • Open the file in your browser and make sure that it captured the performance problem (there should be a spike near the right side of the timeline at the top).

You can directly upload this HTML file to your bug report.

131 Likes

Providing System Information


Minimal Information

This information is usually enough for a bug report unless asked for by an engineer.

If you’re on Mac, engineers prefer if you follow the steps below, even if you already know your system information. If you’re on Windows and know your system information, you can just include your OS, CPU & GPU models, and RAM amount in your bug report (otherwise, follow the steps below).

Mac
  • Click the Apple icon in the top left of the screen and select About This Mac.
  • Include a screenshot of the dialog that appears.

Windows 10
  • Open Task Manager with Ctrl + Shift + Escape.
  • Go to the Performance tab.
  • Click the CPU, Memory, and GPU tabs and include the information in the top-right in your bug report.
    • e.g. Intel® … @ 3.0 GHz, 16 GB, NVIDIA GeForce GTX 970

Older versions of Windows
  • Type dxdiag in the start menu (or in the Run dialog) and press enter.
  • If a popup appears about “digitally signed drivers”, click “Yes”.
  • Include the values from Operating System, Processor, and Memory on the System page, and the Name from the Display 1 page in your bug report.

Advanced Information

Engineers will ask you for this information if needed.

Mac
  • Click the Apple icon in the top left of the screen and select About This Mac.
  • Include a screenshot of the dialog that appears.
  • Click System Report....
  • Click File > Save.
  • :warning: This full system report contains sensitive information, so it’s important it’s NOT posted publicly.

Windows
  • Type dxdiag in the start menu (or in the Run dialog) and press enter.
  • If a popup appears about “digitally signed drivers”, click “Yes”.
  • Click “Save All Information” and upload the generated DxDiag.txt file to your bug report thread.
123 Likes

Helping Correlate Backend Logs


If there is a problem on the backend / server (Roblox’s side), engineers will need to investigate their own logs. To find them (since they have too many to look through manually), they need:

  • The user ID of the account you were using when you had the issue.
  • The place ID / game ID of the game you were using when you had the issue.
  • If the issue is in Team Create, does it happen in a live game as well?
  • The date and time (including timezone) you had the issue. Be as precise as possible.
  • Your log files.
  • As much information that was shown to you as possible.
    • e.g. screenshots of errors and popups, HTTP status codes displayed in the UI, log files, etc.
144 Likes

What is the difference between crashes / hangs / disconnects?


It’s important to know which kind of bug you are reporting in order to be able to provide the right information in the bug report.


Crashes

The entire application closes unexpectedly, usually with a dialog like
image

If the entire application doesn’t close (e.g. it just goes back to the start page) or an “Updating Roblox…” dialog appears shortly after, then it isn’t a crash. When a crash occurs, please include the crash dump and log files.


Freezes / Hangs

The application stops responding and is unable to be used, but is still open. On Mac, you will generally get the infinite spinning beachball cursor, while on Windows, the application will usually be marked with “(Not Responding)” and become slightly whiter like

image

Please include manually generated dumps for freezes / hangs.


Disconnects

The current session to the open place disconnects, but the application can otherwise be interacted with. In the game client, you will get a dialog like
image

while in Studio it will look like
image

Please include information to help us correlate backend logs for disconnects.

199 Likes

How to launch Studio without plugins enabled


User-installed plugins can change the behavior of Roblox Studio. If you have problems with crashing, freezing, strange behavior, etc. you should attempt to reproduce your bug with all of your plugins disabled before reporting it.

If the issue is caused by plugins, try to include a link to the plugin causing the problem, and try to check that your bug is not caused by faulty plugin programming, but instead is caused by faulty engine/Studio API that the plugin is using.


Windows 10
  • Shift + right click on your Roblox Studio shortcut, and choose “Open file location”.
  • Backspace the file path in the address bar in the explorer, and type “cmd”. Press enter.
    explorer_2021-03-26_20-34-52
  • In the black window that appears, type RobloxStudioBeta.exe -disableLoadUserPlugins. Press Enter.
  • Roblox Studio will start with all user plugins temporarily disabled.

MacOS
  • Open Spotlight with Command + Space.
  • Search for and open “Terminal”.
  • Type open /Applications/RobloxStudio.app --args -disableLoadUserPlugins and press Enter.
  • Roblox Studio will start with all user plugins temporarily disabled.
75 Likes