Alienation - PC port
Version 0.1.0

Alienation for PlayStation 4, running natively on Windows: the game's own code
runs on the PC with a replacement for the PS4 system libraries and a Vulkan
renderer.

Source code and issue tracker:
https://github.com/saulob/alienation-pc


NO GAME FILES ARE INCLUDED
--------------------------
You need your own legally obtained copy of the game: a decrypted Alienation
PS4 package (.pkg). This port currently accepts these builds:

  Title ID CUSA00062, APP_VER 01.00 (content ID EP9000-CUSA00062_00-ALIENATIONGAMEEU, Europe)
  Title ID CUSA00062, APP_VER 01.06 (the European update, installed over 01.00)
  Title ID CUSA04430, APP_VER 01.00 (content ID HP9000-CUSA04430_00-ALIENATIONGAMEKR, Asia)

To add the European 1.06 update, install the base game first, then click
"Install update..." on the Play page and select the update package. "Remove
update" returns to 1.00; saves are kept. The DUPLEX single-package repack of
1.06 is installed with "Install game..." and runs as 1.06. Every build has the
same port features; local co-op exists only in 1.06 (and DUPLEX).

Any other build is refused, and the log names what was found. A package still
encrypted for a PS4 console cannot be unpacked on a PC.


REQUIREMENTS
------------
- Windows 10 version 1903 or later, or Windows 11, 64-bit
- A processor with AVX and LZCNT: Intel Core 4th generation (Haswell), AMD FX
  or newer
- A graphics card and driver with Vulkan 1.3
- Your own Alienation package, plus about 3 GB of free disk space next to the
  program for the installed game


INSTALL
-------
1. Extract the ZIP anywhere you can write to (not "Program Files").
2. Run alienation.exe. The launcher opens.
3. On the Play page, click "Install game..." and select your .pkg file.
4. Wait while the launcher checks the package and unpacks it into the "game"
   folder next to the program. The .pkg file is only read.
5. When the Play page says "Ready to play", press PLAY.


PLAYING
-------
- F1 (or L3 + R3 on a controller) opens the Options menu.
- F2 shows the frame counter. F11 switches between Windowed and Borderless
  Fullscreen.
- Xbox and PlayStation controllers and the keyboard are supported; the
  launcher's Controls page lists the keys.
- Online co-op (2 to 4 players): turn Online play On in the launcher's Online
  page, run the Connection test once, add friends with their Friend Code, then
  use the game's own squad menus (Create Squad, Join Squad, Invite friends).
  Invitations and Join also work from the launcher's Online page. With Online
  play Off the game makes no online connection.
- Local co-op (CUSA00062 1.06 and DUPLEX): up to four controllers; press
  OPTIONS on another controller to join.


UPDATES
-------
The launcher checks this project's GitHub releases once per start. When a
newer release exists, a banner in the header offers UPDATE NOW. The download
is verified against its SHA-256 and installed only after you press RESTART TO
UPDATE; the launcher then closes, trg-updater.exe replaces the program's own
files and the launcher opens again. The "game", "user" and "logs" folders are
never touched, and a failed update puts the previous files back.


WHERE THINGS ARE
----------------
- Game files:     the "game" folder next to alienation.exe
- Logs:           the "logs" folder next to alienation.exe (alienation_NNN.log)
- Settings (alienation.ini), saves and shader cache: the "user" folder


LICENSE
-------
The port's own code is licensed under the GNU General Public License v2.0
or later, its libSceJson2 code under GPL-2.0 only, so the program is
distributed under GPL-2.0. The full text is in LICENSE.txt. Third-party
components keep their own licenses; see the "licenses" folder.

Game files are not included and are not covered by this project's license.
This port is not affiliated with or endorsed by Housemarque, Sony Interactive
Entertainment or any other rights holder of Alienation.
