# TempleRun-RL: reconstructing Temple Run mechanics for simulator training

> TempleRun-RL reconstructs Temple Run's track generation, hazards, and runner physics in a headless training simulator. A Frida gadget reads live state and calls game methods on an arm64 Android phone so the project can measure behavior and evaluate a PPO policy against the original. The author reports a longest device run of 16,782 metres.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/matthieucs/TempleRun-RL>
- Primary source: <https://github.com/matthieucs/TempleRun-RL/blob/ca34ece5e1faf123647cbaf2c02b159ba713e361/README.md>
- Catalog page: <https://awesomerea.org/resources/templerun-rl-case/>
- Record JSON: <https://awesomerea.org/resources/templerun-rl-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/templerun-rl-case/index.md)

## Requirements & limits

- **Prerequisites:** A non-rooted arm64 Android phone with USB debugging, adb, and a user-supplied Temple Run v1.39.0 APK are required for device evaluation.
- **Prerequisites:** The APK must be patched with a Frida gadget; the game is not included.
- **Testing evidence:** The C++ simulator was developed and tested on Windows only.
- **License:** Licensed under MIT.

## Primary sources

1. <https://github.com/matthieucs/TempleRun-RL/blob/ca34ece5e1faf123647cbaf2c02b159ba713e361/README.md>
2. <https://github.com/matthieucs/TempleRun-RL/blob/ca34ece5e1faf123647cbaf2c02b159ba713e361/docs/GADGET.md>

## More in Games

- [Test Drive II Enhanced: a C reimplementation of the EGA game](https://awesomerea.org/resources/test-drive-ii-enhanced-case/index.md) · Case study
- [Test Drive II: The Duel: an SDL3 reconstruction of the DOS EGA game](https://awesomerea.org/resources/test-drive-2-sdl3-case/index.md) · Case study
- [th10: reconstructing Mountain of Faith 1.00a for the browser](https://awesomerea.org/resources/th10-mountain-of-faith-case/index.md) · Case study
- [The Crystal Scrolls: a Crystal Space engine for The Elder Scrolls III: Morrowind](https://awesomerea.org/resources/crystal-scrolls-case/index.md) · Case study
- [The Force Engine: rebuilding the Jedi Engine for Dark Forces](https://awesomerea.org/resources/the-force-engine-case/index.md) · Case study
- [The Hobbit: reconstructing its graphics engine](https://awesomerea.org/resources/hobbitgfx-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.