Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration

To adjust Vinegar or Roblox's behavior, the configuration may be edited, which can be done by opening Vinegar and pressing the settings button in the top left.

Note: You only need to edit the configuration file if you want to fine tune Roblox's behavior. Having a configuration file is completely optional!

Anything added to the configuration file is an override over the default configuration.

Configuration Values

NameDescriptionDefault
sanitize_envSanitize the global environment , hand-picked variables are allowed through.false

If you're using the Flatpak, ensure that the path of the wineroot configuration option is allowed access from the Flatpak, as if it is a path outside of ~/.var/app/org.vinegarhq.Vinegar Vinegar won't be able to access the directory: flatpak override --user --filesystem=/path/to/wineroot

SectionDescription
[studio]Binary configuration for Studio
[env]Global environment

Studio Configuration

This section are the available options for Studio ([studio], they are specified under their sections as listed above.

OptionDescriptionDefault
gamemodeautomatically enable gamemode via D-Bus desktop portals.true
winerootthe path to a valid Wine 'root' installation directory.none
launcherthe program that is used to launch Wine when launching Roblox; this can be set to gamemoderun.none
quiethides Roblox's log output within Vinegar's logfalse
rendererselects the rendering engine to be used by Roblox via FFlags."D3D11"
discord_rpcuse Discord's rich presence alongside handling the BloxstrapRPC protocol.false
forced_versionforces Vinegar to use a specific version, the release channel must be adjusted for the version.none
channelthe deployment channel to be used; DO NOT CHANGE, ONLY KEPT FOR DEVELOPERS"LIVE"
dxvkautomatically uses DXVK for the application and installs if necessary.true
dxvk_versionthe DXVK version to be used; this can be set to legacy DXVK for old GPUs that don't support modern Vulkan."2.5.3"
gputhe GPU which Vinegar should use for running Roblox, see below table for valid values."prime-discrete"

The renderer must be one of the following: "OpenGL", "D3D11FL10", "D3D11", "Vulkan"; when using DXVK, ensure that the renderer is "D3D11", otherwise Roblox will not utilize DXVK.

Sub-sections for FFlags and environment variables are specified with the section (eg. [studio.env])

Sub-sectionDefault
[fflags]Player: DFIntTaskSchedulerTargetFps = 640
[env]none

Refer to the following table for valid gpu values:

ValueEffect
"prime-discrete"Runs Roblox with your discrete gpu.
"integrated"Runs Roblox with your integrated graphics.
""Skip logic; leave gpu choice up to your Vulkan/OpenGL drivers. Vulkan typically chooses the fastest gpu in your system, while OpenGL chooses the default.
"<int>"Runs Roblox with the gpu corresponding to the given index. Go to Vinegar > About > Debug information to show a list of GPUs Vinegar detects.

On non-PRIME systems, "prime-discrete" and "integrated" have the same effect as "".

Example configuration

Note: The following configuration file is not meant to be copied or used. It is only shown for demonstrating how the configuration values above are laid out in the actual file.

# DO NOT COPY, USE ONLY AS EXAMPLE

[env]
WINEFSYNC = "1"

[studio]
wineroot = "/home/meow/wine-ge"
dxvk = false
renderer = "Vulkan"

[studio.env]
DXVK_HUD = "0"
MANGOHUD = "1"

[studio.fflags]
DFIntTaskSchedulerTargetFps = 144