Note To Pop!_OS/Kali Linux users

Please notice that the distro you are using is not capable of building Wine, due to many conflicts in 32/64 bit packages.

You must change distro in order to build Wine.

Also, don't use Kali Linux as your main distro, especially not with the default password.
If you're using other distros, just ignore this section and read below.

<br>

The Ultimate Roblox on Linux Guide

This is a guide on building wine-tkg-git for Roblox as well as a couple of workarounds for issues, originally by Nyan cat#8349.

It includes the following patches and improvements:

• Right-click mouse fix (by applying a patch)
• Black cursor studio bug (by reverting the commit that caused it)

This guide is rapidly changing, so please pay attention to the date at which it was updated. If it was updated while you were following it, start over.

In order to start this guide, jump over to the steps to compile section if you want to install Wine and Roblox.

Alternatively, you can hop over to the video guide section in case you prefer to follow a video guide (although compilation is recommended).

In case you run into any issues while compiling, you can hop over to the common compilation errors section.

If you run into any problems while trying to actually play the game or use Wine in general, take a look at the common errors or issues section.

<br>

Notice to video guide creators

If you are creating a video guide (YouTube, etc.) please attach a link to this guide in the pinned comments, as well as the description.

Mention of the Discord tag is optional but preferred.

If you are telling people to download a precompiled version of Wine in your guide, please mention it as such.

<br>

Video guide

Here's a video guide on YouTube. Do note that it tells you to download a precompiled version of Wine, which may contain malware or behave unexpectedly:

YouTube

CloudTube

<br>

Getting in touch

You can get in touch on the Grapejuice Discord server: https://discord.gg/mRTzEb6

Make sure to follow the rules and ask your question in one of the help channels. Do not post your question in multiple channels.

<br>

Steps to compile

<details open> <summary>Click to fold/unfold</summary>

Note to Arch Linux users

"it is not really the most up to date" -Package Maintainer

wine-tkg-roblox^AUR applies the patches automatically and builds wine.

1. Clone the wine-tkg-roblox git repository: git clone https://aur.archlinux.org/wine-tkg-roblox.git
2. Enter the just cloned directory: cd wine-tkg-roblox
3. Install the patched wine: makepkg -si

Or install the wine-tkg-roblox^AUR using your preferred AUR package manager

If you are not using Arch Linux or are not using the AUR package, follow the guide below

1. Clone the wine-tkg-git repository:
   git clone https://github.com/Frogging-Family/wine-tkg-git.git
2. Enter the just cloned directory:
   cd wine-tkg-git
3. Download the patch file:
   curl https://raw.githubusercontent.com/NyanCatTW1/robloxWineBuildGuide/main/roblox-wine-staging-v2.5.patch --output roblox-wine-staging-v2.5.patch
4. Apply the patch:
   git apply roblox-wine-staging-v2.5.patch
5. Change to the source folder:
   cd wine-tkg-git
6. Edit customization.cfg to fit your needs (optional)
7. Install dependencies:
   • If you are on Arch Linux, skip this step
   • If you are on Debian/Debian-based (Ubuntu, etc): change _nomakepkg_dep_resolution_distro="" to _nomakepkg_dep_resolution_distro="debuntu" in customization.cfg. Then, run sudo dpkg --add-architecture i386 && sudo apt update && sudo apt upgrade && sudo apt install autoconf libxi-dev libvulkan-dev
   • If you are on Fedora-based: change _nomakepkg_dep_resolution_distro="" to _nomakepkg_dep_resolution_distro="fedora" in customization.cfg
   • If you are on Solus-based: Use the following two commands to install everything you need:

<details> <summary>Show/hide the commands</summary>

64 bit dependencies
sudo eopkg install mingw-w64-gcc alsa-lib-devel pulseaudio-devel dbus-devel fontconfig-devel freetype2-devel libgnutls-devel libnotify-devel libjpeg-turbo-devel libpng-devel libtiff-devel mesalib-devel gst-plugins-good libxml2-devel libxmu-devel libxslt-devel faudio-devel gstreamer-1.0-devel faudio gstreamer-1.0-plugins-base-devel ccache libx11-devel libxi-devel ldb-devel sdl2-devel vulkan ocl-icd-devel
32 bit dependencies
sudo eopkg install mingw-w64-gcc-32bit alsa-lib-32bit-devel pulseaudio-32bit-devel dbus-32bit-devel fontconfig-32bit-devel freetype2-32bit-devel libgnutls-32bit-devel libnotify-32bit-devel libjpeg-turbo-32bit-devel libpng-32bit-devel libtiff-32bit-devel mesalib-devel libxml2-32bit-devel libxmu-32bit-devel libxslt-32bit-devel faudio-32bit-devel gstreamer-1.0-32bit-devel faudio-32bit gstreamer-1.0-plugins-base-32bit-devel libx11-32bit-devel libxi-32bit-devel unixodbc-32bit-devel unixodbc-32bit-devel unixodbc-32bit-devel libpcap-32bit-devel glibc-32bit-devel sdl2-32bit-devel libgcrypt-32bit-devel vulkan-32bit ocl-icd-32bit-devel libusb-32bit-devel

