Featured Raid Review 0.2.0 - v3.9.X

Please do not ask when mod authors will update their mods to 3.9.X
Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.

A web-based post raid replay system of your SPT raids; detailed replay system with heatmap overlay, review kills, lootings, positional data, and just get a general understanding of what was going on in your raids!

ULt1vXv.png


To use this mod, make sure the SPT Server is running, play a few raids with the mod installed of course.


Once you've played a few raids, open the web client from in-game by hitting F5 or opening your browser, and going to http://127.0.0.1:7829.


DO NOT EXPECT UPDATES/BUG FIXES
I am taking a hiatus from life for the next few months by packing up and travelling

As such I'm not planning to have access to a gaming machine until at least mid-october, so gaming/modding will take backseat for a while.

All my code for this is open source, so you're welcome to fix bugs / redistribute the mod as you wish if you cannot wait until then, I don't mind, and if anything, I would encourage it.

Thanks for the support, and enjoy the mod 🙂✌🏾


Installation

Download your compatible version from the 'versions' tab.


Each particular version will have specific installation / upgrade notes, please refer to this before commenting!

Features

  • Review information for raids such as kills, looting, players, bots, and positional information.
  • Basic toggle filters/grouping features to view raid information after the fact.
  • Replay and visualize positional movement and events that occurred throughout a raid.
  • Follow a specific/player by clicking on them.
  • Click on an 'event' in the timeline.
  • Focus/highlight a player by hovering over name in the Legend panel.
  • Toggle various visualizations to hide and show markers on the map.
  • Toggle map layers to see different levels of a map.
  • If you have SAIN installed, see detailed information about the personality type and bot type.

Credits / Thank Yous

  • The entire SPT team for an amazing framework, and documentation.
  • SPT Discord, specfically people active in the 'mod-development' and 'dev-community' channels.
  • The folks over at 'tarkov.dev' for having an Open Sourced MIT Licensed repo that I could fork the interactive map from, litterally saved me weeks of work.
  • You for downloading the mod, and taking the time to install it.

Support

100% do not ever feel obligated to support, but a coffee would be nice.

kofi5.png

Images

