Home - aeroeng14/Foxhole-Artillery-Overlay GitHub Wiki

Welcome to the Foxhole Artillery Overlay (Project BARB) wiki!

NOTE: The overlay's wind offset feature is currently not compatible with the upcoming weather changes in Update 57 (4 wind tiers instead of 7, yada, yada...). I have the tools ready to begin testing once the update drops, but for now, just use the az/distance measuring feature. Thank you.

The purpose of this tool is to replace the existing, generic, artillery calculators out there with an always accessible tool that utilizes the available game map by overlaying on top of it (like a 2 layer cake) yet still allowing you to play Foxhole underneath via transparency.

It does not interact with the Foxhole game client in any way except through you, the player, via mouse. There are no hacks, no back doors, and no black magic (except the win32 api calls for the transparency functionality).

This overlay allows players to accurately use the map terrain markings, intel, map posts, and their own position in determining initial firing solutions. It does not replace the spotter, but acts as a supporting tool for gun crews. It works across whole maps as well.

This tool is not for precision fire, but replaces the repetitive task of copying azimuths and distances by hand to get those initial rounds into the spotters field of view where they can then walk them in. This workflow has been tested and it is accurate.

How it Works: The tool measures pixel distances and azimuth between the gun and target markers with high school trigonometry. Setting the scale tool size via the slider bar tells the overlay how many pixels equals 1 in-game meter then it converts those distances. If you choose to, wind offsets are lastly applied and the solution adjusted so after accounting for wind, your rounds will still land on/near the target marker. Please see the Foxhole wiki page about wind for more.

About the project: I originally conceived of this tool many years ago now, even before wind was added into the game. I just lacked the skills to put it together until now. This is also my first Unity project, so you developers out there forgive any egregious mistakes I may have made. I'm an aerospace engineer by trade, not a game dev :). I fully intend for this to be open sourced to the community as much as possible and that means both factions. Please follow the license so it remains open sourced to the community. All data herein has been sourced by me or with assistance of others and I have not taken anyone's proprietary data from secure sources. I will review and potentially accept pull requests for bug fixes, new features, etc. If you have wind offset or dispersion data I can incorporate, please send a source as well so I can verify it by some means.