Jadeite with support for external game launchers.
Go to file
2023-06-07 20:57:56 +03:00
game_payload Merge hi3.h into game.h 2023-06-06 21:14:21 +03:00
injector Optimized build 2023-06-07 20:57:56 +03:00
.gitignore Initial commit 2023-06-06 00:23:08 +03:00
build.sh Optimized build 2023-06-07 20:57:56 +03:00
gen_resources.sh Initial commit 2023-06-06 00:23:08 +03:00
LICENSE.txt Initial commit 2023-06-06 00:23:08 +03:00
meson.build Initial commit 2023-06-06 00:23:08 +03:00
mingw_cross.txt Initial commit 2023-06-06 00:23:08 +03:00
README.md Fix typo in readme 2023-06-06 20:21:06 +03:00
SERVERS.txt Initial commit 2023-06-06 00:23:08 +03:00
setup.sh Optimized build 2023-06-07 20:57:56 +03:00

PROOF OF CONCEPT. DO NOT USE IF YOU DON'T KNOW WHAT YOU'RE DOING

Games and regions

This project is in the proof-of-concept stage. Currently, only 3rd glb v6.6.0 is supported. It may be possilbe to completely remove the region and version-specific data in the future. Refer to the source code in game_payload/src for details.

Information

The anticheat the games use is fundamentally incompatible with Wine in multiple ways. This tool launches the game without it (injector/launcher_payload) and imitates it's behaviour (game_payload).

Does not work on Windows.

Usage

Refer to Third-party launchers (will be written later) for convenient usage. If you don't want to (or can't) use third-party launchers, continue reading the section below.

Wine 8.0+ is recommended, as lower versions leak "The Wine project" as the device identifier. Not critical, but taking a precaution never hurt anyone. DXVK is strongly recommended.

3rd-specific: In some cases, and if you're not using Proton GE, a fix for Media Foundation may be required to play videos. The Game may crash without it. You can download it from here. You might need to limit the number of cores available to the game if your CPU has more than 8.

Manual usage instructions:

  • Download the game you want to run
  • Download a release from this repository
  • Extract the archive (NOT INTO THE GAME DIRECTORY! THIS IS IMPORTANT!)
  • Block analytics servers in your hosts file. You can find the list in SERVERS.txt
  • Run wine jadeite.exe "Z:\\wine\\path\\to\\game.exe"

This tool is capable of starting the games from a different process. This may be useful for spoofing the parent process (SR is known to report it). Use wine jadeite.exe "Z:\\wine\\path\\to\\game.exe" "Z:\\wine\\path\\to\\launcher.exe". explorer.exe is used as the default.

Internals

This tool consists of three parts: the main injector (injector), the launcher payload (injector/launcher_payload) and the game payload (game_payload).

I am very bad at explaining, so just take a look at the source code. Maybe I'll write a detailed explanation in the future.

A part of the source code is witheld (game_payload/src/tp6.c). This is a forced measure to make abuse more difficult.

Guildelines

  1. Please don't share this project in public. This might attract unnecessary attention from either the Game Company or the Anticheat Company
  2. Please don't abuse this project for cheating. We're just trying to play the games through Wine

Troubleshooting

Please do not report any issues with the Game to the official channels. Use the issue tracker of this repository

Third-party launchers

Will be written later

Credits

  • mkrsym1 — project leader, reverse engineering
  • Yor#1920 — major help with analyzing network activity
  • Some others credited in the source code

License: MIT