</details>

• If none of the above describes your distro: You need to install the dependencies yourself. A list of them are at https://wiki.winehq.org/Building_Wine#Satisfying_Build_Dependencies, You need the Needed for many applications ones as well.
  Make sure to check the common compilation errors section in case you hit any weird issues.
• Tip: You can install ccache on any distro mentioned above to speed up the 2nd time you compile by as much as 6 times.

8. Compile:
   • If you are on Arch Linux: makepkg -si
   • If you are on another distro (Debian, Fedora): ./non-makepkg-build.sh
   • If the script complains No _LOCAL_PRESET set in .cfg. Please select your desired base (or hit enter for default) : Choose 0 (default-tkg) or simply press enter.
   • If you encounter any issues, errors or low performance, please look if they are mentioned in this guide. You can use CTRL + F in your browser to search for any errors mentioned here.
   • Get in touch if you have any further questions!
9. Getting the Wine path
   • If you are on Arch Linux: ignore this step
   • If you are on other distros:
     • cd non-makepkg-builds (If this command failed, the build probably failed too.)
     • ls
     • Look for a folder that looks something like: wine-tkg-staging-fsync-git-6.14.r7.g05c42b1d
     • Run realpath <name of the folder here> to get the full path to the folder, which we will later use in Grapejuice.
10. Installing Grapejuice:

• Go to this link and follow the instructions specific to your distribution.

11. Configuring Grapejuice to use Wine:

• If you are on Arch Linux: Make sure you uninstall Wine that came with the distro, you should also set wine_home to "/usr" according to the steps below. In case the wine command is not found, repeat Step 8.
• If you are on other distros:
  • Open ~/.config/brinkervii/grapejuice/user_settings.json in your text editor.
  • Set every wine_home fields to the path you found in step 9. (There are multiple of them!)

12. Try it out:

• Press the Play button on any game on roblox.com
• If you encounter any issues, errors or low performance, please look if they are mentioned in this guide. You can use CTRL + F in your browser to search for any errors mentioned here.
• Get in touch if you have any further questions!

</details> <br>

Installing DXVK (DirectX over Vulkan)

<details open> <summary>Click to fold/unfold</summary> <br>

DirectX over Vulkan (DXVK) is a translation layer for Direct3D 9/10/11 which converts Direct3D API Calls over to native Vulkan using Wine.

DXVK greatly improves game 3D performance. Installation is quick and simple, resulting in amazing performance.

Follow the instructions below to install DXVK in your Grapejuice wine prefix.

(As it work better than DXVK on some devices, you should also try the Vulkan renderer, which can be done by skipping to step 4 once you've done step 1.)

<br>

1. Verify Vulkan is installed. [Skip if already installed]:

• Vulkan is supported and integrated with most graphics drivers offered by most popular distributions. You most likely already have Vulkan drivers.
• To verify if Vulkan is installed, install the vulkan-tools package from your distribution's package manager.
• Once the utility is installed, run vkcube from your terminal. If a test window appears with a spinning cube, Vulkan is installed in your system.
• If Vulkan is not installed, update your graphics drivers and verify your GPU or intergrated graphics support Vulkan.

2. Downloading DXVK through grapejuice:

• Go to the wineprefix that you want to install DXVK on, in this case it's the "Player" prefix
• Scroll down to the third party section, which is at the bottom
• Toggle the "Use DXVK D3D implementation" toggle, Grapejuice should now start downloading DXVK.

3. Verify that Direct3D 10 or 11 is running in Roblox:

• To make sure DXVK is working, confirm Roblox is running Direct3D 10/11. [D3D9 is not supported as of August 2021]
• In Roblox, use the keyboard shortcut Shift+F2 to see an information box in the bottom left of your screen.
• In the Graphics information section, you should see D3D11 or D3D10 as the rendering engine.

4. **Force Roblox to use ano