Author: skruis
Author Website:

Requirements: No addons required

Version: 20170225b
Signed: Yes, serverkey included

Short description: Athena is a 2nd screen mod providing those players w/ multiple monitors and/or gaming pc's as well as notebooks w/ an interface that displays friendly unit and group locations, compositions (sl, ar, at, medic, etc.) and marker data.

Date: 2017-02-27 11:14

Comments: (4)


Athena mod


What is Athena?
At it's most basic, Athena is an application that you can run on your 2nd screen that provides a very highly accurate representation of the in-game map and displays icons for friendly units in real time: a 'blufor' tracker that runs outside of arma on a 2nd screen whether that screen is literally a 2nd monitor, a laptop, a Windows tablet or a Microsoft Surface but that's an oversimplification of what Athena offers.

Athena supports multiple instances. Building a cockpit and want several map screens? Athena will let you do that without any additional performance impact on ARMA.
Athena supports the automatic import of any ARMA map and that's both vanilla and custom. No ExportNoGrid here.
Athena supports the generation of shaded 'height map' views for any ARMA map and again, that's both vanilla and custom.
Athena supports the private sharing of 'ink' or 'map drawing' with other members of your communities, again, in real time and with a great degree of control that exists outside of ARMA.
Athena displays and updates an ORBAT in real time: one of your units picks up an MG, it updates their representation to indicate that they're an AR. They pickup an AT weapon, their label is updated to indicate that they're now "AT". Know which of your team members fills the important roles at all times.
Athena provides a convenient list of locations for the current map: "Requesting evac at Mike-26!" Don't know where it is? Look in the locations tab, click "Mike-26" and click "Locate" and there it is.
Athena provides a way for you set custom locations, known as anchors, on the map that are important to you. Someone calls requesting a pickup and they provide you with their grid or coordinates, type them into Athena and have it create an 'anchor' for you. This is especially handy for pilots.
Athena lets you 'track' the positions of a unit, a group and an anchor at the same time by way of tracking lines that are drawn from your unit to the chosen unit, group and anchor. It also tells you the bearing and the distance.
Athena lets your record your own sessions and play them back later.

But Athena also runs 'outside' of ARMA so even when you're not playing ARMA, Athena still has something to offer you and your community by way of the Athena Community Server (ACS).

Collaborating on a mission design? Have both you and your associate connect to the same ACS and mark up the map from across the Internet without ever having to fire up ARMA and join a server.
Have a big op coming up? Connect with your associates and plan out your op prior to game time.
Expanding on your training regimen and want to introduce some tactics discussions? Connect to the ACS and mark up the map and demonstrate the concepts behind the tactics.

Or let's say you're not interested in using Athena in game and you're not interested in using an Athena Community Server, Athena still has something to offer. Let's say you're designing a mission and while you're play testing, you want to keep an eye on what the AI is up to...

Use the @AthenaDesigner mod to output ALL data for EVERY side to the Athena Application. You'll see the units for blufor, opfor, civilian and independent and even their next waypoint.
The @AthenaDesigner mod is not intended to be used along side the @Athena mod so make sure you're using one and not the other.
The @AthenaDesigner mod is not intended for use in multiplayer so it's unsigned.

Athena is not just a 'blufor' tracker, it's a system that will directly contribute to better coordination and communication across your entire unit and can even help with mission design.

How does it work?
Athena packages a series of scripts that will run during any mission that you play in ARMA and those scripts will collect all of the data for your side and feed it to the Athena software. All you need to do is start ARMA with the @Athena mod enabled, start the Athena Desktop application and click "Start". If you have the map, it will load automatically. If you don't, it'll prompt you for permission before it attempts to import it automatically. If your community has an ACS, you can connect to that and possibly download the map from the ACS from within the Athena Desktop application.

But I don't have a second monitor. Can I use this on my laptop, tablet or Microsoft Surface?
Absolutely. This latest version of Athena was specifically designed with that kind of setup in mind: I'm playing ARMA w/ the @Athena mod on my main PC but I've got this laptop off to the side that I'll use the Athena Desktop application on. All you need to know is the IP Address of your gaming pc. You go to File->Settings, enter the IP Address, click "OK" and that's all there is to a perfect world: Of course, the IT guy in me has to mention that you've got software firewalls, spotty home wireless networks, etc. but in theory, yea, it's easy.

