A new and modern engine for custom Tomb Raider levels, incorporating classic features and new enhancements.
Find a file
2024-10-20 21:38:01 +02:00
.github/ISSUE_TEMPLATE Update bug_report.yaml 2024-05-19 21:48:12 +01:00
Documentation Fixed vehicle and Lara in HUB system level change 2024-10-15 15:18:51 +02:00
Libs Sound engine enhancements (#1141) 2023-06-17 12:02:51 +01:00
Scripts Add "Lara's Home" menu entry (#1394) 2024-08-11 17:20:09 +01:00
TombEngine Clarify Lua API for SetOnCollidedWithObject() 2024-10-18 00:14:02 +01:00
Tools/Enum generation Cleanup generateobjects.lua and move it back into Enum generation 2022-09-13 21:22:21 +01:00
.gitignore Implemented fog bulb (#1110) 2023-05-31 09:12:20 +01:00
AUTHORS.md Update AUTHORS.md 2024-08-11 09:57:14 +01:00
CHANGELOG.md Fixed ghost collision with moveables with zero bounds 2024-10-16 00:59:37 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2024-05-15 23:43:08 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md 2024-05-16 08:24:36 +01:00
IMPORTANT_LINKS.md Update IMPORTANT_LINKS.md 2024-05-19 22:24:46 +01:00
LICENSE Create LICENSE 2024-08-11 12:12:10 +01:00
pull_request_template.md Update pull_request_template.md 2024-05-16 09:34:09 +01:00
README.md update README and remove stray objID.txt from main folder (already located in Tools folder) 2024-05-16 09:26:47 +01:00
TEN logo.png add TEN logo 2024-05-19 22:22:20 +01:00
Title Image.psd Solve legal in pictures 2021-10-02 19:17:13 +03:00
TombEngine.sln x64 version (#1113) 2023-05-21 16:01:27 +01:00

TombEngine

Logo

In the year 2000, Core Design granted us a great gift: their TR4-based Level Editor, which allowed people to create custom levels. It was, unfortunately, quite limited, hence why over the decades it was upgraded massively with fan patcher projects such as Tomb Raider Engine Patcher (TREP) and Tomb Raider Next Generation (TRNG).

TombEngine (TEN) is a new, open-source engine which aims to abolish all limits, fix bugs from the original games, introduce new features while refining old ones, and provide for a refined, user-friendly level creation process. Current support includes:

  • Lua (as the native scripting language)
  • All objects from the classic series (1-5)
  • Many more exciting gameplay functionalities such as diagonal shimmying and expanded crawlspace flexibility
  • An enlarged 2D map, allowing for the creation of massive levels (imagine one big level may previously have been split into five!)
  • A streamlined player control scheme.

If you would like to participate in TEN discussion with other TEN devs whether it is contributing, bugs or general discussion, then join this discord server: https://discord.gg/h5tUYFmres

Tomb Engine should be used in conjuction with Tomb Editor. Tomb Editor is also open source written in C#, you can find the repository here: https://github.com/MontyTRC89/Tomb-Editor

Compiling TombEngine

To compile TEN, ensure you have installed:

  • Microsoft Visual Studio
  • Tomb Editor (if you would like to create and test levels)

Steps:

  1. Clone the repository to your GitHub Desktop
  2. Launch TombEngine.sln and compile
  3. Once compiled, create a separate folder to serve as your main TEN directory
  4. Copy everything inside the Build folder to the main TEN directory
  5. Copy the Scripts folder to your main TEN directory
  6. Ensure you have the necessary level data and texture files as well
  7. In the case Windows warns about missing DLLs, (bass.dll, etc.) copy the missing DLL files found inside the Libs folder to your main TEN directory.

Visual Studio may also warn about NuGet packages. To fix:

  1. Delete the Packages folder
  2. Go back to Microsoft Visual Studio
  3. Right-click on the TombEngine solution in the Solution Explorer tab and select "Restore NuGet Packages"
  4. Compile again and once done, you should be able to compile a level with TombEditor and run it in TEN.

Disclaimer

We do not and have never worked for Core Design, Eidos Interactive, or Square Enix. This is a hobby project. Tomb Raider is a registered trademark of Square Enix; TombEngine is not be sold. The code is open-source to encourage contributions and to be used for study purposes. We are not responsible for illegal uses of this source code. This source code is released as-is and continues to be maintained by non-paid contributors in their free time.