astra/README.md.old

## PATCH APPLYING HAS BEEN DISABLED BECAUSE OF A RECENT BAN WAVE. #7

## PLEASE DON'T SHARE THIS PROJECT IN PUBLIC. YES, SHARING JUST THE NAME IS "SHARING" TOO

### Regions
Both the global/overseas (OS) and the chinese (CN) versions of the game are supported. The installer will automatically detect your game version.

### Information
The Game's anticheat is fundamentally incompatible with Wine in multiple ways (at least 3). This patch removes it entirely and imitates it's behaviour. This is much more radical than classical micropatching, so the risks are probably higher (not enough time has passed to tell). Please contact me if you want to know how the patch works.

The game also requires DirectX shared resources, which will probably never be fully supported by DXVK/WineD3D. **The patch forces Unity to not use DirectX shared resources in a rather hacky way. This might cause graphical glitches.**

And no, it does not work on Windows.

### Installation

**Wine 8.0+ (staging branch) is recommended to run the Game**. Older Wine versions will probably work as well. [DXVK](https://github.com/doitsujin/dxvk) is recommended, but not required.

[The Honkers Railway Launcher](https://github.com/an-anime-team/the-honkers-railway-launcher) can be used to install and patch the Game automatically. If you don't want to use the launcher, follow the manual installation instructions below.

macOS users: [Yaagl](https://github.com/3Shain/yet-another-anime-game-launcher) can be used to install and patch the Game automatically.

Manual installation:
- Download and install the Game from the official website. Do not launch the Game
- Clone this repo (not into the game directory!): `git clone https://notabug.org/mkrsym1/astra`
- Open the game directory in your terminal
- Install the patch: `install.sh`. Use `install.sh --root-cmd <command>` to use something else instead of polkit

Now you can start the Game using `launch.bat`

### Guidelines
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 Game through Wine

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

Refer to TROUBLESHOOTING.md for the list of known issues.

### Credits

- mkrsym1 &mdash; project leader, reverse engineering, TVM autoanalysis and metadata generator tool (not public), TVMBootstrap.dll, patches, patch installer
- [An Anime Team](https://github.com/an-anime-team) &mdash; [The Honkers Railway Launcher](https://github.com/an-anime-team/the-honkers-railway-launcher), [mirror of this repository](https://codeberg.org/an-anime-team/astra)
- [3Shain](https://github.com/3Shain) &mdash; [Yaagl](https://github.com/3Shain/yet-another-anime-game-launcher), modified Wine for macOS

License: MIT