Yes. Athena supports every map, both vanilla and custom and you only need to export them once (unless BIS or the map author release an updated version with changes). What we recommend is that you go into the editor, plunk down a unit, start a mission and then click "Start" in Athena. You don't have to do it that way, it's just what we recommend because in order to get a good export, the export process has to 'complete', right? So if you're in a mission, die and then restart, the scripting engine stops and the export will fail but if you're meandering safely around Tanoa during the export, it's going to finish and then you'll have that map forever. So, once you play this new map and "Start" Athena, Athena will prompt you saying "You don't have this map yet. You should import it ... bla bla bla. Do you want to proceed?" If you click yes, Athena will go into "Map Import" mode and that will trigger a series of scripts that will run within ARMA that will collect data regarding the map you're playing on and it'll send it to Athena. Athena will parse that data into a format that it can then render and display for you. Now, keep in mind: we're not exporting images. We're not using the 'ExportNoGrid' command...because we wanted to make the process as simple and painless for the player as possible. Our scripts collect the 'raw' data and we're using that raw data to build a top down visual representation of the world that is of a very high quality while also being extremely performant. You see a building on our map because we know a building is there. We know the terrain so we draw contours around it. We know where the trees are and where there are a bunch of trees, there is technically a forest. We know the ins and outs of the maps because we don't have just mere images and we're planning on doing even more with the information we have.

So I can draw on the map?
Athena exists because I wanted to draw on a highly detailed version of the in-game map on my Surface Pro. That's it. That's what got this started so yes, absolutely, you can draw on our map and furthermore, whatever you draw can be shared, over the Internet, with anyone that you're connected to by way of an Athena Community Server (ACS) and that will work during a mission or offline...the ACS is always available. You can draw with your Surface Pen, your Wacom Stylus, the mouse or your Capacitive Stylus if you own a touch screen laptop or with just your finger!

You mentioned something about recording?
Yes, I did. Athena is, very soon, going to grow to become a fully fledged After Action Reporting, Archival and Playback tool but for now, right now, you can record your own viewpoint of any mission: it will only contain the data for your side but you can record it and play it back at a later date. Once the AAR module is launched, it'll blow your mind. If you think drawing on the same map at the same time over the Internet while not even playing ARMA is something, let's talk about playing that back in a synchronized format while you and your unit review the mission together at the same time in a guided, lets say 'directed' format, while you discuss events and how those events could have unfolded differently and demonstrating that via map drawing. That's coming to Athena. The foundation is already laid...

Is this app meant to replace the in-game map?
Absolutely not. The game and all of the mods and scripts that are made for ARMA revolve around the in-game map and we understand that. This system compliments the in-game map.

But... but... but... This isn't realistic and everything in, around or having to do with ARMA must absolutely without question always be realistic!
I disagree that everything ARMA has to be realistic and I completely disagree about something like this being unrealistic. When you open a map in your actual hands or look at a map on a phone or a tablet, do you have peripheral vision or does it take up the entirety of your viewpoint? Do you literally pull the map up to your eyeballs and see nothing else? When you use Athena, you don't grow an extra set of eyes: you can only focus on one thing at a time and anyone that's intently reviewing the strategic positioning of friendly units in Athena is in a realistically vulnerable position but that position is also not as unrealistically vulnerable as they would be if they were using the in-game map which offers the player no peripheral vision whatsoever. Now, if your argument is "No one can look at a map and get back into the action that fast!", then you're not watching many ARMA videos on YouTube. I am literally amazed by how fast some players get in the map, understand what's going on, get out and get back into the action. Does it save time to be able to glance at a persistently updated display? Absolutely but this isn't far into the future out of the reach Star Trek technology: As a very janky solution, a soldier could Velcro a cellphone to their wrist and get the same 'glance and go' functionality... and glancing at your position on your map and very quickly ascertaining your relative position to other areas does not make you a super informed cheater...I still suck at ARMA. And if anything, the oddity of playing a first person shooter through a little window on a desk that dumps you into all sorts of different locales and terrain offsets, more so, the instant "I'm here compared to them" information that you get from Athena but at the end of all the discussion, it ultimately, ultimately, all depends on how you play the game and how you would think Athena would fit into that style. If it doesn't, it doesn't: I don't care :-)

