Bothering mod authors will lead to warnings and repeat offenses will lead to eventual bans.
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.
From there you can flick through your raids, and scrub through the playback system if positional data was captured.
Compatibility
- Only a Chromium based browser is supported right now, cross-browser compatibility is on the roadmap.
- v3.8.X versions are compatible.
- FIKA support is somewhat unknown, there are reports of it working for the host.
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.
Known Issues
- 🚩Not compatible with Mozilla Firefox, issues rendering the playback system.
This is just for quick reference, please log an issue via Github if you need me to address a bug!
Roadmap
[Feature]
Share a raid, nuff' said.[Feature]
Favourite/highlights feature, similar to "twitch clips" for referencing back to specifc moments.[Feature]
Ballistics/rounds fired stats, visualize this in a focused "firefight" replay.[Feature]
Profile visulisation over a period of time, see profile stat increases with interactive graphs.[UI]
Differentiate between Bosses/Raiders/Rogues/Cultists from PMCs and Scavs.[UI]
Differentiate between PMC/Scav Runs.[UI]
Improve logos and icons for the playback system.[Code]
Code clean-up, tons of unused stuff and double ups of functions.
If you have an idea, or wish to contribute feel free to raise an issue or make a pull request!
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.
-
Version 0.1.1_NEXT - v3.9.x
- ekky
- 3.2k 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. -
Version 0.1.1 - v3.8.x
- ekky
- 340 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.0Otherwise, 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. -
Version 0.1.0 - v3.8.x
- ekky
- 608 Downloads
🔥Heatmap feature, Fika support, massive refactors & stability fixes
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 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
-
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
-
Version 0.0.5 - v3.8.x
- ekky
- 163 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
-
Version 0.0.4 - v3.8.x
- ekky
- 212 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 -
Version 0.0.3 - v3.8.x
- ekky
- 1.4k 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
- 222 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
- 389 Downloads
Refer to installation/upgrade notes in the link.
ekky Author
🎉 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
- Not compatible with Mozilla Firefox, issues rendering the playback system.
Hibachi
I'm getting this error in the console for some reason. The mod still works with no apparent issues though.
TheDragonLad
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![grin ^^](https://hub.sp-tarkov.com/images/smilies/emojione/1f604.png)
ekky Author
A silly idea with enough time/effort sometimes works out, idk.
I blame GeneralSam for planting the seed.
szade
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?
ekky Author
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.
MadFrogz
Can I use the the same client .dll file when connecting to two different servers (one on linux and one on windows)?
ekky Author
Yeah, both Windows and Linux .DLL are the same. It's just the Server Mods have different drivers between the operating system.![smile :)](https://hub.sp-tarkov.com/images/smilies/emojione/263a.png)
Klinical
Thanks for another update! Feels much more responsive now.![wink ;)](https://hub.sp-tarkov.com/images/smilies/emojione/1f609.png)
Ps. I read all patch notes
Hypno88
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
ekky Author
I think I fixed this in 0.1.1, let me know if you see it again.
Rezoken
@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.
Klinical
W update!
Zerglrisk
I Love it ! Now I can now monitor my friend's play.
Thank you!
ekky Author
🎉 Version 0.1.0 has been released!
Link
- https://hub.sp-tarkov.com/files/download/10462/
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
- Not compatible with Mozilla Firefox, issues rendering the playback system.
- Playback system can slow to a crawl if you use the "play" button, however, normal scrubbing is O.K.
DuckingFlame
Looks awesome good job!
A suggestion: If possible could you change the dot into an arrow or something that shows the direction someone is looking at
ekky Author
I've been working on that, I keep track of the direction as player are tracked, however, I'm having trouble getting it to actually work at the moment.
JamesMowery
Just an FYI that I was getting errors about an .exe when I used the Linux archive in your GitHub and tried starting the server. I'm running the game via Lutris on Linux.
I switched over to the Windows archive, and it cleared up the .exe errors.
Apologies for forgetting to copy the errors before fixing, but it was a substantial amount of errors and it prevented the server from starting. Tried multiple times from scratch, tried resetting as well, before realizing it was the archive that was not working correctly.
ekky Author
If you're playing the game using Lutris, the server's runtime (NodeJS) will look for Windows dependencies instead of the Linux ones included in the Linux package hence the errors.
Thanks for the report, I'll make sure to note this in the install notes for you Linux enjoyers.
gFresh
Can any folder be removed from the github download (windows) as it takes an age to copy over 8500 files to EFT folder.
ekky Author
There is, however, the installation is very finicky, and was causing problems I couldn't control so I've included the files required so it's just a matter of copy and pasting.
It should only take ~30 seconds to a minute for the unzip to finish.
SaintMellec
A couple observations (that may already be known issues, but wanted to share just in case it's helpful)
At the end of the raid, most of the enemies listed are "unknown", but many of them are also identified using cyrillic characters (while they have Latin alphabet names on the in-game kill screen).
I'd also like to be able to highlight myself and friendly PMCs, but I know that may be a challenge since we're not in a squad.
ekky Author
The cyrillic characters is something I'm working on as its just using whatever EFT sends me, which is in cyrillic (not the translated version you see in the vanilla post-raid screen).
Highlighting PMC's, do you mean PMC's that are generated by the 'friendly pmc' mod, or real players in Fika?
SaintMellec
I mean the former in this case, though I haven't tried RR with my real coop friends yet
Wazumba
Hi, the mod does have a discord ? The link you have shared in the pinned message doesn't work for people that aint already in your server..
ekky Author
Thanks fixed it.
em0tionalbro
It's a wonderful mod, but I can't fully enjoy it. The website is working, my profile is displayed on it, but not a single raid is shown (after 10+ raids). In the console the following error occurs. I think this error causes my problem. Can you tell me how I can fix this?
Screenshot
ekky Author
Hi mate,
Sorry it's not working for you, I'll try and help you, I just need some details.
em0tionalbro
SPT - 3.8.3;
RAID-REVIEW - 0.0.6;
SAIN - i didn't install this mod;
No, i didn't have an older version.
I have 3 other mods: AmandsGraphics(1.6.2), StashSearch (1.1.1), DynamicMaps (0.3.1.3).
Wazumba
just posting a message to get notified if the mod author manage to find a fix for this issue (got the bug aswell)
Chazu
Search for file "me.sol.sain.cfg" on "{SPT_Intall}\BepInEx\config
Make a backup of this file (if exist ?) and delete it.
Try again and check if it works, if not, put the file back.
em0tionalbro
Chazu, i don't have this file(
Rsslone
When there is a larger list of profiles, elements on the top of the list are out of bounds.
ekky Author
You are a gentleman and a scholar, issue opened for the next patch.
https://github.com/ekky-llc/spt-raid-review/issues/34
Rsslone
Now I'm running into
Is this related to our profile being created on 3.8.0? Is there a way to fix this on my end or is this just an incompat for our profiles? I'm not getting any raids listed after doing a raid, so I assume the error above is the reason. FYI running Fika with remote server.
ekky Author
Can you send me the profile with the problem in the screenshot, I'll see if I can make it work. Dump it here if you can: https://discord.com/channels/8…99922/1253184533965181010
As for the remote server and not gettung data, are inbound ports open for TCP range 7828-7829?
Rsslone
Well I figured out some stuff. The old data structure profile IDs were basically blank, so not related. I did some more testing and for some reason now I'm stuck on my client not being able to use my external IP or my redirect URL to record, however they work for the webclient.
xxxxxx.damnserver.com - A redirect URL does not work.
174.xxx.x.xx - my actual IP does not work.
192.168.11.110 - my internal IP does work.
ekky Author
I don't know your environment; however, this is the checklist I've gone through with others in your situation:
Hypno88
Getting this error on the server on the newest version
Error
ekky Author
yeah, it's fine, just the package.json file complaining. Everything should still work as normal!
Hypno88
I loaded up a game and the Raid review tab was not in the f12 menu
ekky Author
Thanks, just pulled the version, reuploading shortly.
ekky Author
Thanks fixed it, and uploaded.
Krilzlocc
Hey just want to thank you for taking your time making this great mod! I have one issue though, after raid ends I get the message saying the raid data was recorded but when I press the hotkey the browser doesn't open. When I go to the website and select my profile, no data shows up, is there a fix? I used the most recent version and I'm using Google Chrome.
ekky Author
No worries, sorry it's not working for you, can you run me through your setup?
Krilzlocc
I'm using spt 3.8.0, windows 10 and no error logs pops up in the server
ekky Author
Can you open the directory here:
- <spt-install>/user/mods/raid_review_0.0.x/data
What do you see in here?
Krilzlocc
raid_review_mod data base file
ekky Author
What about a `positions` folder? Do you also run this locally, or are you connecting to another server?
Come chat here if you have sometime: https://discord.com/channels/8…99922/1253184533965181010
Raven15
Fantastic mod! One issue I'm having - some of my replays show my player whilst others seem to have my player invisible. It still shows timestamps of when certain events occurred, and if I select "follow" the replay is seemingly following ... something! But that something is invisible :D.
I am running fika along with a number of mods. Let me know if you need any additional details.
Keep up the great work, this is amazing!
ekky Author
Thank you!
I'm afraid to ask because I've been trying to fix this one for a week or so, what version have you got installed?
Raven15
I have 0.0.3 currently installed. Though I'm seeing you've been busy getting new versions updated. Will update and report back :).
Raven15
Good news: that (mostly) fixed the invisibility issue. I had two games where there was no problem whatsoever. A third game everyone was invisible, until about 1min into the raid, then everyone's dots and trail appeared.
New issue though: at a certain point in the match, the replay itself begins to increasingly stutter and slow down, to the point where I had to enable x16 just to finish watching the raid.
Let me know if you need any details.
(quick edit) - looking at a video, the slowdown seemed to happen every 1000 frames (when enabling the debugging options in settings). At least, that's what it seemed like to me, hope that helps somewhat.
Hypno88
Not sure if its already a feature and I just cant find it but when watching the Map Playback is there anyway to highlight only the PMCs or is there a way to do that now?
claptraw
Great mod, unfortunately the location data doesn't seem to work properly for me. My PMC is being displayed at a completely different spot than where I actually was.
ekky Author
Yeah im having problems with playerId mismatches, working on a fix at the moment, but have mot quite worked out whats causing it.
claptraw
Happy to hear! Keep up the great work!
Hypno88
Does anyone else's game crash at the end of raids? Right before the game starts to load the end of raid report my game crashes. Im not 100% sure its this mod but I ran about 4 or 5 raids deleting recently add mods and right after I removed this one it does not crash anymore
ekky Author
Depending on how long your raid goes for, it's probably the server processing all the positional data.
If you let it sit for a moment (30sec) it usually doesn't crash, however, I've moved the processing event of the positional data away from the post raid screen and instead wait for you to be back in the main menu.
Did you generally see the crashes happen on long raids, and short raids like on Factory being O.K?
I'm just testing v0.0.4 now, hopefully have something cooking by Monday.
Hypno88
For me it was happening on long and short raids. I'm not too sure it was this mod because I got another crash with this mod not installed. But since then I've ran about 10-15 raids of different lengths running my server and launcher as Admin and I haven't had a single crash yet. Not sure if the game is meant to be ran as Admin but that has been working for me
Wanuboi
wtf ! big w man, thats insane, not useful for me, but i can definitly see people using this for multiple reasons, great work, another big support for the awesome SPT community
Rocketbobcat
Love the idea of this mod and wanted to check the map review but it keeps giving me the following error:
TypeError: Cannot read properties of undefined (reading 'name')
at http://127.0.0.1:7829/assets/index-7f92f0ab.js:301:205332
at v5 (http://127.0.0.1:7829/assets/index-7f92f0ab.js:40:24283)
at Oc (http://127.0.0.1:7829/assets/index-7f92f0ab.js:40:42408)
at http://127.0.0.1:7829/assets/index-7f92f0ab.js:40:40725
at ee (http://127.0.0.1:7829/assets/index-7f92f0ab.js:25:1628)
at MessagePort.Re (http://127.0.0.1:7829/assets/index-7f92f0ab.js:25:2009)
What do I do?
ekky Author
What map are you playing?
Rocketbobcat
I did 1x run on Factory as PMC then tried to pull it up once back in the main menu and got the above error.
ekky Author
Ah okay, does this happen when you open a raid? or the playback?
Rocketbobcat
Playback. It shows the stats fine (who was in the raid, who looted / killed who, etc.) but gives this error when I press the view location replay.
Rocketbobcat
I tried it again just now on Ground Zero and it worked fine, was able to see the location review. Will check again on Factory later.
BlackBeardYT
Hey, Thanks for an awesome mod,
it would be cool if you can add a share option of the raid web review. for easy share to friends
ekky Author
How do you see this working? Just so I can think it out as a feature moving forward...
OR
The next update I'm almost done with will allow people to visit the web client if they are in the same network, so people who use VPN's or host their SPT/Fika Server on a server somewhere else can just share the link directly.
BlackBeardYT
a link would be good
theycallmesalute
Hey, awesome mod...I couldn't even imagine that such thing could be possible in SPT!![sad :(](https://hub.sp-tarkov.com/images/smilies/emojione/2639.png)
But I have troubles making it work on my setup. The mod doesn't record any raids whatsoever. It doesn't send any notification it should ("raid recorded" etc.). I assume that the mod doesn't know what to "record" since my server is working on another machine and both computers are connected via Hamachi, although local web interface of the mod is working properly and server doesn't show any errors with the mod. Mod is installed correctly on both machines. I have no idea how to make it work
Thanks in advance
ekky Author
The current version does not support SPT Servers hosted remotely. It currently only works from the host machine.
The next update I'm working on will allow for this and bring this closer to a state where it should work for Fika enjoyers.
I've completely hosed the playback system, going to catch some 💤 and try and fix it tomorrow.
theycallmesalute
Thank you once again!![grin ^^](https://hub.sp-tarkov.com/images/smilies/emojione/1f604.png)
Now I can stop banging my head against the wall thinking what did I do wrong
STK
Looks amazing I cant wait for full FIKA support.
I run FIKA on a dedicated server and play from a different PC.
Would it be possible for the dedicated server to record and store the replay files and the clients request files from the server?.
thanks
STK
OK so installed on dedicated server and can log into web seletc profile but for some reason after raids I see no saved recordings![sad :(](https://hub.sp-tarkov.com/images/smilies/emojione/2639.png)
![smile :)](https://hub.sp-tarkov.com/images/smilies/emojione/263a.png)
I am never informed in game that its recording neither.
can provide logs if needed
thank you
ekky Author
Hi STK, currently the mod doesnt support the Server being hosted on a remote host.
The client mod would've been trying to send all the telemetry to the pc you were playing on, not the remote host where the SPT Server is.
I will be including options in the F12 menu for remote host enjoyers in the next update.
DUB
Map Layers are not working for me. They only make the current layer darker and thats it.
ekky Author
Is this happening for all maps? Have you got a screenshot I can look at?
DUB
Only played Interchange and Ground Zero so far but it doesnt work on neither of them.
Clip
ekky Author
Okay - I found the bug, it's something I introduced with v0.0.3 trying to fix anther bug, I'll open an issue to remind me later today (me rn).