TR1 Support

[lahm86]

TR1 Support

TR1 is now supported. TRGE will allow opening a TombATI installation or a Tomb1Main installation - the recommendation is to use Tomb1Main as this allows all options in the randomizer to be enabled.

Only the current development build of Tomb1Main is supported in the randomizer. So at the time of writing, 2.10.2 and lower are not supported.

As per TR2 and TR3, you need only point the randomizer to the DATA folder and it will work out the rest. This update includes an editor for the T1M configuration, so the recommendation is to not modify these JSON files manually after having opened them in the randomizer, as this can cause issues with the backups and so can lead to obscure results during randomization. Either make all edits to the files before opening the folder in the randomizer, or use the built-in editor described below.

Huge thanks to rr- and walkawayy for their support with some amendments to Tomb1Main (#599, #603, #605 and #611).

Version Detection

The ScriptEditor object passed to the main randomizer editors (e.g. TR1RandoEditor) now has details on the detected version, so this is where we can apply different logic. The handling of the different elements that are supported has been moved out of TRRandomizerController into TRVersionSupport; the lists in here are now explicit types that are supported rather than the previous implementation which had supported and unsupported lists. Although this is "wordier", it's much more explicit.

For TR1, most of the individual randomizer implementations follow suit with TR2 and TR3, so I won't go into too much detail on those, but the following is worth commenting on.

---

Unavailable Options

If not using Tomb1Main, the following will not be available to select in the randomizer, or otherwise will not apply.

• Level count/sequencing
• Unarmed levels
• Ammoless levels
• Lara's health
• Text
• Secret count mode
• Title and ambient tracks
• Water colour randomization
• Lara's braid

Secrets

Secret randomization works in the same way as TR3, so artefacts are imported and reward rooms added. @eycore1 implemented secret locations previously, and additional locations for Natla's Mines and Atlantis have been added. All secrets are currently glitchless and none are classed as hard.

SECRETS.md contains more detailed notes about the artefact types to find in each level and the option for changing the number of secrets.

Items

Locations are generated automatically for standard items, similar to TR3, so there is also an exclusion list to avoid unreachable rooms (around 17,000 valid locations possible across the game).

Key item randomization is also implemented, and again this works the same as TR3, so there are defined locations set for these in Resources\TR1\Locations\item_locations.json.

This update also adds UI options to change item types as well as their positions, so this applies to TR2 and TR3 as well (although for TR2, HSH items will still remain in their default locations).

Enemies

Full details of enemy restrictions are in ENEMIES.md. Some additional comments:

• One less thing to worry about in TR1 is that enemies can't drop items (other than the hardcoded items human enemies drop).
• Water enemies work slightly differently as TR1 has equivalent land enemies it switches them to if a room is drained, so the randomizer will make sure to import these equivalents as needed.
• Some levels can be particularly challenging, such as Midas, but there are restrictions on Atlanteans and T-Rexes here because of the high number of enemies. No Restrictions mode is a real challenge.

Eggs

There is additional handling added for eggs so that they always appear against a wall. These are standard locations exported from trview (Resources\TR1\Locations\egg_locations.json), but with the addition of an angle. The trview Resources\Shared\randomizer.json config file has been updated with this variable.

They spawn different types of Atlantean based on the value of TREntity.CodeBits:

• 1 = Shooter
• 2 = Centaur
• 4 = Torso
• 8 = Non-shooter
• 16 = Flyer

Centaur Statues

As Lara needs to get close to these to trigger them, any enemies allocated as centaur statues will be grounded. The randomizer will move them down until they hit the floor.

Audio

The way trigger tracks are randomized has been updated for all 3 versions. Previously we would group triggers by room and allocate the same track to that room, but this didn't work too well for TR1 (consider Caves room 26). Now, when allocating to a sector, a tracker will reference each neighbouring sector regardless of room, so if we come to one of those other sectors while scanning through other rooms, we will use the track already allocated.

Environment

Currently only mirroring is available to choose, but all supported EM functions have been implemented for TR1. The secret reward rooms use these heavily, similar to TR3.

Model Transport / Textures

One of the challenges with TR1 is that we are obviously restricted to 255 colours so this needs to be handled carefully when importing additional models and textures. The import logic works identically to other versions, so all the texture packing is handled using bitmaps and it's not until it comes to writing back to the level that things get a little trickier. This works by scanning every pixel across all tiles and collecting the unique colours until the palette is filled. If the palette is full but there are still more colours to add, instead of bombing out, it will try to find the nearest suitable match. So the result is that some textures may have slightly different appearances than normal.

The above process is also quite slow (e.g. 16 tiles per level = ~1million pixels to scan) but it doesn't appear any worse than TR2.

Only Lara is currently targeted for texture randomization, and this uses the same approach as TR2/3. For other models it might be better to choose a different approach and instead of defining external bitmaps to allocate, we just use the existing palette.

Lara's Appearance

• The settings related to haircuts in TR2/3 are repurposed for hair extensions in TR1.
• We don't use Lara's gym outfit because of the lack of gun holsters at the moment, this may be added in the future.

---

Tomb1Main Config Editor

The UI has a button in the Global Options section to allow editing the Tomb1Main settings. TRGE handles the IO here between the Tomb1Main.json5 and Tomb1Main_gameflow.json5 - together these make up the TR1Script object. The editor is targeted at the current T1M build, but if there are new releases of Tomb1Main that add additional options, these will not be lost. TR1Script has additional variables, GameflowData and ConfigData, which are JObjects. When it's parsing the files these objects are filled and it then removes the elements it knows about and puts them into the defined instance variables. So anything that's left in these objects can still be edited and will be merged when writing back, there are just no defined variables for them. The idea would be that the randomizer could still support uprevs of Tomb1Main that include new options until there was the opportunity to make the relevant UI settings for them.

The output files don't contain comments, but the original comments have been replicated in the UI.

Note that some settings can be overridden by individual randomizers. These are as follows.

• water_color - colour can be changed per level during texture randomization
• fix_descending_glitch, fix_wall_jump_glitch, fix_qwop_glitch - disabled if glitched secrets are enabled (for the future)
• fix_pyramid_secret_trigger - disabled if secret randomization is enabled
• disable_trex_collision - enabled if enemy randomization is enabled

These are "soft" overrides, meaning that if you explicitly choose the opposite, then enable a randomizer that would override the setting, if you at a later date re-randomize such that the randomizer doesn't need to set these values, your original choice will persist.

Other Fixes

• Resolves TR2 - Unobtainable secret in Tibet #362 - removes room 68 from Tibet as a potential location for the drawbridge key as this contains the flipmap trigger for the area and once flipped, the drawbridge dummy triggers are lost. This impacts being able to collect a specific secret that requires the skidoo on the other side of the bridge.
• Resolves TR2 - Imported Texture Issues #363 - some texture bleeding that was present in TR2.
• Resolves TR2 - Add additional mines trigger in Venice #364 - an extra trigger for the mines in Venice is now added in case the route via the gondolas is bypassed.