Will it kill my frames?
Every mod has an impact on your framerate. Every mod. I can't tell you exactly how many frames you will 'lose' from running this application and it's completely subjective. Athena displays the status of every unit on your side. If you play a mission with 100 friendly units, it could take 100x longer to grab all of that data than it would if you were running around in ARMA by yourself. I myself in my testing in a mission with ~100 AI, half of which were on my 'side', experienced a ~5 fps impact and the impact will also vary depending on where the application is running. You have the mod stuff running on your gaming pc but the application can be running on a completely different device. Moving it over to another device might buy you only a frame or two so it's not an 'official performance recommendation', it's only something to be aware of when you try to measure the impact on performance that Athena will have. My guess is that it's no more impactful than some of the other major mods that alter major gameplay mechanics.

Is it complete? It looks like crap and this error popped up.
Hey man! This is something I'm putting together in my spare time. It's a labor of love and I think it's beautiful... jerk. More seriously though: when you find a bug, report it.

Is this open source? Can I view the source? Can I "help" you with the source? If I give you 'this', will you let me look at the source?
No. I may open up the SQF on GitHub and accept contributions to it but the Applications, the ACS and the AAR module will all remain closed. Why? Well, to start off with...I'm not passionate about 'open'. I'm not but why only the SQF? Mostly because the SQF is really the only thing, out of everything in Athena, that is purely ARMA focused. I have created an Internet connected whiteboard that allows multiple users to connect with each other while reviewing the same 'content', to save that content and replay it back at a later date. Is this something that no one else can do? Absolutely not. Its been done before but the fact remains that there are complete components that can be taken out and used for other purposes that could have fiscal value. Mostly though, I don't know what direction I might taken Athena in and I don't want my options to be restricted by the opinions of contributors who provided code in good faith with certain assumptions. Because I don't know where the future lies, I can't open it up so no.

Athena Desktop (Windows 7):
  • Unit and Group Locations/Data
  • Limited Marker Support
  • Client Side Execution
  • Follow your player
  • Manual zoom control
  • Offline map interaction
  • Athena Mod (@AthenaSvr)
Athena mod:
  • Exports mission, unit, group, marker and vehicle data to JSON for pickup by the application
  • Collect group, unit, vehicle, marker, mission data and relay through Athena Extension

To install Athena mod you should use modfolders to keep it seperate from the official game content to prevent issues.
With Arma 3 you can use different ways to set up your modfolders to use custom content you have downloaded.
Please visit the Arma 3 Mod install instructions page for more information about using custom mods and addons in Arma 3.

Armaholic note:
.dll files can harm your PC! Before running this you should make sure you understand the risks!
Armaholic and its staff can never be held responsible when this file causes any damages, disruption in services or anything else in any way! Downloading and installing this file is totally at your own risk!
We have run anti-virus tools on the included files and found no issues but this is no guarantee!

Armaholic note:
.exe files can harm your PC! Before running this you should make sure you understand the risks!
Armaholic and its staff can never be held responsible when this file causes any damages, disruption in services or anything else in any way! Downloading and installing this file is totally at your own risk!
We have run anti-virus tools on the included files and found no issues but this is no guarantee!

Included files:

I removed the images from the game download and provided them as separate downloads on the page. All of the images were exported from the Arma3 editor via the ExportNoGrid parameter. I do have versions of Altis and Stratis that are stitched together from the ingame editor but the Altis one is huge (440MB) so I'll be posting that on a 3rd party site if anyone is interested.

Media: has its own Youtube channel where we will cover the Community made releases.
Subscribe to the Youtube channel

