Jadeite with support for external game launchers.
Go to file
2023-07-07 13:59:28 +03:00
game_payload Move blob file to objects kwarg in target declaration 2023-07-06 00:04:41 +03:00
injector Publish precompiled tp6.c blob (lots of dirty hacks) 2023-07-05 23:59:27 +03:00
.gitignore Update .gitignore 2023-06-07 23:55:14 +03:00
build.sh Publish precompiled tp6.c blob (lots of dirty hacks) 2023-07-05 23:59:27 +03:00
gen_resources.sh Refactor resource gen script 2023-07-07 13:59:28 +03:00
LICENSE.txt Initial commit 2023-06-06 00:23:08 +03:00
meson.build v1.1.7 2023-07-03 14:07:38 +03:00
metadata.json v1.1.7 2023-07-03 14:07:38 +03:00
mingw_cross.txt Initial commit 2023-06-06 00:23:08 +03:00
README.md Update credits section 2023-07-02 23:48:54 +03:00
SERVERS.txt Add HSR logging servers to SERVERS.txt 2023-06-08 23:01:07 +03:00
setup.sh Optimized build 2023-06-07 20:57:56 +03:00

Games and regions

  • 3rd: glb v6.7.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 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

  • Honkers Launcher — Linux launcher for 3rd (GitHub | Codeberg)
  • The Honkers Railway Launcher — Linux launcher for SR (GitHub | Codeberg)

Credits

  • mkrsym1 — project leader, reverse engineering
  • EternalStudentDesuKa — major help with analyzing network activity
  • An Anime Team — Honkers Launcher and The Honkers Railway Launcher
  • Some others credited in the source code

License: MIT