Skip to content

ALDamico/TombLauncher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

460 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿบ Tomb Launcher

Your all-in-one companion for Tomb Raider custom levels.

License: MIT .NET Avalonia UI Platform


What is Tomb Launcher?

If you've ever wanted to play fan-made Tomb Raider levels but found the process of downloading, installing, and managing them frustrating, Tomb Launcher is for you.

The Tomb Raider community has been creating incredible custom levels for over two decades. It all started with the Tomb Raider Level Editor (TRLE) โ€” originally shipped with Tomb Raider: Chronicles back in 2000 โ€” and has since evolved into a vibrant ecosystem of engines and tools. Today, builders use a variety of platforms to craft their adventures:

  • TRLE โ€” The original Level Editor, still widely used
  • TRNG โ€” An enhanced scripting engine built on top of TRLE, adding powerful new capabilities
  • TombEngine โ€” A modern, open-source engine rewrite with support for new features and improved visuals
  • TR1X / TR2X โ€” Open-source reimplementations of the Tomb Raider 1 and 2 engines, enabling custom levels for the classic games

Talented builders have crafted thousands of adventures spanning ancient temples, sunken shipwrecks, snowy mountain fortresses, and places Lara Croft has never been before. Some of these levels rival the quality of the original games.

But here's the problem: finding these levels means browsing multiple websites, each with a different interface. Installing them usually involves downloading ZIP files, manually extracting them into the right folder, making sure the right version of the game engine is in place, and hoping everything works. If it doesn't? You're on your own.

Tomb Launcher changes that. It brings everything you need into one clean, modern interface. Search across multiple community sites, download with a single click, and start playing โ€” Tomb Launcher handles the setup behind the scenes. It also keeps track of everything you've played, so you can pick up where you left off or revisit old favorites anytime.

Whether you're a seasoned raider who's been playing custom levels since the early 2000s or someone who just discovered the TRLE community, Tomb Launcher is designed to make your experience as smooth as possible.


โœจ Features

๐Ÿ” Search & Discover

Finding custom levels used to mean browsing three different websites with very different search experiences. Tomb Launcher brings them all together.

You can search for levels from within the app, pulling results simultaneously from:

  • TRLE.net โ€” The original and largest Tomb Raider Level Editor community site
  • TRCustoms.org โ€” A modern, community-driven platform with rich metadata
  • AspideTR.com โ€” An Italian community portal with a curated collection of levels

Results from all sources appear side by side, so you can compare ratings, read descriptions, and pick the adventure that suits your mood โ€” all without leaving the app.

๐Ÿ“ฆ One-Click Install

Found a level you want to play? Just click Download. Tomb Launcher takes care of the rest:

  1. Downloads the level archive from the source
  2. Extracts the files into a managed folder
  3. Sets up the level so it's ready to launch

No more hunting for the right folder, no wondering if you extracted things correctly. Just click, wait a few seconds, and play.

๐ŸŽฎ Game Library

Every level you install lives in your personal library โ€” a clean, organized view of your entire collection. At a glance, you can see:

  • Which levels are installed
  • When you last played each one
  • How much time you've spent on each level
  • Whether a level came from TRLE.net, TRCustoms, or AspideTR

Think of it as your personal Tomb Raider dashboard.

๐Ÿ“Š Statistics

Curious about your gaming habits? Tomb Launcher silently tracks your play sessions and turns them into interesting insights:

  • Most played levels โ€” See which adventures you kept coming back to
  • Average session length โ€” Are you a quick raider or a marathon explorer?
  • Play patterns by day of the week โ€” Discover which days you raid the most
  • Disk space usage โ€” See how much room your collection is taking up, broken down per level

All data stays local on your machine. Tomb Launcher doesn't phone home or share anything with anyone.

๐Ÿ’พ Savegame Management

Each level's savegames are tracked and associated with the level itself. You can see your save files at a glance without digging through folders. Never lose progress again โ€” and never accidentally overwrite a save from a different level.

๐ŸŽฒ Feeling Lucky?

Can't decide what to play next? Tomb Launcher can pick a random level from your library for you. It's a great way to rediscover levels you installed months ago and forgot about.

๐ŸŒ Localization

Tomb Launcher is currently available in English and Italian, with more languages welcome (see Contributing).

The app automatically detects your system language and switches accordingly. You can also change the language manually from the settings.

๐Ÿ–ฅ๏ธ Cross-Platform

Tomb Launcher runs natively on both Windows and Linux. It's built with Avalonia UI, a modern cross-platform UI framework, so the experience is consistent regardless of your operating system.

On Linux, you can run it as an AppImage, install it via DEB/RPM, or build from source. On Windows, a traditional installer gets you up and running in seconds.


๐Ÿ“ฅ Installation

Head to the Releases page and download the latest version for your platform.

Windows

Download the .exe installer and run it. The setup wizard will guide you through the installation. Once installed, you'll find Tomb Launcher in your Start Menu.

Linux

