How to post a Bug Report

:warning: Reports without the following information will not be investigated! :warning:


Basics

Your bug reports must have:

  • A descriptive title - Engineers should know what the bug is before opening the thread.
  • A detailed description of the bug - Information on what the bug is and what you expect to occur.
  • Where the bug happens - Does the bug only happen with specific places / users / groups / etc?
  • When the bug started happening - Dates help find the version causing it so it can be fixed faster.
  • Screenshots and videos of the bug - Include screenshots / videos of the bug happening; they’re extremely helpful and more descriptive than words alone.

Reproduction Steps

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

  • Minimal - If you have a complicated repro, simplify as much as possible.
  • Specific - The steps must be clear, detailed, and not open to misinterpretation. Don’t assume engineers know what you mean.
  • Consistent - Ideally, your steps reproduce the issue 100% of the time. Please specifically mention how often your steps reproduce the bug (100% / 50% / Rarely?)

For bugs with complicated setups or conditions, attach a minimal place file to your thread that can be used to reproduce the bug. Provide repro files instead of screenshots for bugs that only happen for certain code / instances / etc!

:warning: Required Information :warning:

  • Crashes or Freezes - Include a repro. If you cannot provide a 100% repro, provide a dump.
  • Performance Problems - Include a microprofiler dump, and your system information if the problem is specific to your computer.
  • Problems running Roblox / Studio or error popups - Include relevant log files.
  • Graphics Problems - Include your system information.
  • Problems specific to a Place / User / Group / etc - First try to isolate the issue to a repro file. Otherwise, include direct links to the affected assets; engineers will not know what “my game” or “game-name” refer to.
  • Backend Problems (e.g. Team Create connection failures) - Provide information to help find the problem on Roblox’s side.
