<div align="center">
<h1>TRX – Tomb Raider I-III: Community Edition</h1>

<p align="center">
  <a href="https://lostartefacts.dev/">
    <img src="data/trx/icon.png" style="width: 128px;" alt="TRX logo"/>
  </a>
</p>

<a href="https://github.com/LostArtefacts/TRX/releases?q=prerelease%3Afalse&expanded=true">
    <img src="data/download_trx.svg"/>
</a>
</div>

<hr/>

Welcome to **TRX** – an open-source reimplementation of **Tomb Raider 1**,
**Tomb Raider 2** and **Tomb Raider 3**. TRX aims to enhance these classic
games through decompilation and the implementation of open-source alternatives
to proprietary components. TRX is a single engine capable of running TR1, TR2,
TR3, and custom levels respecting each of the distinct, classic engines'
mechanics.

## Showcase
<table>
    <tr>
        <th>
            Restored braid in TR1
            <img src="docs/showcase/braid.jpg"/>
        </th>
        <th>
            Enemy health bar and UI scaling
            <img src="docs/showcase/enemy_health_bar_and_scaling.jpg"/>
        </th>
    </tr>
    <tr>
        <th>
            Photo mode
            <img src="docs/showcase/photo_mode.webp"/>
        </th>
        <th>
            3D pickups
            <img src="docs/showcase/3d_pickups.jpg"/>
        </th>
    </tr>
    <tr>
        <th>
            Skybox support
            <img src="docs/showcase/skybox.jpg"/>
        </th>
        <th>
            Updated moveset including sprint
            <img src="docs/showcase/sprint.webp"/>
        </th>
    </tr>
    <tr>
        <th>
            Customizable draw distance
            <img src="docs/showcase/draw_distance.webp"/>
        </th>
        <th>
            Developer console
            <img src="docs/showcase/console.webp"/>
        </th>
    </tr>
    <tr>
        <th>
            Detailed level stats
            <img src="docs/showcase/compass_stats.jpg"/>
        </th>
        <th>
            PS1 UI and expanded options
            <img src="docs/showcase/ps1_ui_and_options.webp"/>
        </th>
    </tr>
</table>

## Download

Download the latest TRX release:

<a href="https://github.com/LostArtefacts/TRX/releases?q=prerelease%3Afalse&expanded=true">
    <img src="data/download_trx.svg"/>
</a>

### Installation instructions

Please refer to [this document](docs/trx/INSTALLING.md).


### Changelog

Please refer to [this document](docs/CHANGELOG.md).


## Q&A

1. **Are all three games fully playable from beginning to end?**

    Yes! If you encounter a bug, please file a ticket.

2. **Can we get HD textures? What about other visual updates?**

    Regarding HD texture packs, that feature is not currently planned.

    As for other visual updates, being able to introduce reflections and
    skyboxes shows that quite literally the sky is the limit. TRX is constantly
    getting new rendering improvements and texture fixes. But great stuff
    takes time.

4. **Can I play this on Mac, Linux, Android...?**

    Currently supported platforms include Windows, Linux and macOS.

5. **Can I play this with a controller?**

    TRX supports a wide variety of controllers out of the box with no
    additional software required. The keyboard or controller controls
    can be fully customized in the Controls menu with multiple layouts.
    Multi-key combo shortcuts (up to 3 keys) and two binding slots per
    action are also supported.


## Website
The Lost Artefacts team is a small, passionate community of developers and
creators with a deep love for the classic Tomb Raider titles. Our team builds
and maintains freeware fan projects that celebrate Lara Croft's iconic
adventures. Visit the website by clicking the logo below for more information
on TRX and its documentation as well as other Tomb Raider projects.

<p align="left">
  <a href="https://lostartefacts.dev/">
    <img src="data/lostartefacts.png" style="width: 128px;" alt="TRX logo"/>
  </a>
</p>

## Credits

- Endless GitHub contributors.
- TR1 title screen image by Kidd Bowyer. HD assets by goblan and posix.
- TR2 HD images by Arsunt.