Thumbs Up 17 Heart 27 Happy 1

  • Version 0.2.0 - v3.9.X

    • ekky
    • 14k Downloads

    💥 Ballistics/Projectile Tracking, Charts, and UI Rework

    Please refer to installation/upgrade notes in the link, especially if you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    G'day nerds, last update for a few months will be AFK for ~10 weeks, so unlikely you'll see this project get updates for a while, if you're a smart cookie you can fix bugs yourself.


    Anyway, here are the goodies:

    - 🎯 Added ballistics/projectile tracking, now all ballistics and projectile paths are tracked and displayed in the replay mode. EXAMPLE

    - 🖼 UI Rework, with my future plans for a public hub, I reworked the UI so I could share interfaces and code between a public and private instance of the web client. Nothing too crazy, but it's much easier to navigate now, and adding features will also be easier. EXAMPLE

    - 🔥🦊Firefox compatibility is back! All you Firefox enjoyers can thank Drwsif

    - 📈 Added a charting library to the Web Interface, and calculated stats such as Active Bots, Kill Activity, Looting Activity, and Projectile Activity throughout a Raid. Should help all of you that use this mod for Spawn/AI Overhaul debugging. EXAMPLE

    - 📋 Implementation of a per raid leaderboard so you can quickly see all the players/bots, including total kills, looting, and projectile accuracy.

    - 🚰 Fixed memory leak for Loot Tracking, which also fixed compatibility with Realism Mod, so the mask breathing issue is fixed now (sorry about that).

    - 🐞 Various bug fixes, mostly one's found by Chazu related to the SAIN integration, thank you, you're a legend!

    - 🔧Configuration file changes for server-side mod, now allows for the Raid Tracker timeout settings to be adjusted (niche request).


    Uploading 3.8.X Version Soon
    - I will say that this will be the final 3.8.X compatible update, all future updates will be for 3.9.X, from the looks of things I'm one of the few last 3.8.X enjoyers, so I'll move onto 3.9.X when I return.

    Thumbs Up 2 Heart 5

  • Version 0.1.1_NEXT - v3.9.x

    • ekky
    • 4.1k Downloads

    ⬆️ Upgrade to support SPT v3.9.X

    ⚠️ Early port to 3.9.X - this has not been extensively tested, I ran three raids, two of which had SAIN 3.0 installed, and they all worked.

    Please refer to installation/upgrade notes in the link, especially if you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    The exact same as the v0.1.1 Released for v3.8.X, this is just a compatibility upgrade to v3.9.X.


    Known Issues

    Not compatible with Mozilla Firefox, issues rendering the playback system.
    Integration with SAIN 3.0.0 does not pick up on bot difficulty, only personality.

    Thumbs Up 2

  • Version 0.1.1 - v3.8.x

    • ekky
    • 600 Downloads

    🚀 Performance update, heatmap changes, bug fixes and project clean-up

    Please refer to installation/upgrade notes in the link, especially if you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    Yo; few changes, so have a read if you're interested.

    v3.9.0 will be my next milestone, it will just be this version (v0.1.1) compatible with v3.9.0


    Otherwise, install and have fun!

    • 🚀 Performance fixes; updated playback system to use HTML Canvas instead of SVG DOM Elements for faster and smoother animations.
    • 💧 Fixed memory leak; discovered memory leak in the playback that would draw 80,000 extra nodes than required and would continue to build up overtime until the browser crashed (my bad; too little sleep I suppose... no one reads these patch notes right?).
    • 😪 Project changes; restructured projects so I could start sharing components between private and public instances of Raid Review (coming soon tm).
    • 🗺 Playback interface: slight changes to the UI, and better exposure of the positional/heatmap toggle.
    • 🧠 Added caching: utilising client-side caching for positional data, should help with load times.
    • 🐞 Bug fixes; other various bug fixes and changes.
    • 🔧 Other changes...

    Thanks for reading ✌️


    Known Issues

    Not compatible with Mozilla Firefox, issues rendering the playback system.
    Integration with SAIN 3.0.0 does not pick up on bot difficulty, only personality.

    Heart 1

  • Version 0.1.0 - v3.8.x

    • ekky
    • 665 Downloads

    🔥Heatmap feature, Fika support, massive refactors & stability fixes

    Please refer to installation/upgrade notes in the link, especially i    f you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    The change list is light because I cannot be bothered to go back and summarise all the commits, but a ton of work has gone into this version.

    Massive shoutout to Chazut, stk2008, olli and whoever else helped with testing this build.


    New Features

    • Heatmap feature, now available via a toggle in the playback settings. @ ekky
    • Fika support is now functional, but not 100% complete, if you've used previous work arounds, please ignore that advice and roll with the new settings!

    Refactoring/Improvements

    • Reworked RaidId Generation with a SessionManager for active profiles and active raids, mostly to support Fika, however, this has fixed other wierd bugs.
    • Refactored client project structure and functionality @ ekky
    • Formatting, logging and testing session manager changes @ ekky
    • Unused module clean-up, heatmap implementation & documentation @ ekky
    • Converted direct DLL references to SAIN to use C# Reflection. @ ekky
    • Converted to use coroutines instead of using a hacky delay for 5fps capture rate. @ ekky

    Fixes

    • Fixed issues with PMC SAIN Braintype not showing up consistently. @ Chazut
    • Fixed custom bosses not showing up correctly @ Chazut
    • Fixed missing main player issue with re-checks throughout the raid, and post-raid data check. @ ekky
    • Fix delay on map playback, better SAIN bot info retrieval, remove getBotComponent retry loop @ Chazut
    • Fix bot difficulty being captured and displayed @ Chazut
    • Fixed bosses not showing up correctly in timeline and playback @ Chazut


    o7

    Heart 4

  • Version 0.0.6 - v3.8.x

    • ekky
    • 1.7k Downloads

    🪄 Last update today, just fixes for unexpected bugs.

    Please refer to installation/upgrade notes in the link.

    If you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    - [Ekky] Fixed incorrect default F12 Menu setting turning off positional data tracking, if positional data is not working for you, please ensure "5. Disable Recording" is unchecked in the F12 menu (requires client restart).

    - [Ekky] Fixed issue with previous raids not being cleared of the processed cue, and would constantly re-process data whilst in main menu

    - [Ekky] Fixed issue with goons, and some bosses not being identified after the last fix.

    - [Ekky] Fixed issue with statistical data not adding up kills correctly.

    - [Ekky] Fixed issue with profile screen not fitting multiple profiles if more than 6 profiles.

    - [Ekky] Modified retry to obtain BotComponent out of SAIN, hopefully this fixes the UNKNOWN bug.

    Known Issue
    -     SAIN Brain Type for PMC's is not working 100% of the time for this patch, please 🐻 with me whilst we work on a fix.


    o7

    Heart 2 Thumbs Up 1

  • Version 0.0.5 - v3.8.x

    • ekky
    • 182 Downloads

    🪄 Wow, another update, no, just messed up the last upload.

    Please refer to installation/upgrade notes in the link.

    If you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    - Fixed Bosses, and other types being incorrectly categorised in the replay.

    - Fixed groupings in the raid review screen, now actually grouping by squads.


    ⚠️ Known bug(s) with v0.0.5 version ⚠️
    - Positional data not recording, if you've noticed this, upgrade to v0.0.6, but read the instructions.


    o7

    Happy 1 Thumbs Up 1 Heart 1

  • Version 0.0.4 - v3.8.x

    • ekky
    • 231 Downloads

    Please refer to installation/upgrade notes in the link.

    If you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    - Extended bot information, distinct colors, and further support with SAIN (thanks to Chazu for the help)!

    - Further support for remote host enjoyers via F12 settings, and a config.json for the server mod.
    - Automatic data deletion, data integrity checks, and improvements to data collection / compilation.

    - Most other changes are performance or bug fix based for both the web client and game client.


    Known bug(s) with this version
    - Bosses and other scav types not recognized properly, and groupings not working as expected.


    o7

    Heart 2

  • Version 0.0.3 - v3.8.x

    • ekky
    • 1.5k Downloads

    Please refer to installation/upgrade notes in the link.

    If you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    I've tried to address some issues. Fixed the looting timeline so it hopefully displays actions more accurately now. Tackled some map data loading glitches, and to prevent the playback scrubber from going missing, I've added some overflow constraints to the map view.

  • Version 0.0.2 - v3.8.x

    • ekky
    • 247 Downloads

    Please refer to installation/upgrade notes in the link.

    If you have a previous version installed, please follow the upgrade notes!

    Summary of patch notes

    A protection mechanism was added to handle old profiles from the SPT Server, preventing UI rendering issues in the vite app. The 'positionsTracked' attribute is now part of the raidData for the '/api/profile/raids/' route, which controls the Map playback button in the UI. Additionally, the 'Loot Found' summary in the Raid Overview screen has been replaced with a 'Positional Data' available flag, and object mappings were modified to dynamically read map layers, resolving issues with Shoreline and Woods maps rendering empty screens.


    Further enhancements include updating the ingestion pipeline to correctly handle Profile_Id, reducing profileId mix-ups. A SQL Migration was added to drop the now-unnecessary positions table, as positions are stored in flat files. Try/catch blocks were incorporated into DataSaver.ts utility functions, and minor changes were made to the 'server' build script. The update also includes a new toggle for the Menu Item, defaulting to disabled and accessible via the F5 menu, and changes the "RAID_REVIEW" reference to "RAID REVIEW" in the Menu insertion. Lastly, Player Tracking is now enabled by default for better support, and the About Page has been updated.

  • Version 0.0.1 - v3.8.x

    • ekky
    • 413 Downloads

    Refer to installation/upgrade notes in the link.

    Thumbs Up 1

  • 🎉 Version 0.2.0 Released, with support for 3.9.X

    DO NOT EXPECT UPDATES/BUG FIXES
    I am taking a hiatus from life for the next few months by packing up and travelling.

    As such I'm not planning to have access to a gaming machine until at least mid-october, so gaming/modding will take backseat for a while.

    All my code for this is open source, so you're welcome to fix bugs / redistribute the mod as you wish if you cannot wait until then, I don't mind, and if anything, I would encourage it.

    Thanks for the support, and enjoy the mod 🙂✌🏾


    Link for v3.9.X

    - https://hub.sp-tarkov.com/files/download/10667/


    Reporting Issues

    - I have implemented custom logs specific for Raid Review, these can be found in the mod folder (e.g. `<mod-folder>/data/logs/*`, if you log an issue in the Github, please provide your logs to help me figure out what is going on and recreate the problem.

    • [RAID-REVIEW] It appears that profile id '66aa82b9000180669e7132ab' is using an old data structure not compatible with RAID-REVIEW.



      Seeing this when starting a new profile

    • @daz96050 - do you have comprossed profiles on?

    • When you update this for spt 3.10

      ? 2 Thinking 1

  • love this mod, you would learn so much if this would be in pvp, also it would be huge for reporting cheaters who speedhack

    Thumbs Up 1

  • Great mod but i was forced to remove this from my game. i get A LOT of freezes because of this mod... From 4 to 40 second freeze while i was using my INV in raid... Mod is really good but not with those Freezes :(

  • Excellent work. Today I'm getting "Refused to connect" error in browser when trying to open raids. It worked fine last night.

  • it looks like the garbage collector incorrectly flags some of the finished raids as "unfinished" and deletes them. it deleted 6 out of 9 recorded raids with "Survived" outcome. I realize it's an experimental feature, but mod should definitely take into consideration raid status before deleting it.


    I guess that's the problematic part:


    JavaScript: TheGarbageCollector.js
    const raidsWithMissingEndMarker = raids.filter((r) => {
  const noMatchingEndMarker = raids.filter((rr) => rr.raidId === r.raidId)?.length !== 2;
  if (noMatchingEndMarker)
    return true;
  return false;
});

    it looks like GC's only condition for deleting raids is the missing raid ID, but it should also take into consideration exitStatus value, because obviously if I hit alt+f4, raid .json should be damaged/incomplete, right? however you never know if legitimate raids have all the necessary data filled in and since logs doesn't provide some basic information regarding raid registration/dump, you can't be sure. there should be some fallback check for it to prevent deletion of valid raids

  • a very helpful mod for configing donuts

  • Love it! Keep up the amazing work!

  • don't know why not working on dedicated server. Maybe I need to config ip somewhere?

    • i guess it's a client only mod?

  • Incredible mod and work. Thx very much :)

  • I appreciate your work. Thank you for this increible mod!

  • Anyone had Lab's map review like this? black screen, any help?

    https://imgur.com/fkE2cnQ

  • Hello there again! I has some bad news, but some good news as well. The bad news is that i upgraded to 0.2.0 and when i did, everytime the bullet that kills me hits me, the screen will freeze up from 1 to 8 seconds. I have had bad stutters in fights too for some reason but i know that this is all coming from the mod because ive done several raid with deaths with and without the mod, and the freezes happened each time the mod was installed. Now the good news is that the freezing did not happen when i had 0.1.1_NEXT installed, everything ran fine and i intend to run that for now but i wanted to share this along even though you're on a hiatus, hope this helps whoever is adding stuff to the mod for the time being.

  • So ground zero used to work for me. Now I've updated to 3.9.4 any time I do a ground zero raid the review just says sandbox_high. It shows me the list of AI but the raid map replay does not work and I am now completely stumped why.

    • To fix this issue, go to {SPT Directory}\user\mods\raid_review__0.2.0\src\Server\public\assets


      Open the file index-7d0f19c6.js


      Search for the text "sandbox", there should be 2 instances of the word "sandbox" which look like:

      Sandbox:"ground-zero"


      Change the word "Sandbox" to "Sandbox_high", resulting in:


      Sandbox_high:"ground-zero"


      Save the file and refresh the browser, timeline will work again.

      Heart 1

    • Oh man thank you I don't know how I didn't even think to try that I was looking at things with the mod directly.

    • At low levels I think you do need to have references to Sandbox, Sandbox_high maybe only at later levels? On a new game I changed mine to Sandbox_high and the map viewer stopped working - but if you add an additional new entry for Sandbox_high:"ground-zero" in both places then I think it works fine and fixes both cases.

  • Enjoy your Coffee man xxx

    • Thank you legend, will buy myself a coffee on the way to work tomorrow ☕

      Heart 1

  • i have some error



    Code
    Error: Failed to execute 'insertBefore' on 'Node': The node before which the new node is to be inserted is not a child of this node.    at s1 (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:25597)    at Ro (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:30826)    at yL (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:28699)    at oo (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27541)    at yL (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27851)    at oo (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27541)    at yL (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27851)    at oo (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27541)    at yL (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27851)    at oo (http://127.0.0.1:7829/assets/index-7d0f19c6.js:40:27541)

    • i'm sorry, this error caused by the translation machine of the Chrome, not MOD

    • No worries man - so is it still a problem for you?

    • everything is right when turning off the translator

  • Man that is bloody awesome. Thank you so much. What a great idea :)

    Heart 1

  • Yay no more infinite breathing! <3

  • what does these mean?
    https://imgur.com/zL6Azq3

    • K = Kills
      L = Lootings, Green = You looted more than you dropped, Red = You dropped more than you looted
      A = Accuracy

  • Awesome Mod! There was something similar back in the old DayZ Mod time... its funny to see how close players were sometimes.

    • Oh man I had no idea DayZ had that back in the day, would've been so good to see.

    • yeah there were some admin tools that showed everything on the map. it was not good for dayz. Many admins abused that... i used to watch players on my server when i was bored. :D It was so funny!

  • Hi, labs don't have your own custom map design and has only satellite map available, making the replay just show the players (colored dots) without any map in the background until you select the available satellite map. Basically the default map isnt available so the website aint choosing any and let it blank.

    • Thanks for reporting that - I'll see what the issue is there.

    • Yw, keep up with this mod. Insane idea you got there 💪

  • are you able to make it differentiate between scavs and raiders?

    • It should already show a difference, but if it doesn't, I'll open a issue ticket.

    • ok thankyou for replying

  • Code
    Error: ENOENT: no such file or directory, lstat 'C:\Games\SPT_3.9.2\user\mods\raid_review__0.1.1_NEXT\data\raid_review_mod.db-journal'

    I'm getting this error in the console for some reason. The mod still works with no apparent issues though.

  • The mod works great and this is honestly super helpful. Idk how y'all do it when comes to making mods but this is just great, thanks for your hard work man it really paid off ^^

    • A silly idea with enough time/effort sometimes works out, idk.

      I blame GeneralSam for planting the seed.

      Happy 1

  • I am playing on a server with multiple players and the mod works for all of them, but doesn't work for me.
    It doesn't matter if I host the raid or one of the guys - it works for them, I am shown on the replay, but in my profile there's zero raids and I have no messeges. What can i try?

    • You may need to update the settings in-game in the F12 menu to point at your server.

      Please restart the game       before playing a raid if you change these settings.

    • Wait, how are you playing co-op??? I need to know this info asap lmao

    • Look up SPT FIKA. Some setup required and possible mod incompatibilities but generally seems to work fine.

  • Can I use the the same client .dll file when connecting to two different servers (one on linux and one on windows)?

    • Yeah, both Windows and Linux .DLL are the same. It's just the Server Mods have different drivers between the operating system. :)

  • 🎉 Version 0.1.1 Released, with support for both 3.8.X and 3.9.X

    Link for v3.8.X

    - https://hub.sp-tarkov.com/files/download/10663/


    Link for v3.9.X

    - https://hub.sp-tarkov.com/files/download/10667/


    Reporting Issues

    - I have implemented custom logs specific for Raid Review, these can be found in the mod folder (e.g. `<mod-folder>/data/logs/*`, if you log an issue in the Github, please provide your logs to help me figure out what is going on and recreate the problem.


    Known Issues

    - Does not play nice with RealismMod right now, and has a memory leak.

    - Not compatible with Mozilla Firefox, issues rendering the playback system.

  • Thanks for another update! Feels much more responsive now.
    Ps. I read all patch notes ;)

    Happy 1

  • Im getting this error on the newest version when I try to view the map. It looks like my older raids before I updated work but my recent raids show this when trying to view the map


    Error

    Crying 1

    • I think I fixed this in 0.1.1, let me know if you see it again.

      Thumbs Up 1

  • @ekky, do you think it would be possible to be able to indicate what a bot is actively trying to do? For example, if it is doing a QuestingBot action, or a LootingBot action, or something like that?

    I suspect checking and logging that might be not as performant though, but just thought it would be cool, if you wanted to check why a bot stayed in 1 area for like 5 minutes.

    Thumbs Up 1

  • W update!

    Heart 1