Launch Options

📘

Advanced Options

These options are more advanced and designed to help creators debug issues with their creations.

There are several launch options available for VRChat.

If you are using Steam, you can set these easily in the Properties for VRChat, found by right-clicking on VRChat's entry in your game list. After clicking Properties, click on Set Launch Options, then put your desired launch options in.

If you are using Oculus PC, you must create a shortcut to the VRChat executable. After launching Oculus Home, launch this shortcut by clicking its icon. The Oculus launcher does not support launch options natively.

Oculus Quest does not support any of these launch options.

Launch Option

Description

--no-vr

Forces Desktop mode

--profile=X

Launches with a different user profile, where X is a number. 0 is the default profile

--fps=X

Overrides the FPS cap to X instead of the default. On Desktop, 90 is the default. In VR, the headset's reported maximum refresh rate is the default.

--enable-debug-gui

Enables debug menu shortcuts, see Keyboard and Mouse for shortcut keys

--enable-sdk-log-levels

Enables a large amount of additional logging.

Warning: Will cause your log to get VERY large!

Using this option may reduce performance due to the increased logging, don't leave it on!

--enable-udon-debug-logging

Enable Udon heap and stack dumps in the client. Usually only enabled in editor

Warning: May cause your log to get quite large in Udon worlds that are having issues!

Using this option may reduce performance due to the increased logging, don't leave it on!

--legacy-fbt-calibrate

Forces the legacy method of Full-Body Tracking calibration.

Not recommended!! May be removed at a future point in time.

--midi=deviceName

Forces the MIDI drive to search for a connected MIDI device which contains the deviceName specified, including partial matches, case-insensitive

--watch-worlds

Watches the location where the VRChat SDK builds worlds, and automatically joins any new local world created.
See Using Build & Test

--watch-avatars

Watches the location where the VRChat SDK builds test avatars, and if wearing a test avatar that's been updated automatically switches to the newer version.

--osc=inPort:outIP:outPort

Customize network settings for incoming/outgoing OSC messages.
Accepts the following 3 arguments:

  • inPort: The port that the VRChat client should listen on for incoming OSC messages.
  • outIP: The IP that outgoing OSC messages should be sent to.
  • outPort: The port that outgoing OSC messages should be sent to.

--custom-arm-ratio="0.4537"

Adjusts the ratio used to scale the avatar when using measure-by-arms mode.

"0.4537" is the default value. Smaller values around "0.415" may give improved fit.

--disable-shoulder-tracking

Use this to avoid issues with some types of IMU-only based arm trackers

--enable-ik-debug-logging

Adds additional output to the log regarding IK. Use this when reporting bugs or issues with IK

Using this option may reduce performance due to the increased logging, don't leave it on!

--calibration-range="0.6"

Determines the distance from predicted supported binding points that the calibration will search (in meters). This search radius is a sphere. The closest binding point to the center of the search sphere will be used.

The default value is 0.6 meters (60 cm). This applies to feet, thighs, hip, upper arms, and chest trackers

--freeze-tracking-on-disconnect

Enabling this will cause trackers to freeze in place relative to the player when they are disconnected.

To remove frozen trackers you can calibrate again. If all your trackers have disconnected so the calibration option is no longer visible, cycling the Avatar Measurement option will also unfreeze them

Resolution and Screen Choice

Unity 2019 removed the ability to launch a dialog by holding shift/alt when launching, but you can use launch arguments to replace much of that functionality.

Launch Option

Description

-screen-width

Override the default screen width. This must be an integer from a supported resolution.

-screen-height

Override the default screen height. This must be an integer from a supported resolution.

-screen-fullscreen

Override the default full-screen state. This must be 0 or 1.

-screen-quality

DOES NOT WORK - just listing it because you might try it and get confused.

-monitor N

Run Standalone Player on the specified monitor, indicated by a 1-based index number.

You can find them here, under the "Unity Standalone Player command line arguments" section.
Note that most (if not all) of the force launch options will cause issues that prevent you from using VRChat.

Ensure that you select the correct version of Unity using the selector in the top left. Refer to the Currently Supported Unity Version page to see what version VRChat is currently using.


Did this page help you?