Skip to content

Nivmizz7/tarkov-data-overlay

 
 

Repository files navigation

tarkov-data-overlay

Community-maintained data overlay for tarkov.dev API corrections and additions.

Why?

The tarkov.dev API is an excellent resource, but game updates sometimes outpace data updates. This overlay provides:

  • Corrections: Fix incorrect data (task levels, map requirements, etc.)
  • Additions: New data types not in tarkov.dev (game editions, etc.)

Usage

Fetch the overlay from jsDelivr CDN:

https://cdn.jsdelivr.net/gh/tarkovtracker-org/tarkov-data-overlay@main/dist/overlay.json

Then merge it with tarkov.dev responses. See Integration Guide for details.

Monitor

Browse the hosted monitor at monitor.nivmizz7.fr, or run it locally with:

npm run monitor

Maintenance

The overlay is regularly validated against the tarkov.dev API to ensure corrections are still needed:

npm run check-overrides

This command compares all overrides against current API data and reports:

  • ✅ Overrides that are still needed
  • 🔄 Corrections that have been fixed upstream (can be removed)
  • 🗑️ Tasks that have been removed from the API (can be deleted)

Run this periodically to keep the overlay lean and accurate.

For local checks:

npm run validate
npm run typecheck
npm test

Contributing

Found incorrect data? See Contributing Guide.

Data Governance

  • This is community-maintained, best-effort data
  • All corrections require proof (wiki links, screenshots)
  • Not a replacement for tarkov.dev - a bridge during data gaps
  • Transparent history via Git

License

See LICENSE.

About

Data overlay for Tarkov.dev API data.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages

  • TypeScript 79.5%
  • JavaScript 13.7%
  • HTML 4.7%
  • CSS 2.1%