Community-maintained data overlay for tarkov.dev API corrections and additions.
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.)
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.
Browse the hosted monitor at monitor.nivmizz7.fr, or run it locally with:
npm run monitorThe monitor is read-only by default. To enable its local “Update overlay” action, explicitly opt in when starting it:
ALLOW_REBUILD=true npm run monitorSet REBUILD_TOKEN as well when exposing the rebuild API to another trusted
service. Authenticated callers should pass it in an Authorization: Bearer …
header. For backwards compatibility, ?token= is also accepted; use that only
for trusted local clients because query strings can appear in logs and browser
history. Rebuilds target the default dist/overlay.json output; custom local
and HTTP(S) overlay targets remain read-only.
The overlay is regularly validated against the tarkov.dev API to ensure corrections are still needed:
npm run check-overridesThis 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 testFound incorrect data? See Contributing Guide.
- 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
See LICENSE.