Engine Simulator is a real-time internal combustion engine simulation focused on audio and engine response. It is not a scientific tuning tool.
For community releases, see https://github.com/Engine-Simulator/engine-sim-community-edition. This repository focuses on source, assets, and tooling.
docs/overview.mddocs/quickstart.mddocs/architecture.mddocs/configuration.mddocs/development.mddocs/troubleshooting.mddocs/reference/controls.mddocs/reference/scripting.mdAGENTS.md
- Windows 10/11 (DirectX 11)
- CMake 3.10+
- Visual Studio C++ toolchain
- Git with submodules
git clone --recurse-submodules https://github.com/magasiev13/engine-sim.git
cmake -S . -B build -G "Visual Studio 17 2022"
cmake --build build --config Release --target engine-sim-appRun engine-sim-app.exe from the build output directory and ensure assets/ and es/ are reachable. See docs/configuration.md for delta.conf and working directory details.
cmake --build build --config Debug --target engine-sim-test
ctest --test-dir build -C Debug- Runtime asset paths:
configuration/delta.conf - Script entrypoint and engine selection:
assets/main.mr - Build options:
DTV,PIRANHA_ENABLED,DISCORD_ENABLED(seedocs/configuration.md)
engine-simlibrary implements the simulation core (src/,include/).engine-sim-apphosts the UI/audio loop (src/engine_sim_application.cpp).- Piranha scripting compiles
assets/main.mrusing the DSL ines/.
See docs/reference/controls.md.
This project was made possible by the generous donations of the following individuals!
| Devin@Hondatuningsuite | nut | Devin C Martinez | WelcomeCat | Saints Sasha |
| Ida 8858 | Emily | Steelorse | Kruddy | Sgt. Fluff |
| darcuter | FatFluffyFox | Benton1234 | Jim C K Flaten | The Zuck |
| Blade Skydancer | Ye' old apple | Hayden Henderson | AlphaX | Lucas Martins Bündchen |
| Jay Dog | damo | IBS-IS-CRAP | Snowy | Noah Greenberg |
| Eisberg | Brendan M. | Alex Layton | Lukas Bartee | Thibaut Dubuisson |
| The Cheeze Ity | JoeJimTom | MichaelB450 | Björn | Bartdavy |
| sasha bandelier | Caleb Black | COOKIES | Andrew Cooper | asimo3089 |
| Vim Wizard | Kevin Arsenault | Carl Linden | Kele Tappi | Kroklethon |
| labourateur | viperfan7 | SlimmyJimmy | Jason Becker | Sascha Kamp |
| ves | Supernalboot | BeamNG | Paul Harrison | Tyler Russell (Nytelife26) |
| nicholas jacobs | DrDotMadness | AVeryPlainTyler | Zach Perez | Paul Schaefer |
| Clay Bauer | CR33DYM0N14 | julien nadeau | Patt313 | Philip Edwards |
| RegularRuby670 | Mateusz Ładosz | FémLol Stúdió | Crazy Yany | Elden |
| Tristan Walker | Matthew McDonald | Jan-Sander Huiting | Mitchell Almstedt | Dylan Lebiedz |
| Name Here | LoganBoi FNAF | Epic Randomness | MrPiThon | mike |
| dung | Alvaro ArroyoZamora | Skinna Godwin | BeppoBarone | レナVA |
| Sabata | Brady Fulham | Powerpuncher | NK10K | Gavin Osowski |
| Orbitstrider | Steven Doyle | Jaksu2696 | Toni | Devin Abolins |
| Boosted Media | Matthew McLennan | Venican | Lyan le Golmuth | Alberto R. |
| BetaToaster | Akira Takemoto | J Anderson | Apolly007 | LexLuther |
| xilophor | Robert K | viktor lind | Adrian Kucinski | sarowie . |
| Chris Fischer | Marlod | Chase Hansen | Aidan Szalanski | Andrew Taylor |
| Jason Hwang | Juuso Natunen | Ian Moss | PickleRick | Beljim46 |
| RSOFT92 | UCD | Sped | OldManJenkins | James Hart |
| Kalle Nilsson | XxBrasta455xX | Colin Sandage | Dakota Mackinnon | Carter Kopp |
| Jakub Kozak | CJ Plessas | Loizeau | Charles Mills | YellowLight |
| Didrik Esbjug | Alessandro Dal Pino | Carter Williams | Robert D | Cadence Plume |
| BLANK | Provenance EMU | Dylan Engler | Nathan Rojas | Cornelius |
| Acid | larsloveslegos | Maxime Desages | GM | BreadForMen |
| Devin Freeman | Lieven RYCKEBOER | Amelia Taylor | Jelle Plukker | sodmo |
| Jimmy Briscoe | Cirithor | Martin .K | DMartland | Lucas Diem |
| Richard Budíček | Jack Sheppeard | Meemen | Anderson Huynh | NPException |
| Mattia Villa | C | AIDAN POWELL | Brenn_the_Otter | Lane Mosier |
| Ceze | oranjest1 | Jw | ISON | Mathew Graham |
| MACHINA | John Crowell | Asher Blythe | Cronos Skies | Matt Amott |
| CpTKugelHagel | Simon Krayer | Caleb Bek | Monster Man25 | GeneralMoineau |
| EsuKurimu | Caleb Sartin | Jared L. | Hunter Wood | Ben Poole |
| Steven Victoria | Jordan Zondlak | Agelessgod | Christopher Fahs | Jonathan Vincent |
| Dalton Guillot | Simon Stojanovic | Andrew Urbanczyk | deniaL | Tyler Hughes |
| vPam | Justin Kruithof | Curtis C Coomber | Sawyer Clark | Mike Hart |
| Ciro Rancourt | Miles Guo | Rewind | E=mc^2 | Keaton Call |
| J.Es | Jeremy B | Chance Hall | Jack Tompkins | Race Sim Studio |
| Quentin ZAOUI | Floyd Henderson | James Haylow | Milkshiekh | Wyatt Todd |
| User 2820 | Leon Schutte | CYBERBUG_JR | sebiii | Keegan |
| Victor Cosiuga | Rolly ! | Elias Pettersson | Tyson Makovec | Bill McDermott |
| Phontonic | Simon Armstrong | avec | KidozyGAME (Dead) | Stephan Cote |
| Justin Biggerstaff | Jabba Jubba | notD34THNIGHT | Inventor | Wesley Bear |
| Supersonic2510 | Pixel | Simon Bernhardt | Bas Vangermeersch | ToyotaCipra |
| kyle crawford | ApatheticWood | Ben Vaughn | Erich Westhoven | Zack Myers |
| Tbjoern | Vetle Høgås | Derek Thom | Aaron Beck |
| Karol Szép | Leon Jordan | Nathan Higginson | Patrick F | Samuel Picard |
| Alexander Fritsch | Lucas Scarpi | Jack Humbert | G2Eneko | SweCreations |
| Marius Becker | Cedric Wille | infernap12 | Julian Dinges | Wamuthas |
| Alex Mason | Hawar Karem | Melonenstrauch | Jacek Dębski | Alex Eastman |
| Darren Taing | Po Wang | Giorgio Iannucci | Levis | Eden |
| Alin Chiparatu | Arjun Mandakath | A.M. | Dylan Ryan | Noah Entrekin |
| GT130 | Josh D | generic | Henrik Cohrs | Nic Yetter |
| Dan Fredriksen | 153AN1MJ | Rasmus | EpicEcho | Kaur Hendrikson |
| Maddox Partridge | L33TIFY_ | Zack Fletcher | teiiio | Mike Zaite |
| Evan Sonin | Christopher Zimmerman | PrefacedVase | funtomr | Triton Alabaster |
| appelpie | Julien Ferluc | AnomalousFerret_ | Miles Orozco | Spencer Teeter |
| ThatCanadian | Harry Prabowo | Dylan Rogerson | Jaedyn Allen | Zephyr Sefira |
| Alexander Stone | Mason Little | Wojciech Czop | ryzen5 | Kosta Diamantis |
| Karol Stodolak | Tim van der Linde | Loïc Ruttner | jonthefuzz | AsgarK |
| James Morgan | Elijah | 1ntl | Tobias Johansson | Mome |
| P | SOPA_ | Shingekuro | Sean King | Russell Marsh |
| Alyx Ranas | Naters305 | ChrisakaMrXD | Nic | sean |
| Zach Hagedorn | Jhon lenon | Everett Butts | Kyan | ranger Nation |
| Hiago Oliveira | Texi | MrRhody | Inglorious Bastard | Marty Mitchell |
| Justin Chao | ManuelS | Cornelius Rössing | Pedro Freire | Anthony Stuart |
| Hubba Nubba | Skychii | Joe Underwood | Xander_ | Notbigdank |
| Sander D. | Lars Joosten | Danksa | Metrostation | Myles Wommack |
| Derrick Sampson | Corey Hannen | Matteo La Corte | Octothorp Obelus | David Baril |
| Soyuz Kafire | Ivan Coha | BigElbowski | Apolepth | Julian Krad |
| David Soulieres | Eric Huang | Léo Vias | Riccardo Mariani | Vic Viper |
| Shinkaaaa | Mumaransa | Michael Banovsky | Hendrik Voss | Inverted Blackhat |
| skipyC | Tobias Moor | jaky3 . | Clément LEGRAND | Ian C. Simpson |
| Challier | Jan Przemysław Drabik | Dsand23 | Smooth DLX | The German Dude |
| CrazyEagle | Jordon Goodman | HenryWithaG . | Oscar Krula | Brayden Moore |
| Steven | Nall Wolfert | papajonk | Andrew | Ben Kingston |
| Julian Vogl | Maxime Lubrano | MrMekouil | Doudimme | Jacob Hultberg |
| Nolan Orloff | Mike | tobi9899 | Danila Frolkin | Xecotcovach |
| Aj | Carcar404 | John Martin | Dominik Greinert | Lukas Stadler |
| Oliver Yang | sonax51 | Marcel Kliment | Chris | David Rush |
| LethalVenom13 | Dave Osterhoff | Anto1709 | Ben | Morgan Munroe |
| Ivor Forrest | Sam Hopkins | Atte | Dax | William Bergström |
| homelessmeme | Thanleft | Zaxerg | Robeloox | Maximilian-Lukas Marz |
| Morgn | Seth Monteleone | playfulmean videos | Lanimations LA | Bram G |
| Benoit Fournier | Bernar Lepiller | Nicolas Baur | the | Snekers |
| Darkmount | Tobiasz Michalik | Aidas Ri | Daniel Postler | Skim_Beeblez |
| Impetus | Thunderbird324 | Fred Joss | Krzysztof Radowski | Azerrty |
| Harrison Speck | Matt Baker | BigLynch | Markus Pelto | IMBIBE |
| James L Plummer | Rose Giles | Jonas Brekka | HASTRX | Lepoucehumain |
| Naomi Humin | qkrrudgks | Johann Gross | Janis Knappich | WhatTheDuck |
| 테루 | Glimple Bort | Jacob Tudisco | Tanner | Julian kaspi |
| nathan gould | Randal Rainis Kruus | Beppierre | Craig Martin | Thomas Bukovsky |
| Colaxe | Robert Oram | Matsuy15 L | Kacpe | Alex Sedlic |
| Mark Benson | Mhenn! | Anders Nelson | Dingus | Rustle |
| Marco Schulz | stratum | brochier gabriel | Thomas | brody of hillcountry |
| Thomas Afford | Brody Blaskie | Martien Gaming | Adrien MC | William A Grubbs |
| Trevo Ph.D. | Donovan Gibson | Polish R3t4rd | Keith Price | LAWL CAKE |
| Rhien Schultz | FireThrow13 | Seraphim | Titus Standing | Matt Miklos |
| B Dub | Jonathan Ekman | Al Pomeroy | Vestii | Wil |
| adrian | Airatise | TJ Sinkoski | Shotts SilverStone | Reagan Carbaugh |
| WarAestheticsRebooted | Aidan Case | Casey Bryant Goodwin | Konrad | Adam Larcher |
| Kazar Xin Xiao | Riccardo Marcaccio | William S. | Francis Filion | Loïc |
| Kenny Deane | Blackspots | mike | MXT | Joshua Gibson |
| milky boi | Hagen | gunmaster929 | jgvan | Benny 282 |
| Sean Wehner | Christian Poole | Ethan | Tsukiyama Shuu | Ooof_uhhh_haah |
| sano ken ch | Diego Martinez | Chuck | GalaxyFrogs | TheGeForce |
| Chriphost | Carthage | Greg L | Chipskate | Muhammed Mehmood |
| Hamilton Sjoberg | Amina Moh | vSiiFT | Jeremy Wren | Esteban Acosta |
| John A Ullenberg | Michael Morozov | Andrew Webberley | Nathaniel Lim | Aaron Ksicinski |
| Apocalypt | Josh batuzich | Ed | Hunter | Gene Brockoff |
| Redheadspellslinger. | Pablo Magariños | Nilz | Jose Manuel Silva Calvo | AJ |
| Ethan Wille | Aurora | Derek Shunia | Jan | Nope Mircea |
| Giancarlo Cestari | Tanner Edge | brad. | Connor Merrick | Martin Scholer |
| Deppy | Dan Smith | Tyson | Jac Comeau | Itemfinder |
| Tischer Games | Pedro Henrique | BeenWashedUp | martin wolff | Kurt Houben |
| Thomas Onslow | Brendan Puglisi | Kai Anquetil | Rudolph Ignatenko | CloudHackIX |
| Zach Carreau | Jonathan Vanderlyn | Krobivnov | ienergy | Leifster |
| Mikael Kaaronen | Glen | H.Helsing | ange | The Nobles |
| Johnathan Johnson | Juha Merentie | Jim Fares | Tom Marshall | Superferrariman |
| Zakary Zisa | JustTy | 晟道 杜 | Dnialibr Williams | Takumi Fujiwara |
| Koen van Hal | Jonathan Hill | Marco Siciliano | Kevindosenfutter | Angry Prawn |
| Natharic 67 | Rafael Monteiro | Jacob Ashline | ChironTheFloof | Caleb Dauphinee |
| Tony | Zac L | AlainMoto FPV | eirik johan johnsen | Elderet |
| Miles Longmore | lemon head | Viccy | Casey | Kajetan Cupa |
| Conejero00 | Bill Gricko | A cow wearing a turban | Danni Nowicki | Udo Schmidt |
| Tyler Swords | Constellation Gaming | Manimo | valentine | Jules Schattenberg |
| Brandon Crotts | Philipp Popetschnigg | Tiziano Della Fazia | goodgamer1109 | Joshua Thomas |
| Jeff Testa | Avery Snyder | Josh Kern | Triptagram | Bayon Antoine |
| Iván Juárez Núñez | Amery Martinat | ElArGee | Cory Green | lucas Di lorenzo |
| Caleb Sandersier |