TarkovTracker
TarkovTracker is a progress tracker meant to help players of Escape From Tarkov. The core goal of the project is to provide insights into what to do next, and make it easier to work with friends as you progress to Epsilon, Kappa, Trader loyalty levels, or a maxed out hideout.
Data Management
Tarkov Tracker has some prebuilt data baked in. This is the quest and hideout data encoded in JSON. The questData.json and hideoutData.json files are deployed with the application, and imported at runtime for reference. These files are a git submodule of the https://github.com/TarkovTracker/tarkovdata repository. Structural changes to these files may break TarkovTracker, so for now this data will be manually pulled to newer versions to verify data integrity.
Environment Management
Prerequisites
- Node v14 (LTS) or higher
- Firebase Tools (npm package installed globally)
Setting up Google Cloud Platform and Firebase project
It is necessary to create Google Cloud Platform project and Firebase project to be able to run local Firebase emulator. The reason is simply because the Firebase CLI tool authenticates you against Google servers. Nothing will actually be deployed or used within your Google Cloud Platform project, you will not be charged, but it is a necessary step to run and develop this project locally.
- Create a project within Google Cloud Platform (e.g. 'tarkov-tracker')
- Create a project within Google Firebase and link it to your Google Cloud Platform. It should prompt you automatically.
Setting up the environment
First time setup can be done by running the following:
git clonethe repositorygit submodule initto set up the TarkovData submodule (required)git submodule updatepulls the pinned commit for the submodule (required)npm installinside the repository to install all the dependenciesfirebase loginwill open your browser and ask you to login to your Google account associated with your Google Cloud Platform project and your Firebase projectfirebase use --addand select the project you created earlier (it should offer you only that one) - if you don't see any projects in the list, make sure you've done all the steps in previous section properly
If you work on anything that utilizes the Firebase Cloud Functions, you will also need to run npm install inside the functions folder.
Now you can run the project locally!
Running local environment for testing/development
npm run serve results in localhost:5000 for Web APP, and localhost:4000 for emulator UI
You can modify the serve command and run as npm run serve:persist to keep Firebase emulator data across multiple sessions of the emulator. Otherwise, the firestore database and authentication will be reset each emulator session.
Access the local environment at http://localhost:5000 by default. This project is built to be hosted via Google Firebase. The Firebase Emulator will be installed via npm when setting up the project. Included is a hosting, database, authentication, and function emulator. The emulator console is available at http://localhost:4000 by default. These resources cost money to run on the production version of TarkovTracker. Thankfully to Patrons, this is covered, and isn't a blocker to new features utilizing them, but please be aware of the scale of potential resource use of new features!
361 Dec 27, 2022
92 Apr 21, 2022
1 Nov 3, 2021
12 Jul 11, 2022
1 Jan 12, 2022
6 Nov 1, 2022
150 Dec 24, 2022
199 Dec 27, 2022
58 Dec 17, 2022
6 Jan 12, 2022
6 Jul 24, 2022
0 Nov 8, 2021
4 Oct 25, 2022
0 Nov 14, 2021
1 Feb 9, 2022
0 Dec 20, 2021
1 Jan 10, 2022
1 Feb 18, 2022
81 Dec 15, 2022