1
Fork 0
mirror of https://github.com/redstrate/LauncherTweaks.git synced 2025-05-20 17:37:46 +00:00
launchertweaks/README.md
Joshua Goins f17c70d3ac Add option to disable WebView2 install and boot version checks
These use terribly made function sigs but do work. WebView2 keeps
failing to install, so this is actuallt quite useful for me.
2025-04-22 15:45:08 -04:00

2.2 KiB

LauncherTweaks

Tweaks for the official FFXIV launcher.

Features

  • Configure the launcher URL, enabling you to write custom launcher pages.
  • Force the launcher/boot executable to use the system proxy. (The web browser portions of the launcher already use the system proxy.)
  • Bypasses the (soft) WebView2 requirement introduced in Patch 7.21.
  • Disable the boot version check.

Usage

Grab a build from GitHub Actions or build the project with the instructions below. Then, place the winmm.dll next to the launcher.

To configure the launcher URL, place a launchertweaks.toml next to the launcher executable:

# Must be able to serve a index.html or else the launcher 404s:
launcher_url = "https://launcher.mysite.localhost/"

macOS/Linux

Wine will prefer it's own winmm.dll by default, but you can change it the configuration (winecfg). Applications like Bottles have dedicated settings for this too.

Building

We require Nightly to build, but rust-toolchain.toml should prefer it by default.

macOS/Linux

It's possible to build this project outside of Windows. Ensure that you have and build with the correct target (x86_64-pc-windows-gnu):

rustup target add x86_64-pc-windows-gnu

If you encounter an error message like:

error occurred in cc-rs: failed to find tool "x86_64-w64-mingw32-gcc": No such file or directory (os error 2)

Then you need to install the MinGW toolchain, as one of our dependencies has to compile C code.

Tips & Tricks

Check out the Launcher page on wiki.xiv.zone for more details about the launcher's functions.

Logging Proxy

You can use the winmm_proxy config option to sniff the non-web browser traffic from the launcher. You need a HTTP proxy capable of logging of course, I personally use mitmproxy.

Credits

Initially based off of NotNite's benchtweaks and also inspiration for the name!

License

GPLv3

This project is licensed under the GNU General Public License 3.