Skip to content

TryphonX/tuning-calculator

Repository files navigation

semantic-release: angular Contributors Github Issues GNU GPL v3 License Deployment Status CI Dev


Logo

CMS Tuning Calculator

Tune efficiently using this calculator to determine the optimal setups with the best cost to boost ratio for your job!


Visit App · Report Bug · Request Feature

About The Project

I update the app too often to keep the README up to date, but it should be close enough.

This web app tool is useful for tuning cars in the game (Car Mechanic Simulator 21). Provides a lot of functionalities that make tuning considerably easier as well as allowing you to explore the most efficient way of tuning the car to the desired boost percentage. All tuning combinations by this tool will always be "symmetrical" - it will not allow you to switch some of the same part with tuned parts, it's either all or nothing. This tool can also suggest the optimal setup if you want, or you can make your own informed decision.

(back to top)

User Manual

The use of this app is relatively easy. The process is split into 2-3 steps, depending on your choices. You can always go back to the previous step and change your choices, but keep in mind that changing your engine will clear all your previous choices.

First step

First step is to pick an engine from the dropdown menu in the Engine Card. To make things easier, the engines can also be filtered by configurations (I4, V6, V8, V12). When you pick an engine, the Engine Card is immediately updated and you are allowed to proceed to the next step. The dropdown menu is searchable, so you can type the name of the engine you want to find.

⚠️ Note: When you pick a new engine, all the choices you make in the other components will be cleared.

After making your choice, an image of the engine is shown along with its specifications. Engine specifications include power, torque and gearbox.

Second Step

Second step is where the two methods split up. You choose between Auto-generate and Manual.

Auto-generate

If you choose to auto-generate the optimal setup, you will be prompted to enter the desired target boost increase. Optionally, if there are damaged parts that you will have to replace, you can let the algorithm know. This way you might get a better deal if the damaged part is worth tuning instead of replacing with a stock one.

On the right side, you will see the Overview card, which will show you the target boost increase, whether you're including replacement parts and which ones. You then click proceed to move to the next and final step.

Manual

If you choose the manual appraoach, you will have to check the Available Parts Card and choose which parts to tune. The card will have a table with all compatible parts for that engine along with their boost increase, cost and cost/boost ratio. You can sort the table by any of the columns to make your decision easier.

On the right side, you will see the Cart card, which will be updating in real time with the total boost increase, total cost and total cost/boost ratio of the parts you have selected. When you're happy with your selections, you can use the build on the game. There is no third step for the manual approach, as you can see the results in real time.

Available Parts Card

This card will be now displaying a table with all (known) available parts for that engine. For each part, important info will be displayed in order to make the best decision about which parts to tune or not.

Specifically, for each part you receive this information:

The first column (checkbox column) is where you can choose the parts you want to tune. Simply click the checkbox of the part you want to tune and the part will be used in the calculation. Clicking the first checkbox will select (or deselect) all parts.

Information Description
Part (2) The part's name and how many times it appears on that engine
Boost* (3) How much boost the tuned version of the part will produce
Cost* (4) How much it costs to tune
Cost / Boost** (5) How many CR it takes to produce +1% of boost

* total, if the part appears multiple times in the engine
** not visible on small screens

⚠️ Note: When choosing a part that appears multiple times in an engine, keep in mind all of them will be added as selected parts. You can not add 1 of a part that has 2 on an engine.

Third Step

Third step -and final- step for the auto-generate approach is to check the Cart Card. It includes a list of all the parts you've selected along with their info (boost, cost, etc.) and their total values. If some of the replacement parts specified are used in the setup, you will also see them highlighted on the table and you will see their effect on the total cost.

Visit the app now to try it »

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch from dev branch (git checkout -b feat/amazingFeature)
  3. Commit your Changes
  4. Push to the Branch (git push origin feat/amazingFeature)
  5. Open a Pull Request to dev
  6. Pull requests will be reviewed and squashed into dev branch

(back to top)

License

Distributed under the GNU GPL v3 License. See COPYING.txt for more information.

(back to top)

Acknowledgments

(back to top)

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Tryfon Xydas
Tryfon Xydas

💻 🔣 📖 ️️️️♿️ 🎨 🚇 🚧 👀
Joshua Barrass
Joshua Barrass

💻 🔣

This project follows the all-contributors specification. Contributions of any kind welcome!

About

A useful tool for tuning cars in the game Car Mechanic Simulator 21. The app provides information about the tuning percentage of boost the car will get from the combination of parts the user chooses from a collection of compatible parts.

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages