🎯 Tarkov Pilot Sync

🛟 Need help or found a bug? Get support at support.doodesch.de/tarkovpilotsync.

Extends Tarkov Pilot to sync player positions, pins, and quests between multiple users on tarkov-market.com

Report Bug · Request Feature · Roadmap

---

📖 About

Tarkov Pilot Sync is a Chrome extension that enhances your Escape from Tarkov planning experience by allowing you to:

• 🗺️ Sync player positions in real-time with your squad
• 📍 Share map pins with CTRL+Click
• 📋 Track quests together with teammates
• 🔔 Get notifications when players join, leave, or change maps
• 📸 Screenshot Sync - Automatically detect in-game screenshots and sync your position to tarkov-market.com
• 📋 Game Log Sync - Automatically detect map changes and quest completions by monitoring Tarkov's logs

📸 Screenshot Sync Feature

The Screenshot Sync feature monitors your Tarkov screenshots folder and automatically sends your in-game position to tarkov-market.com.

Connection Modes

Option A: JavaScript API (Recommended) ⚡

1. Connect your Screenshots folder in the extension settings
2. Take a screenshot in-game (default: PrintScreen)
3. Your position appears on the map instantly!

💡 This mode uses the new window.pilot JavaScript API from tarkov-market.com for the fastest possible sync. No Hook-ID required!

Option B: Desktop App (Legacy)

1. Verify you're on Tarkov Pilot Desktop App Mode
2. Connect your Screenshots folder in the extension settings
3. Take a screenshot in-game (default: PrintScreen)
4. Your position appears on the map within milliseconds!

Option C: Hook ID (Slowest)

1. Get your Hook-ID from tarkov-market.com/pilot
2. Enter the Hook-ID in the extension settings (Screenshot Sync → Connection Mode → Hook ID)
3. Connect your Screenshots folder
4. Take a screenshot in-game (default: PrintScreen)
5. Your position appears on the map (may take a few seconds, based on tarkov-market API response time)!

💡 Tip: Grant permanent folder access ("Allow on every visit") to avoid re-authorizing after browser restarts.

📋 Game Log Sync Feature

Game Log Sync monitors your Tarkov logs folder to automatically detect when you enter a raid - the map on tarkov-market.com switches automatically!

Setup

1. Enable Game Log Sync in the extension settings
2. Connect your Logs folder: Usually at %LOCALAPPDATA%\Battlestate Games\EFT\Logs
3. Start a raid - The map switches automatically!

⚠️ Note: Game Log Sync requires Screenshot Sync to be in JavaScript API or Desktop App mode. Hook-ID mode doesn't support log data.

Perfect for coordinating raid strategies with your squad!

---

🐛 How to Report a Bug

Found a bug? Help us fix it by following these steps:

Step 1: Download Debug Logs

Debug logs contain valuable information that helps us identify and fix issues quickly.

1. Open the Extension Options

   • Right-click the Tarkov Pilot Sync icon in your browser toolbar
   • Click "Options" or go to chrome://extensions → Tarkov Pilot Sync → Details → Extension options

2. Navigate to Advanced Settings

   • Scroll down to the "Advanced Settings" section

3. Download the Logs

   • Click the "Download Debug Logs" button
   • A JSON file will be downloaded: tarkov-pilot-sync-logs-YYYY-MM-DD.json

💡 Tip: Enable "Debug Mode" before reproducing the bug to capture more detailed logs!

Step 2: Create an Issue

1. Go to the Issues page

   • Create New Issue

2. Use this template:

## Bug Description
A clear and concise description of what the bug is.

## Steps to Reproduce
1. Go to '...'
2. Click on '...'
3. See error

## Expected Behavior
What you expected to happen.

## Actual Behavior
What actually happened.

## Screenshots
If applicable, add screenshots to help explain your problem.

## Environment
- Extension Version: [e.g., 3.3.0]
- Browser: [e.g., Chrome 120]
- OS: [e.g., Windows 11]

## Debug Logs
[Attach your debug log file here]

3. Attach your debug log file
   • Drag and drop the JSON file into the issue, or
   • Click "Attach files" and select it

What's in the Debug Logs?

The debug log file contains:

Section	Description
extensionInfo	Version, browser, platform info
currentSettings	Your current extension settings
consoleLogs	Console output from all extension contexts
storageData	Current storage state (connection info, etc.)

⚠️ Privacy Note: The log file may contain your Room ID and player name. Review the file before sharing if you're concerned about privacy.

---

💡 Feature Requests

Have an idea for a new feature? We'd love to hear it!

1. Check if your idea already exists
2. If not, create a new feature request

Please include:

• What you want to achieve
• Why this feature would be useful
• How you envision it working (optional)

---

🔧 Troubleshooting

Common Issues

Extension doesn't connect

1. Make sure you're on tarkov-market.com/maps/*
2. Check if the WebSocket server is reachable
3. Try disconnecting and reconnecting
4. Check the console for error messages (F12 → Console)

Players not showing on map

1. Ensure all players are in the same room
2. Check if players are on the same map
3. Verify "Same Map Only" settings in Pins/Quests sections

Pins not appearing

1. Check if "Enable Pins" is turned on in settings
2. Verify you're using CTRL+Click to place pins
3. Check "Same Map Only" setting

Screenshot Sync not working

1. Check the status indicator on the map (bottom left)

   • 🟢 Green = Connected and working
   • 🟠 Orange = Configuration incomplete or folder not connected
   • 🔴 Red = Error occurred

2. Verify your connection mode

   • JavaScript API mode (Recommended): Just connect your Screenshots folder - no additional setup needed!
   • Desktop App mode: Verify your Mode is set to "Desktop App" on tarkov-market.com/pilot
   • Hook ID mode: Verify your Hook-ID from tarkov-market.com/pilot (must be a valid UUID format)

3. Reconnect the folder

   • Click the status indicator on the map, or
   • Go to extension settings → Screenshot Sync → Select folder

4. Grant permanent permission

   • Click "Allow permanently" in settings
   • Select "Allow on every visit" in the browser dialog

5. Check the screenshot format

   • Only .png files are detected
   • Filename must match Tarkov's format (contains timestamp)

Game Log Sync not working

1. Check your Screenshot Sync connection mode

   • Game Log Sync only works with JavaScript API or Desktop App mode
   • Hook-ID mode doesn't support log data

2. Verify the logs folder

   • Default location: %LOCALAPPDATA%\Battlestate Games\EFT\Logs
   • Make sure you selected the Logs folder, not a subfolder

3. Check if Tarkov is running

   • New log folders are created when Tarkov starts
   • The extension monitors the latest log folder

4. Grant permanent permission

   • Click "Validate Connection" in settings after connecting

Still having issues?

Enable Debug Mode in Advanced Settings and reproduce the issue. Then download and share the debug logs in your issue report.

---

📜 License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.

---

Made with ❤️ for the Tarkov community

DooDesch