Skip to content

Instantly share code, notes, and snippets.

@lewislarsen
Last active April 7, 2025 12:54
Show Gist options
  • Save lewislarsen/d0aa7c63f8591948983aa3aea0f2a365 to your computer and use it in GitHub Desktop.
Save lewislarsen/d0aa7c63f8591948983aa3aea0f2a365 to your computer and use it in GitHub Desktop.
Allowing runelite to go through a vpn split tunnel on macos

Instructions

These instructions may vary, but they should work.

  1. Add Runelite.app (in your Applications folder) to the VPN's split tunnel through its GUI.
  2. Configure RuneLite:
    • Open a terminal and paste the following command:
      /Applications/RuneLite.app/Contents/MacOS/RuneLite --configure
    • Add -Djava.net.preferIPv4Stack=true under the JVM Arguments section of the GUI that opens and click Save.
  3. Edit the configuration file:
    • Open the configuration file by running:
      nano /Applications/RuneLite.app/Contents/Resources/config.json
    • Add -Djava.net.preferIPv4Stack=true under vmArgs and save the file.
  4. Launch RuneLite.

These steps should work regardless of whether you're using the Jagex Launcher, as the launcher only triggers the application to open and isn't in direct control of it.

Thanks to this issue GitHub Issue #15098 for all the help.

I am using Mullvad, and it seems to work for me.

@cdfisher
Copy link

cdfisher commented Apr 7, 2025

Please don't recommend that people edit their config file manually as you do in step 3. This is something we very strongly discourage people from doing, as manually editing the config makes it super easy to break things.

Steps 2 and 3 can be accomplished simply by checking the "IPv4" box in the "configure" window. If that option isn't present, you need to update your launcher, which can be done by following the steps here.

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