From f76eeecbdcc6896e0bc05f078940df19bdd6d9cd Mon Sep 17 00:00:00 2001 From: NeKz Date: Mon, 16 Dec 2024 02:41:58 +0100 Subject: [PATCH] Update getting started page --- doc/github.js | 3 +- doc/src/getting-started.md | 99 +++++++++++++++++++++++++++----------- 2 files changed, 72 insertions(+), 30 deletions(-) diff --git a/doc/github.js b/doc/github.js index 23a177e..d3f8804 100644 --- a/doc/github.js +++ b/doc/github.js @@ -12,7 +12,8 @@ if (document.location.pathname === '/getting-started.html') { } }; - addRelease('#stable-release', false); + //addRelease('#stable-release', false); + addRelease('#unstable-release', true); }) .catch(console.error); } diff --git a/doc/src/getting-started.md b/doc/src/getting-started.md index 9891cb2..b48323e 100644 --- a/doc/src/getting-started.md +++ b/doc/src/getting-started.md @@ -2,65 +2,106 @@ ## Requirements -1.\) Game is installed. +1.\) Game is installed -2.\) Game is activated. See section [Unlocker](#unlocker) if you need help with activation. +2.\) [PhysX] is installed + +3.\) SecuROM's [offline installer package] is installed + +4.\) Optional: [XDead](https://github.com/NeKzor/xdead/releases) is installed (no phone number for a Microsoft account + needed!) + +[PhysX]: https://www.nvidia.com/en-us/drivers/physx/physx-9-13-0604-legacy-driver/ + +[offline installer package]: https://support.securom.com/pop_tron.html ## Installation -1.\) Download the latest stable release . +1.\) Download unstable release . 2.\) Extract the files to the same folder as `GridGame.exe`. The default location is: ``` -C:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live +c:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live ``` 3.\) Launch the game with the replaced `GridGameLauncher.exe` -## Unlocker +4.\) Toggle TEM's UI with [NumPad 0 key](https://github.com/NeKzor/tem/discussions/2) + +## XDead (optional) -TEM comes with an unlocker tool that allows anyone to generate their unlock code for product activation on their local -machine. This only works if you also installed SecuROM's [offline installer package][]. +TEM works in combination with [XDead] which replaces Games for Windows Live (GFWL) aka XLive. This is the quickest +and easiest way to get past GFWL installation and authentication. This means that no Microsoft account is needed but it +will obviously also disable the multiplayer game mode but maybe TEM can emulate that in the future. -
-Click to preview +* Download the latest .zip file [on the releases page](https://github.com/NeKzor/xdead/releases) +* Extract `xlive.dll` and put it into the installation path + * `c:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live` -![unlock-code-sub-10-fast-game-complete.gif](/images/unlock-code-sub-10-fast-game-complete.gif) +[XDead]: https://github.com/NeKzor/xdead/releases -
+## Activate Game -[offline installer package]: https://support.securom.com/pop_tron.html +Download and install SecuROM's [offline installer package]. It includes the full `GridGame.exe` game without encryption +so TEM can easily bypass the rest. -## XDead (optional) +```admonish warning +unlocker.exe is OBSOLETE! +``` + +TEM came with an unlocker tool that only generates a activation code which is supposed to be copied and entered. +It does not modify anything. The tool is now removed because a custom GridGameLauncher.exe is now shipped. +However, the code will always be [available](https://github.com/NeKzor/tem/blob/3d1efde048226b2b696e49af0446dc108086341a/unlocker/main.cpp). + +
+Preview obsolete tool -TEM works in combination with [XDead][], which replaces Games for Windows Live (GFWL) aka XLive. This is the quickest -and easiest way to get past GFWL installation and authentication. This means that no Microsoft account is needed. +![unlock-code-sub-10-fast-game-complete.gif](/images/unlock-code-sub-10-fast-game-complete.gif) -[XDead]: https://github.com/NeKzor/xdead +
## Linux -Because of XDead, we can easily get the game to run under Linux with [Wine][]. +Because of XDead we can easily get the game to run under Linux with [Wine]. -- Make sure to use 32-bit version of Wine with `WINEARCH=win32` (only required for the first time). +- Make sure to use 32-bit version of Wine with `WINEARCH=win32` (only required for the first time or use `WINEPREFIX` to select a specific folder.) - Install `dinput8` and `physx` with [Winetricks]. -- Assuming installation did not work or was skipped: Use `wine regedit` to set the required registry values in - `HKEY_LOCAL_MACHINE\Software\Disney Interactive Studios\tr2npc`: - - `InstallPath REG_SZ "C:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live"` - - `Language REG_SZ "EN"` (other supported languages are `DE`, `FR`, `ES`, `IT`, `JP`, `RU`, `PL`, `NL`, `CZ`) -- Disable default logging for more performance with `WINEDEBUG=-all` -- By default Wine loads its own `dinput8.dll` version. Simply use `WINEDLLOVERRIDES="dinput8=n"` to use TEM's proxy. +- Use `wine regedit` to set the required registry values: + - Create keys for following path: `HKEY_LOCAL_MACHINE\Software\Disney Interactive Studios\tr2npc` + - Add `InstallPath` as `REG_SZ` with value `c:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live` or any valid existing game path + - Add `Language` as `REG_SZ` with value `EN` other any other supported language: + - `DE`, `FR`, `ES`, `IT`, `JP`, `RU`, `PL`, `NL`, `CZ` +- Use `WINEDEBUG=-all` to disable default logging for more performance +- Use `WINEDLLOVERRIDES="dinput8=n"` to be able to load TEM. By default Wine loads its own `dinput8.dll` version which + we only want to load later. ```bash # Install requirements -winetricks -q physx dinput8 +WINEPREFIX=$HOME/.wine32 WINEARCH=win32 winetricks -q physx dinput8 + +# Add registry values +WINEPREFIX=$HOME/.wine32 WINEARCH=win32 wine regedit + +# Launch TEM's GridGameLauncher.exe +WINEPREFIX=$HOME/.wine32 WINEARCH=win32 WINEDEBUG=-all WINEDLLOVERRIDES="dinput8=n" wine GridGameLauncher.exe +``` + +Make sure `InstallPath` registry value is pointing to a valid installation path. Here is an example on how to choose +a symlink to an existing game folder: + +```bash +# Example assumes /mnt/win11/ exists (e.g. dual-boot drive) +# Can be anything but installPath just has to match with correct drive letter. +# In wine the default drive is $WINEPREFIX/dosdevices/c: +ln -s /mnt/win11/ $HOME/.wine32/dosdevices/y: -# Optional: Manually add registry values -wine regedit +# Go to HKEY_LOCAL_MACHINE\Software\Disney Interactive Studios\tr2npc +# Add InstallPath value "y:\Program Files (x86)\Disney Interactive Studios\Tron Evolution\Binaries\Win32Live" +WINEPREFIX=$HOME/.wine32 WINEARCH=win32 wine regedit -# Launch -WINEDEBUG=-all WINEDLLOVERRIDES="dinput8=n" wine GridGameLauncher.exe +# Launch TEM's GridGameLauncher.exe +WINEPREFIX=$HOME/.wine32 WINEARCH=win32 WINEDEBUG=-all WINEDLLOVERRIDES="dinput8=n" wine GridGameLauncher.exe ``` [Wine]: https://www.winehq.org