jadeite/README.md

Games and regions

• 3rd: glb v6.6.0
• SR: os/cn v1.1.0 (unsafe, refer to configuration)

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).

SR-specific: this tool disables the use of DirectX shared resources in a rather hacky way. It is required, as there is no (and most likely never will be) shared resources support in DirectX translation layers (WineD3D/DXVK). Refer to configuration if you wish to run the game without the fix.

Using third-party software (such as this tool) with the games violates their Terms of Service. Therefore, you may receive a ban. No bans were ever reported with 3rd, however the legacy patch for SR did cause many. Use at your own risk and only if you understand all the possible consequences.

This is not a cheating tool. Using it with Windows is not possible, and Windows support is not planned or intended in any way. However, as it does not perform any on-disk file modifications, you may reuse the same game install for Windows if you have a dual-boot setup.

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.

To pass commandline arguments to the game, append them after the launcher path: wine jadeite.exe 'Z:\wine\path\to\game.exe' 'Z:\wine\path\to\launcher.exe' -arg1 -arg2 -arg3. To use the default launcher process, use --: wine jadeite.exe 'Z:\wine\path\to\game.exe' -- -arg1 -arg2 -arg3.

Configuration

These environment variables can be used to configure the behaviour of the tool.

• WAIT_BEFORE_RESUME=1 - show a messagebox and wait for user input before resuming the game process. Useful on my side for debugging

SR-exclusive:

• I_WANT_A_BAN=1 - allows to launch SR. Please only use testing accounts, as there is an extremely high risk of getting banned
• SRFIX_DISABLE=1 - disable shared resources fix

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