Bug Report Wizard Resources

This topic contains a list of resources and extra guidance on using the bug report wizard.

8 Likes

How to tell the difference between freezes / crashes / connectivity issues

Crashing Issues

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.

In a crash, the entire application closes unexpectedly, usually with a dialog like:

image

Freezing Issues

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 more white.

image

Connectivity Issues

The current session to the open place disconnects, but the application can otherwise be interacted with.

In the game client, you should get a dialog like:

image

Whilst in Studio it will look like:

image

3 Likes

How to give us your system information

If you have graphics problems or Roblox is lagging / running slowly or looks wrong.

Minimal Information

This information is usually enough for a bug report unless asked for by an engineer. Click on your OS below to see information relevant to your device:

MacOS

If you’re on Mac, engineers prefer if you follow the steps below, even if you already know your system information.

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

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):

  1. Open Task Manager with Ctrl + Shift + Escape .
  2. Go to the Performance tab.
  3. 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 Windows
  1. Type dxdiag in the start menu (or in the Run dialog) and press enter.
  2. If a popup appears about “digitally signed drivers”, click “Yes”.
  3. 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. You do not need to include this information in the bug report wizard.

MacOS
  1. Click the Apple icon in the top left of the screen and select About This Mac .
  2. Include a screenshot of the dialog that appears.
  3. Click System Report... .
  4. Click File > Save .
  5. This full system report contains sensitive information, so it’s important it’s NOT posted publicly.
Windows
  1. Type dxdiag in the start menu (or in the Run dialog) and press enter.
  2. If a popup appears about “digitally signed drivers”, click “Yes”.
  3. Click “Save All Information” and upload the generated DxDiag.txt file to your bug report thread.

Reference this section for instructions on zipping and compressing your file.

3 Likes

How to get your Log files

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.

  • :warning: Warning: These log files may contain sensitive information, so it’s important they’re NOT posted publicly.
  • It’s 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

MacOS
  1. Go to ~Library/Logs/Roblox .
  2. Library can be found under Go > Library (you may need to hold down Option if it isn’t there).
  3. Sort the directory you opened by Last Modified.
  4. Take the latest log_xxxxx_x.txt file.
Windows
  1. Go to %localappdata%/Roblox/logs .
  2. Sort the directory you opened by Last Modified.
  3. Take the latest log_xxxxx_x.txt file.

Roblox / Studio does not open properly

MacOS
  1. Go to ~Library/Logs/Roblox and sort the folder by Last Modified
  2. Library can be found under Go > Library (you may need to hold down Option if it isn’t there).
  3. Take the latest bootstrapper_xxxxxx_x.txt file.
Windows
  1. Go to %localappdata%\Temp and sort the folder by Last Modified
  2. Take the latest two RBX-xxxxxxxx.log files
3 Likes

How to get a Crash Dump

Crashes are when you get a crash dialog/popup or the program closes on its own.

:warning: Warning: These dump files may contain sensitive information, so it’s important they’re NOT posted publicly.

If you get a white screen / spinning beachball cursor, this is NOT a crash. Please report your issue as a Freezing Issue

MacOS
  1. Open the terminal and run open $TMPDIR
  2. Sort the folder by Last Modified.
  3. Take the first .DMP file.
Windows
  1. Go to %localappdata%/Roblox/logs and sort the folder by Last Modified.
  2. Take the first .DMP file (if you don’t see one, it may be in /archive ).

Reference this section for instructions on zipping and compressing your file.

3 Likes

How to generate a manual dump for Freezing Issues

:warning: Warning: These dump files may contain sensitive information, so it’s important they’re NOT posted publicly.

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.
  • Generate 3 or more dump files like this, each a few minutes apart.

MacOS
  1. Open the Activity Monitor from within Applications > Utilities.
  2. Select Roblox / Roblox Studio.
  3. Click the action menu in the toolbar (Gear Dropdown) > Sample Process.
  4. Take the .txt file saved in the proceeding dialog.
Windows
  1. Open the Task Manager with Ctrl+Shift+Escape .
  2. Find RobloxStudio in either the Details (Windows 10) or Processes tab.
  3. Right click and select “Create dump file”.
  4. Take the .DMP file shown in the resulting popup dialog.

Reference this section for instructions on zipping and compressing your file.

3 Likes

How to generate a Microprofiler dump for Performance Issues

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.

MacOS
  1. Open the microprofiler with Cmd+Fn+F6
  2. Once the stuttering / slowness happens, press Cmd+P to pause the microprofiler.
  3. From the top menu bar, click Dump > 32 frames .
  4. Open Finder, at the top of the screen select GoHome.
    image
  5. Sort the folder by Last Modified.
  6. Find the latest microprofile-yyyymmdd-xxxxxx.html file.
  7. 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).
Windows
  1. Open the microprofiler with Ctrl+F6
  2. Once the stuttering / slowness happens, press Ctrl+P to pause the microprofiler.
  3. From the top menu bar, click Dump > 32 frames .
  4. In Explorer, go to %USERPROFILE%.
  5. Sort the folder by Last Modified.
  6. Find the latest microprofile-yyyymmdd-xxxxxx.html file.
  7. 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).
Mobile
  1. In-Game Settings MenuSettingsMicro Profiler 'On
    • Use a mobile device connected to the same network as your development machine, you can access a browser-based MicroProfiler.
  2. Get the network IP address of the device and port number.
    • For example in the screenshot below: the IP address is 192.168.1.166 and the port is 1338 .
  3. Type in the network IP address and port number from above in this format: http://network IP address:port number into a web browser
    • Make sure your accessing the browser from a computer connected to the same network as your mobile device
    • Example from screenshot above: 192.168.1.166:1338.
  4. Ensure the performance problem is captured (there should be a spike near the right side of the timeline at the top).
    • If the problem isn’t captured, try refreshing the page to get the latest data
  5. Use File > Save As to save the html file to your computer so it can be uploaded

This HTML file can be uploaded directly to your bug report.

3 Likes

How to compress and upload large files

If generated files 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.

Compressing Files

  1. Put the files you’d like to compress into a folder
  2. Compress the files:
    • MacOS: Right click and select 'Compress [FolderName]'
    • Windows: Right click and select Send toCompressed (zipped) folder
  3. You’ll find the zip file in the same location as the original folder

Uploading Files

  1. Upload your zipped / compressed file into either Google Drive or Dropbox
  2. Share the file link in the appropriate section of the bug report. Please ensure anyone with the link can access the file
3 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.
3 Likes