Several package formats are available:

  • AppImage โ€” Download, make executable (chmod +x), and run. No installation required.
  • DEB โ€” For Debian/Ubuntu-based distributions. Install with sudo dpkg -i tomb-launcher.deb.
  • RPM โ€” For Fedora/openSUSE-based distributions. Install with sudo rpm -i tomb-launcher.rpm.

You can also launch Tomb Launcher from the terminal with tomb-launcher.


๐Ÿ—บ๏ธ Roadmap

Tomb Launcher is under active development. Here's what's planned for future releases:

  • ๐Ÿ› ๏ธ Built-in troubleshooting โ€” Automatically detect and fix common issues with legacy game engines on modern systems
  • ๐Ÿ•น๏ธ AntiMicroX integration โ€” Seamless gamepad support through AntiMicroX, so you can play from the couch
  • ๐ŸŽจ dgVoodoo integration (Windows only) โ€” A graphics wrapper that improves compatibility with modern GPUs, solving visual glitches and rendering issues
  • ๐Ÿ–ฅ๏ธ Widescreen fix auto-apply โ€” Automatically patch levels to support 16:9 and ultrawide aspect ratios instead of the original 4:3
  • โš™๏ธ Per-game settings โ€” Customize resolution, keymaps, and other options for each individual level
  • ๐ŸŽ macOS support โ€” A native build for macOS, bringing Tomb Launcher to Apple Silicon and Intel Macs

Have a feature request? Feel free to open an issue and share your ideas.


๐Ÿค“ For the Nerds

If you're a developer, here's what's under the hood.

Tech Stack

Layer Technology
UI Framework Avalonia UI
Runtime .NET 10
Architecture MVVM with CommunityToolkit.Mvvm
Database SQLite via Entity Framework Core
Charts LiveCharts2
Packaging PupNet Deploy (Linux), InnoSetup (Windows)

Building from Source

Prerequisites:

Clone and build:

git clone https://github.com/ALDamico/TombLauncher.git
cd TombLauncher
dotnet build TombLauncher.slnx

Run the application:

dotnet run --project src/TombLauncher

Run the tests:

dotnet test

Project Structure

The solution follows a clean separation of concerns:

TombLauncher/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ TombLauncher/              # Main application (UI, ViewModels, Services)
โ”‚   โ”œโ”€โ”€ TombLauncher.Core/         # Core logic (platform-agnostic, no UI dependencies)
โ”‚   โ”œโ”€โ”€ TombLauncher.Contracts/    # Shared interfaces and DTOs
โ”‚   โ”œโ”€โ”€ TombLauncher.Controls/     # Reusable Avalonia UI controls
โ”‚   โ”œโ”€โ”€ TombLauncher.Data/         # Database access and EF Core migrations
โ”‚   โ””โ”€โ”€ TombLauncher.Localization/ # Localization resources (i18n)
โ”œโ”€โ”€ tests/
โ”‚   โ””โ”€โ”€ TombLauncher.Tests/        # Unit tests (xUnit)
โ””โ”€โ”€ deploy/                        # Packaging configs (PupNet, InnoSetup)

The architecture keeps the core logic decoupled from the UI layer. TombLauncher.Core has no knowledge of Avalonia and can be tested in isolation. The UI layer follows the MVVM pattern, with ViewModels acting as the bridge between the views and the underlying services.


๐Ÿค Contributing

Tomb Launcher is not currently accepting code contributions. The project is in active early development and the architecture is still evolving.

However, if you'd like to help translate Tomb Launcher into your language, that would be wonderful! The app currently supports English and Italian, and adding a new language is straightforward. Feel free to open an issue to get in touch.


โ“ FAQ

Q: Is Tomb Launcher affiliated with Core Design, Crystal Dynamics, or Eidos Interactive? No. Tomb Launcher is an independent, fan-made tool. It is not affiliated with or endorsed by any of the companies behind the Tomb Raider franchise.

Q: Does Tomb Launcher include any game files? No. Tomb Launcher is a management tool. It helps you download custom levels from community websites, but it does not distribute any copyrighted game assets.

Q: Where are my levels stored? Tomb Launcher keeps its data in a local application data folder on your machine. You can see the exact path in the settings.

Q: Can I use Tomb Launcher to manage the official Tomb Raider games? No. Tomb Launcher is designed specifically for custom levels built with the Tomb Raider Level Editor (TRLE) and its derivatives, including TRNG, TombEngine, TR1X, and TR2X.


๐Ÿค– AI Disclaimer

Portions of Tomb Launcher's code have been written with the assistance of AI-powered coding agents. All AI-generated code is reviewed and validated by a human developer before being merged. The project maintainer takes full responsibility for the quality, correctness, and security of the codebase.


๐Ÿ“„ License

Tomb Launcher is released under the MIT License.


Made with โค๏ธ for the Tomb Raider community.

About

A Tomb Raider Custom Level management application

Resources

License

Stars

Watchers

Forks

Contributors