redstrate/launchertweaks
1
Fork 0
mirror of https://github.com/redstrate/LauncherTweaks.git synced 2025-05-20 09:27:46 +00:00
Code Activity
Tweaks for the official FFXIV launcher
5 commits 1 branch 0 tags 110 KiB
Find a file
Joshua Goins e9b1593108 Update to newer proxy-dll-rs 
This has my own changes to reduce the amount of dependencies used.
2025-04-20 12:14:00 -04:00
.github/workflows Update to new DLL name 2025-04-20 11:49:20 -04:00
src Add feature to force WinHTTP traffic to the system proxy 2025-04-20 11:43:19 -04:00
.gitignore Add initial files 2025-04-19 23:10:11 -04:00
Cargo.lock Update to newer proxy-dll-rs 2025-04-20 12:14:00 -04:00
Cargo.toml Add feature to force WinHTTP traffic to the system proxy 2025-04-20 11:43:19 -04:00
LICENSE Add initial files 2025-04-19 23:10:11 -04:00
README.md Update to new DLL name 2025-04-20 11:49:20 -04:00
rust-toolchain.toml Add basic CI (#1) 2025-04-20 10:02:57 -04:00

README.md

LauncherTweaks

Tweaks for the official FFXIV launcher.

Features

  • Allows configuring 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.)

Usage

Grab a build from GitHub Actions or build the project with the instructions below. Then, place the winhttp.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 winhttp.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

Launcher Functions

Here are some interesting native functions that are callable from JavaScript. To call these, use window.external.user.

  • systemConfig: Opens the system config program.
  • requestExit: Despite the name, exits the launcher immediately.
  • requestReboot: Exits the launcher immediately, doesn't seem to come back though?

Logging Proxy

You can use the winhttp_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.