Skip to content

Commit

Permalink
Update getting started page
Browse files Browse the repository at this point in the history
  • Loading branch information
NeKzor committed Dec 16, 2024
1 parent 3d1efde commit f76eeec
Show file tree
Hide file tree
Showing 2 changed files with 72 additions and 30 deletions.
3 changes: 2 additions & 1 deletion doc/github.js
Original file line number Diff line number Diff line change
Expand Up @@ -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);
}
99 changes: 70 additions & 29 deletions doc/src/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 <a id="stable-release" href=""></a>.
1.\) Download unstable release <a id="unstable-release" href=""></a>.

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.

<details>
<summary>Click to preview</summary>
* 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

</details>
## 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).

<details>
<summary>Preview obsolete tool</summary>

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
</details>

## 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
Expand Down

0 comments on commit f76eeec

Please sign in to comment.