253 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
Future Is Bright Can't Load Unions
Weird avatar bug
Connection issues
About the Mobile Bugs category
Text delayed when typed into script (macOS Sierra)
Roblox studio freezes when a certain place file is opened
Place saving bug
Can't run specific game ads
I can't play any games on my phone
Official Rules of the Roblox Developer Forum
Annoying lighting bug
Roblox Studio Crashing on Startup
Mesh not loading problem
Cant Remove the Shared places
ROBLOXCRITICAL Wrongful Circular require errors?
Some places were reset; reverting impossible!
ROBLOXCRITICAL Data Persistence CURL Error: Couldn't Resolve Host Name
Roblox motor bugs
About the Engine Bugs category
Cilent Crashing Bug or 'Screen Freezing'
100% Datastore GetAsync Error 502
Animation Editor 3.0
Studio freezes when inserting
Message Router Service disconnected
Unachored Parts and models not falling down
Group Stores showing thousands of pages of seemingly random Catalog items
About the Xbox Bugs category
About the Studio Bugs category
About the Platform Feedback category
ContentProvider acting strange
Cannot Open Multiple Studios
How to stop studio randomly restarting?
Have to upload twice for Mesh to show
When I upload my Icon, it becomes black
Walking in straight lines impossible far from the origin
My cursor is having a seizure when I hover it on solo mode
ROBLOXCRITICAL Random crashing? (Destroying sounds after playing)
ROBLOX Sidebar glitches in Chrome
StarterCharacters no longer load shirts & pants
Leaderboards being broken
Animation Play Broken
Plugin settings are reset in Play Solo
Textures render through completely non-transparent bricks at certain camera angles
Cannot change group logo
Can't open places in studio
Studio Play Button in Ribbon Deleting Explorer Content
Handle Adornments have incorrect lighting with AlwaysOnTop
Client consumes my internet connection
Mouse will not lock
[Appears Fixed] Tools randomly disappearing
Player.Team doesn't replicate to new players when first connecting
Team Create/Unions
ROBLOX Studio disconnecting on server launch
The Flashy-Polygons Bug
Chat is still selectable in my game, when SetCoreGuiEnabled disabled it
Urgent kick message bug?
Set- & GetTeleportSetting doesn't persist across servers on the server
Suddenly z-fighting glitches?
Render Perform and Present functions are too intensive?
Studio deleting things from place
ROBLOXCRITICAL Roblox client crashes using TeleportService
Chatting System Bug: Flashes Randomly
I can't get past this new login security
Physics in my game doesn't work correctly anymore
Unions Aren't Loading
Particle Emitter Drag value ; Visual glitch
Animation playing old version(temp cache)
[ROBLOXCRITICAL.] Ordered data store GetAsync returning nil
Super laggy script editor on Mac - fixed
Union Transparency Bug
Unable to update
CustomPhysicalProperties Won't Work
Can't join places - Invalid JSON
November 14th Incident Report
[ROBLOXCRITICAL] Unable to join any game
Having issues with pathfinding on a game I am developing for
Client-sided RemoteEvent memory leak
Cannot move character with certain avatar packages / animations
Studio not responding but not frozen - Mac OS X
Block-Corner with Decals has weird AA
Studio crashes when I try to open any place
Studio Crashes when taking a Screenshot via screenshot tool in Roblox Studio
Widespread Publishing Error Affecting Most Games
Opening new dev console freezes Roblox
Erroneous bloom, blur and glowing rendering artifacts in Studio
CSG shadow problem
Aiming and TeleportService
Microprofiler keeps popping up, even after closed
Mesh Name Moderation In-Studio
Panels sometimes vanish; reopening them causes glitchy behaviour
Can't use keyboard shortcuts while in test mode
Team Create Camera (Not Working)
Graphical Gore: "Friends" on home page [FIXED]
Can't edit R15 character's body color
'Start server' caused my 3rd crash in 10 min [Incl. crashlogs]
Random surge of xbox players every few days
Strange DataStore CURL error causing DataStore service to fail most, if not all, of the time across many games
Random Lag after recent ROBLOX client update
Instancing Rendering Bug with Neons
Neon texture not rendering
Disappearing Code
Cilent Crashing Bug or 'Screen Freezing'
[Minor] Game descriptions
[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
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
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?
Announcing Three-Strike System of Moderation
BillboardGuis do not handle AnchorPoint correctly
Physics sleep still an issue
VR immediately crashes when you try to interact with any surface gui
Can't import meshes because Studio thinks I'm logged out (I'm not)
"Sleeper" physics issues
Script Editor in Roblox Studio not moving to next line
"Fit to window" leaves space unused under Device Emulation
Pasting an emoji in the script editor causes crash
Studio FPS Dropping with Lua widgets open
Studio Crashes immediately after 100% of loading whenever a place or file is opened
Terrain starts tearing / stops rendering when modified
Getting lots of studio crashes - extremely difficult to develop
Can't edit games, randomly getting `Could not open the place "###" with exception: "Unable to open the place"`
Launcher freezes at 28% when opening a place
Studio Crashes When Opening Saved Place
Everyone's Head Is Headless
Enabling teamcreate deletes my game
Team Create takes three hours to load on new games
Animation Editor Broken
Leaderboards all of a sudden random order
Studio is crashing on startup
DataStore requests will constantly throw HTTP 429 errors, breaking my game
Centralized documentation for humanoid bugs
[HELP] Terrain Issue
Team Create Bugs. Post 'em Here!
Team Create Bugs. Post 'em Here!
Studio Move/Scale tools - poor performance
About the Website Bugs category
Pressing Play does absolutely nothing
Proper use of "ROBLOXCRITICAL" in Bug Reports
Publishing not working
Chat creating a gap between messages?
How do I move a UI using mouse?!?!?!?
How do I move a UI using mouse?!?!?!?
Bug Server on a game I develop on is "broken"
Studio CollisionFidelity broken while building/placing Meshparts
Objects become invisible while Part with a certain SpecialMesh is present
UIGridLayout AbsoluteContentSize Incorrect (With UIScale)
[Italian Translation] Official Rules of the Roblox Developer Forum - Regole Ufficiali del Roblox Developer Forum
How to report and debug a crash of Roblox Studio when playing a game
Known issue for Macbooks running macOS 10.12 (Sierra) and higher
Recently played games tab broken

Example Bug Reports


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.

Microprofiler Dump

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

22 Likes

How to Find Log Files


NOTE:

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

  • 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 launches

  • Windows
    • Go to %localappdata%/Roblox/logs.
  • 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 launch 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.

For Studio issues, DM the log files to the Studio Logs / Crash Dumps group, and include a link to the DM in your thread.

For issues with the Roblox app used to play games, wait for an engineer to reply and DM the files to them.

20 Likes

How to Get Dumps


NOTE:

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

How to find dumps automatically generated on crash

Crashes are when you get a crash dialog or the application closes on its own. If you get a white screen / 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

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 proceeding 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 so 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).

For Studio issues, DM the dump files to the Studio Logs / Crash Dumps group, and include a link to the DM in your thread.

For issues with the Roblox app used to play games, wait for an engineer to reply and DM the files to them.

16 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%.
  • 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.

17 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

  • Follow the instructions in the Advanced section, below.
  • Instead of clicking “Save All Information”, 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

Mac

  • Follow the instructions in the Minimal section, above.
  • Click System Report....
  • Click File > Save.
  • :warning: This full system report contains sensitive information, so it’s important it’s NOT posted publicly.
    • For Studio issues, DM the saved file to the Studio Logs / Crash Dumps group, and include a link to the DM in your thread. For issues with the Roblox app used to play games, wait for an engineer to reply and DM the files to them.

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 attach the generated DxDiag.txt file to your bug report.
17 Likes

Helping Correlate Backend Logs

If there is a problem on the backend (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 userId of the account you were using when you had the issue.
  • The placeId / gameId of the game you were using when you had the issue.
  • 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.
23 Likes