The Armaholic hosted archive contains the Athena Scripts, the Export Extension and also the windows desktop app!

Code refactoring
Icons will now change color and type (unit, groups and vehicles were affected)
Noticed this during my group's session: downed (ACE medical) players were not showing as 'civ' which indicated that existing icons were not updating properly.
Update frequency limits removed. Previous limit of updating all non-player groups only every 100ms lifted.

Complete overhaul of markers
Unit Icons changed to use ARMA icons
Special icons for
NATO Icons changed to use ARMA icons
Marker Icons (those available in editor) changed to use ARMA icons
Marker Shapes (Rectangle/Ellipse) changed to use ARMA brush images
Vehicle Icons added
Icons added for vehicles
Icons are placed and oriented according to vehicle pos/dir
Icons are no longer placed according to vehicle location, not driver, command, etc.
Icons are no longer oriented according to vehicle position
Crew/Passenger list is displayed beneath vehicle icon
Icons for units are not displayed when in vehicle
Icons for groups are not displayed if group does not own vehicle (not commander, gunner, driver)
Misc visual improvements
Improved text visibility on grayscale color mode
Improved group name/group leader position (moved from below to right) and increased size
Misc bugs fixed
Resolved issue where Athena would immediately stop after starting
Resolved issue with oddly sized group markers after new group added
Resolved issue with empty groups being displayed (all members dead)

v1.0.0.26 Alpha fixed
- fixed bug introduced in

Athena Desktop
•Added - Multi Ink
•Added - Initial background image
•Added - Clear Map Controls Menu option (clears the map to remove data left over from previous missions)
•Added - Logic to detect mission change (Mission Name change)
•Added - Ability to rename groups
•Added - Cursor to indicate map panning
•Added - Ability to use scroll bars to pan map
•Added - Additional unit descriptions (crew, pilot, officer, ammo bearer, rifleman)
•Added - Alpha blended colors for GreenFor and Civ Group Icons
•Changed - Map Panning Logic
•Changed - Layer Management
•Changed - Group Icons Controls (Left Click on toggle unit list, Right Click to change size, Touch to change size)
•Changed - Group Icon display logic
•Fixed - Unable to ink near labels
•Fixed - Unable to ink near group icons

@Athena Mod
•Added - Support for Multi-Ink
•Added - Support for player based Athena variables
•Changed - Methods for grab files from network source improved

Athena Desktop
•Added - Marker Rotation support
•Added - Toggle-able grid lines
•Added - Toggle-able location names
•Added - Support for map specific locations.json files
•Added - Toggle-able ink visibility
•Added - Ink support (Ugly "I" button on left)
•Added - Ink Save/Load
•Added - Label to indicate zoom level
•Changed - Zoom step to 0.1 instead of 0.2 (smoother zoom in/out)
•Fixed - 6 digit grid coords were pulling Y value from Top to Bottom, not Bottom to Top for mouse cursor pos

@Athena mod
•Changed - Function names
•Added - Function for exporting location text (ATH_fnc_Export_Locs) Alpha
•Fixed - Additional localization issues
•Added - 6 Digit grid support for target unit and cursor position
•Added - Ability to import user supplied images for maps
•Added - Chunked image loading based on viewing rectangle for reduced memory usage

Athena mod: Alpha
•Fixed - Data export loop prevented missions with additional scripts from loading properly
•Fixed - Not correctly grabbing unit names in multiplayer missions
•Added - Dedicated server detection to prevent files from being generated and causing server side lag Alpha
- Fixed: Strings from ARMA containing C# escape characters caused export routine to crash Alpha
- first early release

Athena Desktop:
•Fixed - Multiple textblock creations per marker
•Added - DVR - Record and Playback missions
•Added - Ability to select unit to be tracked

- Fixed: Duplicate marker names were crashing marker cleanup routines
- Fixed: Duplicate object name checks on JSON import
- Fixed: Localisation issues when converting strings to numbers (Thanks Becario!)

- Initial Release

Forum topic:
- Armaholic forums
- BI forums

Enable javascript to be able to download from Armaholic please!

Tags: 2Nd Screen,   App