Guides:How to write efficient bug reports/es: Difference between revisions
From VRChat Wiki
No edit summary |
Updating to match new version of source page |
||
| Line 1: | Line 1: | ||
<languages/>{{Noticebox/Community}}{{Proofread|Please proofread, and correct any errors on this page, utilizing the [[Special:MyLanguage/VRCWiki:Manual of Style|VRChat Wiki Manual of Style]].}} | <languages/> | ||
{{Noticebox/Community}}{{Proofread|Please proofread, and correct any errors on this page, utilizing the [[Special:MyLanguage/VRCWiki:Manual of Style|VRChat Wiki Manual of Style]].}} | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Writing and submitting bug reports to VRChat's Feedback Board effectively, will both help the development team narrow down the problem, and prevent the problem from happening again in the future. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== Overview == | |||
{{Thumb|{{YouTube|2nFVVMXqAaE|360px|9 / 16|thumb=File:YTThumb_2nFVVMXqAaE_Severance.webp|title=Tupper…? #Severance #VRChat #vrchatcommunity | {{Thumb|{{YouTube|2nFVVMXqAaE|360px|9 / 16|thumb=File:YTThumb_2nFVVMXqAaE_Severance.webp|title=Tupper…? #Severance #VRChat #vrchatcommunity | ||
}}|Short about VRChat's Feedback Board.<ref>[https://www.youtube.com/watch?v=2nFVVMXqAaE Tupper…?] on ''YouTube''.</ref>}} | }}|Short about VRChat's Feedback Board.<ref>[https://www.youtube.com/watch?v=2nFVVMXqAaE Tupper…?] on ''YouTube''.</ref>}} | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
You cannot report bugs directly within VRChat, but you can submit bug reports pseudonymously on {{VRC link|https://feedback.vrchat.com|feedback.vrchat.com}} if you have a VRChat account. The platform uses a ticketing system powered by Canny.io, while VRChat employs a separate internal system to manage and track tickets. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== Glossary == | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
These are terms that will help you understand this article better. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
* '''<u>Bug:</u>''' ''A software defect or error, that can inconvenience the user. Also can be known as a "glitch".'' | |||
* '''<u>Build:</u>''' ''The 'version' that VRChat's software is running. Identifying a build number is crucial to identifying "when" the bug took place, within VRChat's constant line-up of updates. Please write the build number in your bug report. Open Beta uses a different build number than the 'Live' client build.'' | |||
* '''<u>Canny:</u>''' ''The service that VRChat utilizes to manage their feedback. "Post it on Canny" refers to feedback.vrchat.com.'' | |||
* <u>'''Debug menus'''</u>: ''There are various [[Debug Menu|menus for debugging]] for advanced users, including the Debug UI which can be opened within the Settings tab of the [[Quick Menu]].'' | |||
* '''<u>Hitching:</u>''' ''An abrupt 'lag spike', or freezing momentarily when triggered by VRChat trying to process an action. Such as "VRChat hitches and lags when I open the menu, or change into another avatar".'' | |||
* '''<u>Log files:</u>''' ''A text document that is generated locally on your device, as VRChat is being used. This provides useful information to the development team, as to which code might be triggering the bug.'' | |||
* '''<u>Reproduction:</u>''' ''Also known as 'repro'. Is the ability to trigger the bug on demand, by performing an action, or a series of actions. Example: "Opening the menu triggers and reproduces the bug."'' | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== Current builds == | |||
</div> | |||
{| class="wikitable" | {| class="wikitable" | ||
! Software | !<span lang="en" dir="ltr" class="mw-content-ltr">Software</span> | ||
! | !<span lang="en" dir="ltr" class="mw-content-ltr">Version</span> | ||
|- | |- | ||
|VRChat | |VRChat | ||
|{{Template:Version|live}} | |{{Template:Version|live}} | ||
|- | |- | ||
| | |<span lang="en" dir="ltr" class="mw-content-ltr">Client build</span> | ||
|{{Template:Version/Build|live}} | |{{Template:Version/Build|live}} | ||
|- | |- | ||
| SDK | |<span lang="en" dir="ltr" class="mw-content-ltr">Worlds SDK</span> | ||
|{{Template:Version|sdk-worlds}} | |{{Template:Version|sdk-worlds}} | ||
|- | |- | ||
| SDK | |<span lang="en" dir="ltr" class="mw-content-ltr">Avatars SDK</span> | ||
|{{Template:Version|sdk-avatars}} | |{{Template:Version|sdk-avatars}} | ||
|- | |- | ||
| Creator Companion | |<span lang="en" dir="ltr" class="mw-content-ltr">Creator Companion</span> | ||
|{{Template:Version|creator-companion}} | |{{Template:Version|creator-companion}} | ||
|- | |- | ||
| Line 41: | Line 59: | ||
|{{Template:Version|unity-sdk}} | |{{Template:Version|unity-sdk}} | ||
|} | |} | ||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== What you need for a bug report == | |||
[[File:Canny.webp|thumb]] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== Logging in === | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
To begin reporting a bug, please go to [https://feedback.vrchat.com feedback.vrchat.com], and proceed to Log In with your [[Special:MyLanguage/VRChat account|VRChat account]]. If you do not yet have a VRChat account, please proceed to [https://vrchat.com/home/register create one on the VRChat website], and optionally, [[Special:MyLanguage/Account Linking|link the accounts]] together. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Choose a topic that pertains to your bug report. Please also browse through the rest of the topic names, in case if the bug report can be submitted in a more specific thread. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
[[File: | * '''<u>Bug Reports:</u>''' ''For general bug reports on primary VRChat client builds.'' | ||
* '''<u>Open Beta:</u>''' ''For any bug reports that have occurred on an [[Special:MyLanguage/Open Beta|Open Beta]] build of VRChat.'' | |||
* <u>'''Website:'''</u> ''For issues regarding any of VRChat's websites.'' | |||
* '''<u>SDK Bug & Feature Requests:</u>''' ''For problems with the [[Special:MyLanguage/VRChat SDK|VRChat SDK]].'' | |||
* '''<u>Creator Companion:</u>''' ''For bug reports with the [[Special:MyLanguage/VRChat Creator Companion|VRChat Creator Companion]].'' | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Once a topic is selected, you can search various community threads to see if another user has already posted a bug report regarding the issue. If so, it is encouraged to upvote the post, and leave a comment if any specifications are not listed. If there is not a post that is yet submitted on the issue, please begin writing a bug report. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
[[File:Debug UIexample.webp|thumb|VRChat's Debug UI]] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== Logs and attachments === | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
[https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps Where do I find my Output Logs and Crash Dumps?] on [[Special:MyLanguage/Help.vrchat.com|''help.vrchat.com'']] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
It is advisable to attach screenshots, or a video file (up to 8MB) of the issue to your bug report. Any screenshots showcasing the bug, or screenshots of the debug menus will be relevant towards pinpointing the bug. Attaching log files are not always required, but is considered a helpful supplement to include within the bug report. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
[[File:Debug QM.webp|thumb|The Debug dropdown, within the settings tab of the Quick Menu]] | |||
To acquire a log file, navigate to the Settings tab within the Quick Menu, and scroll to the "Debug" dropdown. Click "Report Bug", which will mark a flagged timestamp within the output log. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== PC === | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
On PC, your file explorer will open to the folder where the output log is stored. By default, VRChat's output logs on a PC are located under <code>%USERNAME%\AppData\LocalLow\VRChat\vrchat</code> and named <code>output_log_(date)</code>. Check the latest dated file, and attach it to your bug report. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== Linux (via Proton)=== | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
The location of this folder depends heavily on your distribution<ref group="note" name="compatibility">VRChat on Linux via Proton is not directly supported unless you are using VRChat on the Steam Deck.</ref>and how you've installed Steam. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
You can usually find the Proton AppData folder for VRChat here: | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
~/.local/share/Steam/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat | |||
If you installed Steam via FlatPak, it might be here: | |||
~/.var/app/<flatpak-app-id>/(...?)/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
<references group="note" /> | <references group="note" /> | ||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== Meta and Oculus === | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
To get an output log, or crash dump on a Meta device: | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
# Navigate to the Settings page of your Quick Menu | |||
# Scroll down to the 'Debug' section | |||
# You'll find 3 options here: '''Full''', '''Errors Only''' or '''Off'''. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
Your output logs can be found in the <code>Documents/Logs</code> folder located in the device root when you've connected your Quest to a PC. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
=== Include a detailed description === | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
A detailed bug report should include a brief description of the bug within the title of the bug report, and the build number. Within the summary, please describe the device VRChat is running on, as well as steps on how to reproduce the bug. Describe the intended result, but what had occurred instead. | |||
[[File:Canny bug report.webp|thumb|An example of a good bug report, which includes a build number, description of the bug, proposed reproduction steps and observations, and an image file.]] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==== Template for reports<ref>[https://www.twitch.tv/vrchat/clip/SaltyAssiduousEchidnaAMPEnergy-TNqOCjdrYDHegiw9 What a Bug Report needs - Q&A Team StormRel] <!-- fallback video: https://youtu.be/YusV-Atlhog --></ref>==== | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
1. Summary | |||
> Explain in 2-3 Sentence what this report is about. Include the build number. | |||
VRChat crashed when trying to join a friend on build 1XXX. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
2. Steps to reproduce the bug: | |||
> Write down what you did step by step so someone else can see the problem. For example: | |||
1. Open Main Menu | |||
2. Visit any Profile | |||
3. Double Click "Join" Button | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
3. What did you expect to happen? | |||
> Explain what you thought would happen. For example: | |||
To join my friends. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
4. What actually happened? | |||
> Explain what went wrong. For example: | |||
VRChat crashed. | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
X. Additional details (if any): | |||
[ | > Add any other information. For example: | ||
* Logs (`%appdata%\..\LocalLow\VRChat\VRChat\`, need to be uploaded external) | |||
* Video (can be uploaded external, such as [https://studio.youtube.com/channel/%20/videos/upload?d=ud upload on YouTube]) | |||
* Screenshots (up to 8MB, or need to be uploaded external) | |||
* Links | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== See also == | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
* [[Special:MyLanguage/Open Beta|Open Beta]] | |||
* [[Special:MyLanguage/Quality Assurance|Quality Assurance]] | |||
* [[Special:MyLanguage/Reporting#Reporting a bug|Reporting#Reporting a bug]] | |||
* [[Special:MyLanguage/Guides:How to submit VRChat feedback|Guides:How to submit VRChat feedback]] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== Official resources == | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
* [https://help.vrchat.com/hc/en-us/articles/360062658413-I-found-a-bug-I-want-to-report-a-bug I found a bug/I want to report a bug] on [[Special:MyLanguage/Help.vrchat.com|''help.vrchat.com'']] | |||
* [https://help.vrchat.com/hc/en-us/articles/9521522810899-Where-do-I-find-my-Output-Logs-and-Crash-Dumps Where do I find my Output Logs and Crash Dumps?] on [[Special:MyLanguage/Help.vrchat.com|''help.vrchat.com'']] | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
== Community resources == | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
* [https://www.softwaretestinghelp.com/how-to-write-good-bug-report/ How to Write a Bug Report: Bug Reporting in Software Testing], by Vijay on ''www.softwaretestinghelp.com'' | |||
</div> | |||
<div lang="en" dir="ltr" class="mw-content-ltr"> | |||
==References== | |||
</div> | |||
<references /> | <references /> | ||
Revision as of 14:05, 8 March 2026
El siguiente artículo fue creado por la comunidad. Puede contener material no respaldado directamente por el equipo de VRChat. Para obtener más información, considera leer contribuir a la wiki de VRChat.
Puedes ayudar a la Wiki de VRChat corrigiéndola.
[Reason: Please proofread, and correct any errors on this page, utilizing the VRChat Wiki Manual of Style.]
[Reason: Please proofread, and correct any errors on this page, utilizing the VRChat Wiki Manual of Style.]
Writing and submitting bug reports to VRChat's Feedback Board effectively, will both help the development team narrow down the problem, and prevent the problem from happening again in the future.
Overview
Short about VRChat's Feedback Board.[1]
You cannot report bugs directly within VRChat, but you can submit bug reports pseudonymously on feedback.vrchat.com if you have a VRChat account. The platform uses a ticketing system powered by Canny.io, while VRChat employs a separate internal system to manage and track tickets.
Glossary
These are terms that will help you understand this article better.
- Bug: A software defect or error, that can inconvenience the user. Also can be known as a "glitch".
- Build: The 'version' that VRChat's software is running. Identifying a build number is crucial to identifying "when" the bug took place, within VRChat's constant line-up of updates. Please write the build number in your bug report. Open Beta uses a different build number than the 'Live' client build.
- Canny: The service that VRChat utilizes to manage their feedback. "Post it on Canny" refers to feedback.vrchat.com.
- Debug menus: There are various menus for debugging for advanced users, including the Debug UI which can be opened within the Settings tab of the Quick Menu.
- Hitching: An abrupt 'lag spike', or freezing momentarily when triggered by VRChat trying to process an action. Such as "VRChat hitches and lags when I open the menu, or change into another avatar".
- Log files: A text document that is generated locally on your device, as VRChat is being used. This provides useful information to the development team, as to which code might be triggering the bug.
- Reproduction: Also known as 'repro'. Is the ability to trigger the bug on demand, by performing an action, or a series of actions. Example: "Opening the menu triggers and reproduces the bug."
Current builds
| Software | Version |
|---|---|
| VRChat | 2026.2.2 |
| Client build | 1853 |
| Worlds SDK | 3.10.3 |
| Avatars SDK | 3.10.3 |
| Creator Companion | 2.4.5 |
| Unity | 2022.3.22f1 |
What you need for a bug report
Logging in
To begin reporting a bug, please go to feedback.vrchat.com, and proceed to Log In with your VRChat account. If you do not yet have a VRChat account, please proceed to create one on the VRChat website, and optionally, link the accounts together.
Choose a topic that pertains to your bug report. Please also browse through the rest of the topic names, in case if the bug report can be submitted in a more specific thread.
- Bug Reports: For general bug reports on primary VRChat client builds.
- Open Beta: For any bug reports that have occurred on an Open Beta build of VRChat.
- Website: For issues regarding any of VRChat's websites.
- SDK Bug & Feature Requests: For problems with the VRChat SDK.
- Creator Companion: For bug reports with the VRChat Creator Companion.
Once a topic is selected, you can search various community threads to see if another user has already posted a bug report regarding the issue. If so, it is encouraged to upvote the post, and leave a comment if any specifications are not listed. If there is not a post that is yet submitted on the issue, please begin writing a bug report.
Logs and attachments
It is advisable to attach screenshots, or a video file (up to 8MB) of the issue to your bug report. Any screenshots showcasing the bug, or screenshots of the debug menus will be relevant towards pinpointing the bug. Attaching log files are not always required, but is considered a helpful supplement to include within the bug report.
To acquire a log file, navigate to the Settings tab within the Quick Menu, and scroll to the "Debug" dropdown. Click "Report Bug", which will mark a flagged timestamp within the output log.
PC
On PC, your file explorer will open to the folder where the output log is stored. By default, VRChat's output logs on a PC are located under %USERNAME%\AppData\LocalLow\VRChat\vrchat and named output_log_(date). Check the latest dated file, and attach it to your bug report.
Linux (via Proton)
The location of this folder depends heavily on your distribution[note 1]and how you've installed Steam.
You can usually find the Proton AppData folder for VRChat here:
~/.local/share/Steam/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat If you installed Steam via FlatPak, it might be here: ~/.var/app/<flatpak-app-id>/(...?)/steamapps/compatdata/438100/pfx/drive_c/users/steamuser/AppData/LocalLow/VRChat/VRChat
- ↑ VRChat on Linux via Proton is not directly supported unless you are using VRChat on the Steam Deck.
Meta and Oculus
To get an output log, or crash dump on a Meta device:
- Navigate to the Settings page of your Quick Menu
- Scroll down to the 'Debug' section
- You'll find 3 options here: Full, Errors Only or Off.
Your output logs can be found in the Documents/Logs folder located in the device root when you've connected your Quest to a PC.
Include a detailed description
A detailed bug report should include a brief description of the bug within the title of the bug report, and the build number. Within the summary, please describe the device VRChat is running on, as well as steps on how to reproduce the bug. Describe the intended result, but what had occurred instead.
Template for reports[2]
1. Summary > Explain in 2-3 Sentence what this report is about. Include the build number. VRChat crashed when trying to join a friend on build 1XXX.
2. Steps to reproduce the bug: > Write down what you did step by step so someone else can see the problem. For example: 1. Open Main Menu 2. Visit any Profile 3. Double Click "Join" Button
3. What did you expect to happen? > Explain what you thought would happen. For example: To join my friends.
4. What actually happened? > Explain what went wrong. For example: VRChat crashed.
X. Additional details (if any): > Add any other information. For example:
- Logs (`%appdata%\..\LocalLow\VRChat\VRChat\`, need to be uploaded external)
- Video (can be uploaded external, such as upload on YouTube)
- Screenshots (up to 8MB, or need to be uploaded external)
- Links
See also
Official resources
Community resources
- How to Write a Bug Report: Bug Reporting in Software Testing, by Vijay on www.softwaretestinghelp.com
References
- ↑ Tupper…? on YouTube.
- ↑ What a Bug Report needs - Q&A Team StormRel
