Arma 3
Not enough ratings
TCS BattleTracker
   
Award
Favorite
Favorited
Unfavorite
Data Type: Mod, Server
File Size
Posted
Updated
0.690 MB
Jul 8, 2019 @ 1:58pm
Jul 19, 2019 @ 12:25pm
2 Change Notes ( view )

Subscribe to download
TCS BattleTracker

Description
BattleTracker
Initially released only for the TCS Arma group but now on the workshop aswell, BattleTracker is an arma 3 mod that allows capture and playback of missions similar to OCAP.


You are NOT allowed to reupload, republish or include this mod in any modpack in any shape or form.


Requirements
* CBA.
* Microsoft Visual C++ 14.0 or greater (link[www.microsoft.com]).
* A 64-bit server, 32-bit DLL's are not included but you are free to compile them yourself.

For more information about the Visual C++ versions, see this: https://github.com/WPN-XM/vcredist

For server owners
To have the mod running on your server all you need to to is include the mod folder in your mod path.
And then, to start the recording call the function TBT_fnc_beginCapture on the server, example:
[] call TBT_fnc_beginCapture;

To stop a recording and export it, call the TBT_fnc_endCapture function on the server, example:
[] call TBT_fnc_endCapture;

Make sure to call the endCapture function, otherwise the recording will not be stopped and exported.
You can stop it in the next mission but you will need a hex editor to fix the end time of the recording.

As to where the recordings will be placed, the first thing you need to do is make sure the extension generated a configuration file.
This configuration file is generated where your arma 3 executable is by the extension once it is loaded by the game, and in it you can find the setting to change the destination folder.
After you changed the setting, you can reload the configuration in-game by executing this code on the server:
"TCS-Battletracker" callExtension "reloadConfiguration";

To play the recording there is an web renderer already made[npmjs.com] that you can integrate into your website, all that is needed is to create the page that handles all the interactions with the renderer. There is more information about that in the NPM page.
If you don't want to integrate it into your website, you can use this one[gkovalechyn.net] to play back your recordings and see how it works.

Note: I only made icons for 3 object types, so planes, static weapons, etc. do not have icons and use the default leaflet marker icons, and there is still some work to be done on the rendering side to make it more intuitive and prettier.
Also, if you are to integrate it into your website you have to provide your own tiles and icons.

For developers
You can create your own player or use the one already made, the format of the exported file is specified in the CPP extension gitlab repository here[gitlab.com] in the Recording.ksy file.

If you want to integrate the renderer into your website you can add it as a dependency using NPM, note that it depends on leaflet and leaflet-rotatedMarker.

As for the icons, they should be square images and they will be rotated around their center, so make sure the images are centered properly.

To generate the tiles for map you can use this tool: https://gitlab.com/gkovalechyn/tcs-battletracker-tiler
And to generate the images to be used by that tool, here are the steps you need to follow:
  1. Select the map you want to create the tiles for in the editor menu.
  2. With the map selected, press CTRL+O to open the 2D editor.
  3. Press SHIFT and minus on the numpad and type "EXPORTNOGRID", you should see "EXPORTNOGRID Cheat activated appear".
  4. Close arma and open your C: drive and copy the file generated somewhere, the file should have an ".emf" extension.
  5. Convert that file to a png, you can use the Arma 3 tools emf2png.exe to do that conversion.
  6. Then, all you need to do is use the tiler on that image.
For a prettier tutorial, you can follow this link: https://github.com/alexcroox/R3-Web/wiki/Adding-new-terrains
< >
3 Comments
basucox Jun 21 @ 2:56pm 
I was finally able to see a replay on your web page, its very useful but only has 2 maps. It would be great if you can add some more!
gkovalechyn  [author] Jun 9 @ 2:31pm 
@basucox I'll try to make the installation steps easier to follow, I just don't think that a video would be a good format for it. In my opinion text+images are easier write and search through if you are looking for something specific when compared to a video.

As for the web player, yeah it is more complex mostly because it is not something you can just include with a <script> tag right now. It was made mainly to just replay the files and left the controls and UI to be handled by the users so they can have their own pages in their own style.

I'll try to improve the documentation and provide a version that you can can include with just a script tag so that it can be included in websites that don't have an entire build chain setup. One thing to note is that the web player only handles the playing of the files, it doesn't provide an entire web page that does it, all the controls and layout must be created that then interact with the web player.
basucox Jun 8 @ 11:16am 
Congrats for your mod, seems very useful. But it is a little unclear to me the install process. can you please explain in a video step by step how to do it? specially for the web player
Great work!