Operation Capture And Playback (BETA)

OCAP Development and Support on Discord

What is it?

OCAP is a game-changing Arma 3 v2.04+ addon that allows serverside recording of missions in addition to easy playback on an interactive (web-based) map.

Quantify personal and group performance in difficult missions
Observe the role your teammates played in the overall battle
Learn what tactics and strategies work and don't work against AI or players

Feature Overview

Interactive web-based playback. All you need is a browser.
Captures positions of all units and vehicles throughout an operation.
Captures events such as shots fired, kills, and hits.
Captures all Arma 3 markers, both scripted and user placed.
Event log displays events as they happened in realtime.
Clicking on a unit lets you follow them.
Server based capture - no mods required for clients.
See Detailed Features for more

Running OCAP

Capture automatically begins when the server reaches the configured minimum player count (see userconfig settings). The addon can also be set to automatically save the recorded when the mission is ended.

Configuration

Configure /ocap-web/options.json with your public-facing IP, port, and a custom secret.
Configure /addons/@ocap/OcapReplaySaver2.cfg.json with matching IP/port destination and secret.

newServerGameType is used to "tag" uploaded recordings for better organization. this will be the default tag if one isn't provided to the ocap_fnc_exportData command in-game traceLog set to 1 will cause the extension to log all calls for debugging purposes
Configure userconfig/config.hpp with desired values

ocap_minPlayerCount determines how many players must be connected before recording begins, useful for avoiding extra recordings of test tessions

ocap_frameCaptureDelay sets how frequently the capture of all units and vehicles is run (in seconds)

ocap_excludeClassFromRecord blacklists object classnames that shouldn't be tracked by OCAP

ocap_excludeMarkerFromRecord blacklists markers containing any of these strings in their name so they won't be captured -- used primarily for marker framework systems you don't want to include in recordings

ocap_saveMissionEnded determines whether or not the recording should be saved automatically when the MPEnded event handler fires

ocap_minMissionTime determines the minimum length of a mission -- if it's shorter, the recording will not be saved

Installation

Copy the /ocap-web folder somewhere on your computer. The /ocap-web/static folder's contents will be public.
Add a firewall rule and port-forwarding if necessary for /ocap-web/ocap-webserver.exe. The default port is 5000 and can be customized in /ocap-web/options.json.
Copy the @ocap subfolder, found in /addons, to the mod directory your Arma 3 server uses.
Add the absolute path as a serverMod parameter in your server start script.

for example: ... -port 2302 "-serverMod=C:\Servers\Arma 3\Mods\@ocap" -cfg=myServer.cfg...
Copy the /userconfig folder to your Arma 3 directory. If a userconfig folder already exists, this will simply merge OCAP's configuration data. If not, this will create it.

Terrains

A long list of Arma 3 terrains, both vanilla and modded, are provided in a link at the top of this ReadMe. To use one:

Download the .7zip file.
Extract the contents to your ocap-web/static/images/maps folder.

The 7.zip file contains a folder titled with the world name. This folder contains a set of subfolders with tiled map images & a map.json file inside of it. Past and future recordings uploaded to this server that were played on that terrain will now display properly.

If someone tried to load a recording from a session played on a terrain that wasn't installed yet, the issue may persist even after installation. To fix this, they can clear their browser cache in order to force their system to re-download the terrain tiles from the server.

Usage

To end a mission and export capture data, call the following (server-side):

// simple message
["OPFOR Wins. Their enemies suffered heavy losses!"] call ocap_fnc_exportData;

// includes side who won
[east, "Their enemies suffered heavy losses!"] call ocap_fnc_exportData;

// includes a specific 'tag', which will be filterable in the playback menu.
// i.e. in playback menu, selecting "PvP" from the dropdown would make this and any other mission tagged "PvP" visible in the search
[east, "OPFOR triumped over their enemy!", "PvP"] call ocap_fnc_exportData;

Tip: You can use the above function in a trigger. e.g. Create a trigger that activates once all objectives complete. Then on activation:

if (isServer) then {

	// Saves and uploads the recording to your server
	[east, "OPFOR has achieved all of their objectives!"] call ocap_fnc_exportData;

	// Ends mission for everyone
	"end1" call BIS_fnc_endMissionServer; 
};

WARNING

To ensure your recordings are saved and uploaded:

The mission should be ended using an endMission function and configured to auto-save, or the ocap_fnc_exportData function should be executed prior to it ending.

The ocap-webserver.exe executable should be running and able to accept incoming network connections.

If the web component is not running, the upload will fail and a local copy of the compressed recording will be saved. Logs are available in the Arma 3/ocaplog directory to troubleshoot.

Detailed Features

-- Easy playback selection, low storage requirements --

Each recording is saved in a compressed file, which means hundreds to be saved with minimal space usage (<2MB each).

Recordings can be easily browsed and are filterable and searchable with custom tagging, mission name search, and recording date search windows.

-- Events List --

A filterable list of game events is available during playback and will include the following items:

Player connects/disconnects (can be filtered out)
Kills/Deaths with information
Hits/Injuries (filtered out by default)
An optional scripted game ending description logged at end of recording, such as which faction won and how

-- Markers --

This suite will track all marker types in the vanilla Arma 3 system, even those created via scripts. This includes elliptical and rectangular markers, and the BIS_fnc_moduleCoverMap module (when present) to more clearly define AOs.

New! Drawn Map Lines

Custom drawn map lines are now recorded as well, providing more context to the static icons previously tracked.

-- Projectiles --

Lines are drawn each time a unit has shot, indicating where their bullet landed. If they hit another unit or vehicle, the target's icon will flash during playback.

Shot and thrown non-bullet projectiles are also tracked and will be displayed with the in-game icon where available -- other vehicular ammo such as tank shells and mortar rounds will appear as red triangles. ACE3 advanced throwing support is included.

Magazine icons are available for the following mods:

Vanilla Arma 3

ACE 3

RHS (all factions)

Iront Front (IFA)

-- Mines and Explosives --

ACE3-placed mines and explosives will be tracked from the time they're armed to the time they're detonated, with an X briefly appearing to indicate that they've been triggered. The player who placed it and the type of mine will also be labeled.

Current Developers

IndigoFox - SQF, Powershell, & JS/Leaflet, enhanced in-game recording & Leaflet playback functionality
Zealot111 - SQF marker framework, C++ extension development and expansion
Fank - SQF, JS, Go, Linux build compatibility & DB interface
Tekig - SQF foundation & optimization, Go, JS, web optimization and UI

Credits

MisterGoodson and the 3 Commando Brigade for original development and testing.
Leaflet - an awesome JS interactive map library.
Bohemia Interactive for their continued work supporting mods like this with engine and API improvements.

OCAP2 / legacy