Skip to content

Instantly share code, notes, and snippets.

@Hazsi
Last active May 9, 2024 07:52
Show Gist options
  • Star 9 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save Hazsi/2448016c5d561a556661d9af0a82fa20 to your computer and use it in GitHub Desktop.
Save Hazsi/2448016c5d561a556661d9af0a82fa20 to your computer and use it in GitHub Desktop.
Guide to using Vape V4 on Linux/macOS under Wine.

Hello there! 👋

Despite the fact that many people on the forums have said it isn't possible, using the latest version of Vape V4 on Linux via Wine is very much possible, and I was able to do it in under an hour of trial and error. I'm using Pop OS, but you can likely get it to work with any version of Linux (and potentially macOS, although I haven't tried).

Of course, this is obviously not supported. If this doesn't work for you, I can try my best to help, but obviously Manthe/Vape support will not help you at all. Please do not bother them with this. Some features may be broken; I'm personally struggling to get profile saving to work correctly (I'm not sure why)

If you're looking for a crack or anything like that, you won't find that here. You obviously need to own Vape for this to work.

1. Installing Wine.

First things first, you need to install Wine. If you don't know, Wine is a free and open source program that attempts to allow Windows software to run on UNIX like operating systems (Linux, macOS, BSD, etc).

Install Wine via your distributions package manager - mine is apt-get, but I'm assuming you'll know how to use yours.

# apt-get:
$ sudo apt-get install wine

# pacman:
$ sudo pacman -S wine

# brew (macOS):
$ brew tap homebrew/cask-versions
$ brew install --cask --no-quarantine wine-stable

Before going any further, we need to set up Wine to "emulate" Windows 10, not XP, by running winecfg.

You should see a window like this - select Windows 10 and close winecfg.

2. Installing a Windows JRE.

In order for the Vape launcher to detect Minecraft and be able to correctly attach to it and load its DLL/classes, we need to be running Minecraft itself via Wine. Before we can do this however, we need to have a Windows JRE installed.

I wasn't able to get the official JRE working, but had success using the Azul JRE (used by Lunar Client). I want to use Minecraft 1.8, so I will use Java 8. If you're trying to play on a newer version of Minecraft, you'll need a newer JRE.

Head on over to the Azul JRE download page. Scroll down and select your Java version (Java 8 if you want to only play Minecraft 1.7 or 1.8, this is also what I'm covering here). Select Windows as your operating system, x86 64-bit as your architecture, and JDK as your package. Make sure you download the zip, as I wasn't able to get the installer to run under Wine.

Where exactly we extract the JRE to doesn't matter, as we'll select it manually later. However, it needs to be in Wine's virtual C drive. Wine stores its virtual C drive at ~/.wine/drive_c. Let's make a Java directory in Program Files.

$ mkdir -p ~/.wine/drive_c/Program\ Files/Java

Now, we can extract our JRE and move it into our Wine's Java directory. The name of the file you downloaded might not be the same as mine, depending on region and your Java version. You should be able to simple start typing "zulu" and press tab. Replace all instances of my file name with your version.

$ cd ~/Downloads
$ unzip zulu8.68.0.21-ca-jre8.0.362-win_x64.zip
$ mv ./zulu8.68.0.21-ca-jre8.0.362-win_x64/ ~/.wine/drive_c/Program\ Files/Java/zulu8.68.0.21-ca-jre8.0.362-win_x64/

Assuming this all went to plan, we should now be able to test our new Java installation:

$ cd ~/.wine/drive_c/Program\ Files/Java/zulu8.68.0.21-ca-jre8.0.362-win_x64/
$ cd bin
$ wine ./javaw.exe -version
openjdk version "1.8.0_362"
OpenJDK Runtime Environment (Zulu 8.68.0.21-CA-win64) (build 1.8.0_362-b09)
OpenJDK 64-Bit Server VM (Zulu 8.68.0.21-CA-win64) (build 25.362-b09, mixed mode)

3. Installing Minecraft

We now have a working installation of Wine, and a Windows Java environment to run Minecraft under. Now, we just need to install Minecraft!

I'm going to be using MultiMC for this guide, as I wasn't able to get the official Minecraft launcher to run under Wine. I was able to get Lunar Client installed, but couldn't consistently get it running (I suspect Electron has some issues under Wine). If anyone reading this is able to get Lunar working, please let me know and I'll update the guide!

Head on over to the MultiMC website, scroll down to the Download & Installation section, and click on the Windows download button.

Unlike our JRE, we don't need to move this anywhere special. Simply extract it, and we can set it up with Wine.

$ cd ~/Downloads
$ extract mmc-develop-win32.zip
$ cd ./MultiMC
$ wine ./MultiMC.exe

After selecting your language, you'll be faced with a screen asking you to select a Java installation to run Minecraft under. We'll need to select our Azul installation from the last step, which probably won't be automatically detected. Click on browse, and we can navigate to where we extracted our JRE to. Select javaw.exe in the bin directory, like so:

Click on Open, and Next. Click on Finish, and you should be greeted with MultiMC's main screen. Congratulations! We now have a Minecraft launcher running under Wine! While this might not seem remarkable, remember that this is a native Windows program running under your UNIX-like OS!

Select the version you want to use (1.8.9 for this tutorial, remember that newer versions of Minecraft won't work with the JRE we're using!). Now, double click the Minecraft installation. After downloading the game, Minecraft should now open! Congratulations!

Remember, this is a separate installation of Minecraft. You'll need to set up your settings/keybindings again, and copy your resource packs and saves over. If you are unfamiliar with MultiMC, your.minecraft folder (and thus resource packs, saves, etc.) will be located at ~/Downloads/MultiMC/instances/1.8.9/.minecraft/.

3.1. Adding Optifine to Minecraft (optional)

In order to add Optifine to your Minecraft installation, run your new installation once normally first. Then, go to the Optifine Download page, click Show all versions, and download Minecraft 1.8.9 (or whatever Minecraft version you are using). Alternatively, you can access it directly here.

Let's run the Optifine JAR. We don't need to use our special Wine JRE for this, you can use whatever JRE you have installed.

$ cd ~/Downloads
$ java -jar OptiFine_1.8.9_HD_U_M5.jar 

Once the Optifine launcher opens, click on extract. Extract to your Downloads, or wherever you want. You can delete it after.

Now, go back into MultiMC. Right click on your installation from before and click on Edit Instance. Click on Version on the left, and then Add to Minecraft.jar. Navigate to the Optifine JAR we extracted. Make sure you select the jar ending in _MOD, NOT the original Optifine JAR you downloaded.

Launch Minecraft, and you should now have Optifine installed!

4. Preparing Vape

Before injecting Vape, we'll need to set our HWID. Head on over to the Vape HWID page, and download the exe. Run it using wine, just like we've done with every exe so far:

$ cd ~/Downloads
$ wine ./hwid.exe

This window should pop up, and your HWID should be copied. Just in case it doesn't copy, the title of the window displays your HWID as well.

From my testing, the HWID under Wine is always 0, but I haven't tested under macOS. Regardless, don't be alarmed by this. Go back to the HWID page, and paste in your newly created HWID.

Now, we're ready to go ​download Vape V4​​​. Just like before, we'll run it under Wine.

$ cd ~/Downloads
$ mv aNFvhZ9Ka1.exe VapeV4.exe # Whatever your Vape download was called
$ wine ./VapeV4.exe

If you are still having issues with crashing, try messing around with video settings and memory allocation. I've found more consistent results without mipmapping or VSync, as well as allocating a full 8GB to Minecraft in MultiMC.

NOTE TO I3WM USERS: If your Minecraft has no title (note how all the screenshots in this section have the ugly border!) you WILL CRASH ON INJECTION! This took me ages to figure out. Toggle F11 on and off (maybe repeatedly!), and you should manage to get these borders. This seems to be an i3/Wine bug. If you don't use i3, you should be able to ignore this.

5. Conclusion

That's it! When I first wanted to do this myself, I saw many people on the forums try to ask for help doing this, only to be told that it's impossible. As a few people were smart enough to point out, the Vape V4 launcher is protected using Themida, which is designed to make debugging/tampering with the injection process harder. People are falsely under the impression that Themida makes this process more difficult, or attempts to block Vape from running under a VM, which is false. The ability to do this isn't a security issues on Vape's end, and this isn't anything secret that I'm sharing.

image

Like I mentioned at the start, this is a janky process, and you may experience random crashes and issues while using Vape. However,on my own testing, I have been able to enable Blatant Mode and use all modules without crashing. This is perfectly safe, and you will not get your Vape account in trouble, nor is it any less safe on Hypixel or whatever you play on. (Be safe like always :P)

Let me know what you think! I hope this was able to help some of you!

Have a great day! 😄

@Zemethepadawod
Copy link

hazsi i see you online please help me

@Zemethepadawod
Copy link

wait does the thing say active when someone speaks in this

@Zemethepadawod
Copy link

oh my god it does im so stupid

@RjManhas
Copy link

RjManhas commented Dec 4, 2023

hey can you add me on discord im having a issue
ragewire

@Euro-pol
Copy link

Euro-pol commented Dec 5, 2023

just comment the issue

@linthuriya
Copy link

@Hazsi How do i fix
image

@linthuriya
Copy link

@SylveonBottle
Copy link

SylveonBottle commented Jan 25, 2024

Minecraft loads, vape always fails to launch no matter what visual settings in Minecraft I use. Using Mac Monterey.

Screen Shot 2024-01-25 at 5 38 07 PM

@auvio323
Copy link

auvio323 commented Feb 25, 2024

Minecraft loads, vape always fails to launch no matter what visual settings in Minecraft I use. Using Mac Monterey.
Screen Shot 2024-01-25 at 5 38 07 PM

I have the same error as you on Arch Linux, tried using wine stable and wine-tkg-staging-fsync-git, both got the same error. Openlogic JRE 8 installs without a hitch and java works, MultiMC runs fine, Minecraft launches, the HWID program launches, but the VapeV4.exe does not, and gives that error. Has a Vape update broken compatibility with wine ?

@SylveonBottle
Copy link

SylveonBottle commented Feb 25, 2024

I have the same error as you on Arch Linux, tried using wine stable and wine-tkg-staging-fsync-git, both got the same error. Openlogic JRE 8 installs without a hitch and java works, MultiMC runs fine, Minecraft launches, the HWID program launches, but the VapeV4.exe does not, and gives that error. Has a Vape update broken compatibility with wine ?

The only thing that I know of is that vape now caches files to improve launch speed.
I just ended up bootcamping windows 10 onto my machine. However, vape took such a hit on performance that you’re probably better just using Ravenb+ on Mac.

If you want, I can share a custom performance mod pack that focuses entirely on maximizing performance on low end computers. With lunar client and every visual hud disabled, every mod disabled, I got about ~120 fps in a super flat. With the most popular FPS pack on modrinth I got ~180. My own pack got 250+ I was able to consistently get around 40–60 FPS playing hypixel, so vape’s features made it worth running windows to me. I can’t imagine speedbridging with only 40 fps.

@auvio323
Copy link

I have the same error as you on Arch Linux, tried using wine stable and wine-tkg-staging-fsync-git, both got the same error. Openlogic JRE 8 installs without a hitch and java works, MultiMC runs fine, Minecraft launches, the HWID program launches, but the VapeV4.exe does not, and gives that error. Has a Vape update broken compatibility with wine ?

The only thing that I know of is that vape now caches files to improve launch speed. I just ended up bootcamping windows 10 onto my machine. However, vape took such a hit on performance that you’re probably better just using Ravenb+ on Mac.

If you want, I can share a custom performance mod pack that focuses entirely on maximizing performance on low end computers. With lunar client and every visual hud disabled, every mod disabled, I got about ~120 fps in a super flat. With the most popular FPS pack on modrinth I got ~180. My own pack got 250+ I was able to consistently get around 40–60 FPS playing hypixel, so vape’s features made it worth running windows to me. I can’t imagine speedbridging with only 40 fps.

I don't have performance issues on my hardware.

I mainly use Linux based OS on my computers, and I have a Windows PC with Sunshine that I use whenever I need to run Windows specific apps, I generally don't use Windows specific apps but whenever I do it's usually games and thats why I use that PC. However, when using Mysterium Dark VPN on Windows, it for some reason blocks the LAN on my default gateway, and I can't really fix this since Windows doesn't have any way to do so- it has to be implemented by the VPN application. I use the LAN to stream the computer over the network to my computer seamlessly via the Moonlight client on my Linux PC which connects to Sunshine on my windows PC, that way I can run it headless. Since this VPN (I want to use to evade ban in Minecraft servers since Mysterium dark gives cheap resedential IPS) blocks Lan, I can't access my PC over the network and thus I can't use VapeV4, unless I plug a physical HDMI cable, which is the sloppy solution I am using currently.

If it worked via Wine, it would make it way easier since it would be smoother, I wouldn't have to remote to that PC, and use Mysterium dark. I have gotten several heavily windows dependent apps running on Linux through wine with configuration, I just don't know what broke VapeV4 in the first place. I also don't know what dependencies it needs either. If someone knows what changed in VapeV4 that caused it not to work, there could be a solution. But VapeV4 was never supposed to support Linux as it was clearly stated that it was Windows only, so I'm not blaming them, although it would be nice if there was a solution.

@nobleststriver
Copy link

Would this work on Steam Deck with Lunar Client?

@shard77
Copy link

shard77 commented Apr 2, 2024

Did someone manage to get that working using wine-ge inside lutris? Would love to hear about someone actually having this working.
@iFlxy is this working on your side? I've tried using wine-ge and lutris-ge, both crash at injection.

@b2nzy
Copy link

b2nzy commented Apr 19, 2024

Did someone manage to get that working using wine-ge inside lutris? Would love to hear about someone actually having this working. @iFlxy is this working on your side? I've tried using wine-ge and lutris-ge, both crash at injection.

Not yet, seems. can't load a class in stage 11

Exception in thread "" java.lang.NoClassDefFoundError: cpw/mods/modlauncher/TransformingClassLoader Caused by: java.lang.ClassNotFoundException: cpw.mods.modlauncher.TransformingClassLoader at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)

@shard77
Copy link

shard77 commented Apr 20, 2024

Did someone manage to get that working using wine-ge inside lutris? Would love to hear about someone actually having this working. @iFlxy is this working on your side? I've tried using wine-ge and lutris-ge, both crash at injection.

Not yet, seems. can't load a class in stage 11

Exception in thread "" java.lang.NoClassDefFoundError: cpw/mods/modlauncher/TransformingClassLoader Caused by: java.lang.ClassNotFoundException: cpw.mods.modlauncher.TransformingClassLoader at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)

Yep. I get the same error.

@yangbaoqi1
Copy link

Did someone manage to get that working using wine-ge inside lutris? Would love to hear about someone actually having this working. @iFlxy is this working on your side? I've tried using wine-ge and lutris-ge, both crash at injection.

Not yet, seems. can't load a class in stage 11
Exception in thread "" java.lang.NoClassDefFoundError: cpw/mods/modlauncher/TransformingClassLoader Caused by: java.lang.ClassNotFoundException: cpw.mods.modlauncher.TransformingClassLoader at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:188) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)

Yep. I get the same error.

i also get this error on mac ventura with crossover 24 pls help me qwq

@yangbaoqi1
Copy link

@KevinTheScripter
Copy link

bro this is outdated and has 100% on crashing I gotta get windows computer 🤧

@shard77
Copy link

shard77 commented May 9, 2024

I'm sure theres a way to fix this.. no idea how tho

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment