Injections

Injections defined in the global game flow will by default be applied to each level. Individual levels can also specify their own specific injections to include. In that case, the global injections are merged with the level's when the level loads.

Individual levels can set inherit_injections to false and as a result they will not use the global injection files. If those levels have their own injections defined, only those will be used. And of course, if they have none defined, nothing will be injected.

Disclaimer: Custom levels should not use the injections mechanism and instead should provide data that is already correct and consistent. Reports of bugs about injection files not working for custom levels will not be considered. Note however that the injections that relate to Lara can work in custom levels that do not modify Lara's default mesh structure or animations. These injection files are based on the original Lara model.

The game flow will ignore referenced injection files that do not exist, but it is best practice to remove the references to maintain a clean game flow file.

Following is a summary of what each of the default injection files that are provided with the game achieves.

Injection file Usage Purpose
*_cameras.bin TR1 Injects positional adjustments for cameras that can otherwise cause visual issues, such as in Temple of the Cat.
*_fd.bin TR1, TR2 Injects fixes for floor data issues in the original levels. Refer to the README for a full list of fixes.
*_itemrots.bin TR1, TR2 Injects rotations on pickup items so they make more visual sense when using the 3D pickups option.
*_meshfixes.bin TR1 Injects miscellaneous mesh adjustments for objects, such as in Obelisk of Khamoon to avoid z-fighting.
*_music_tracks.bin TR2 Injects trigger adjustments to convert music track numbers to match file names. These are suitable for OG levels only.
*_pickup_meshes.bin TR1, TR2 Injects mesh edits to change the scale of various pickup models, such as the keys in St. Francis' Folly or the Prayer Wheel in Barkhang Monastry.
*_sfx.bin TR1, TR2 Injects various SFX fixes or additions, such as the PSX Uzi SFX in TR1, or fixing the silent enemies in TR2's water levels.
*_skybox.bin TR1 Injects a predefined skybox model into specific levels.
*_textures.bin TR1 Injects fixes for texture issues in the original levels, such as gaps in the walls or wrongly colored models. Refer to the README for a full list of fixes.
boat_bits.bin TR2 Injects a model in slot `O_BOAT_BITS` (221) which is used to show the boat exploding when it crosses mines.
backpack.bin TR1 Injects mesh edits for Lara's backback, such that it becomes shallower. This is only applied when the braid is enabled, to avoid the braid merging with the backpack. The different files are needed to address mesh structure differences between cutscene and normal levels.
backpack_cut.bin
braid.bin TR1 Injects a braid when the option for it is enabled. This also edits Lara's head meshes (object 0 and object 4) to make the braid fit better. A golden braid is also provided for the Midas Touch animation. Again, different files are needed to cater for mesh differences between cutscene and normal levels. The Lost Valley file comprises a head mesh edit for object 5 only.
braid_cut1.bin
braid_cut2_cut4.bin
braid_valley.bin
bubbles.bin TR1 Injects replacement sprite textures for Lara's underwater bubble sprites, which are cut off in OG.
cistern_plants.bin TR1 This disables the animation on sprite ID 193 in The Cistern and Tomb of Tihocan.
khamoon_mummy.bin TR1 Injects the mummy in room 25 of City of Khamoon, which is present in the PS1 version but not the PC.
lara_animations.bin TR1, TR2 Injects several animations, state changes and commands for Lara, such as responsive jumping, jump-twist, somersault, underwater roll, and wading. For custom levels, this injection file will work as-is, but if you are building a level and wish to customise any of Lara's animations, please refer to https://github.com/LostArtefacts/TRXInjectionTool/blob/main/docs/ASSETS.md for guidance.
lara_gym_guns.bin TR1 Injects all of Lara's weapons and weapon animations in TR1's gym level.
explosion.bin TR1 Injects explosion sprites for certain console commands.
font.bin TR1, TR2 Injects replacement font sprites to support more characters than OG.
guardian_death_commands.bin TR2 Injects an animation command for the bird guardian to end the level on the final frame of its death animation. The original hard-coded end-level behaviour is removed in TR2X.
mines_pushblocks.bin TR1 Injects animation command data for pushblock types 2, 3 and 4 to restore the missing scraping SFX when pulling these blocks.
pickup_aid.bin TR1 Injects a sprite sequence similar to the Midas twinkle effect, which is used when the option for pickup aids is enabled. Custom levels should define a suitable sprite sequence in slot 185.
photo.bin TR1, TR2 Injects camera shutter sound effect for the photo mode, needed only for the cutscene levels.
purple_crystal.bin TR1 Injects a replacement savegame crystal model to match the PS1 style.
scion_collision.bin TR1 Increases the collision radius on the (targetable) Scion such that it can be shot with the shotgun.
seaweed_collision.bin TR2 Fixes the seaweed in Living Quarters blocking Lara from exiting the water.