Nuclear Option Autopilot Mod

Adds autopilot and some other features.

Installation

1. Install BepInEx 5.

   • their github has install instructions

   • if you are on linux, add override in steam launch options: WINEDLLOVERRIDES="winhttp=n,b" %command%

   • run the game, then quit

   • edit BepInEx.cfg in BepInEx/config

   • line that says: HideManagerGameObject = false

   • should be changed to: HideManagerGameObject = true

   (mod will not work with this setting off. the config manager will also not work with it off.)

2. (Recommended) Install BepInEx Configuration Manager. It is useful for editing settings ingame.

   • download BepInEx Configuration Manager
   • place extracted folder in BepInEx/plugins. (make sure your folder structure is like the image below)

3. Download com.qwerty1423.NOAutopilot-{version}.zip from releases (to the right if you are on pc) and extract the dll.

4. Place the dll into your BepInEx/plugins/ folder.

5. Run the game again to generate the config file (for the mod). The mod should work at this point.

folder structure after install (the names are wrong now but the locations are the same):

If you're stuck you can try Primeva 2082 discord's mod install guide: https://docs.google.com/document/d/16aRWcrkt89YEn9_THwe9Fxo7AYPLE9SYSab_Y929dvE

or ask for help on the nuclear option discord.

Default Controls

The autopilot can be configured using only the F8 gui window and the map, so F8 is probably the most important keybind to remember. Leave blank the text boxes that you don't want to be controlled by the autopilot, then click set values (a few times just in case).

Action	Key	Description
Toggle Autopilot	= (Equals)	Self-explanatory.
Toggle Auto-Jammer	/ (Slash)	^^^
Target Alt Small Adjustment	Up / Down Arrow	Small adjustments (0.1m default)
Target Alt Large Adjustment	Left / Right Arrow	Large adjustments (100m default)
Max Climb Rate +/-	PageUp / PageDown	Limit vertical speed
Bank Left/Right	[ and ]	Adjust roll angle
C Crs/R Roll/C Alt/C Roll	' (Quote)	clear/reset in that order, one per keystroke
Toggle GCAS	\ (Backslash)	added just in case
Toggle autothrottle	;	will write current speed to ui/delete it
Toggle AP GUI	F8	opens/closes the GUI

Large altitude adjustment key has minimum limit to reduce crashes when sea skimming if the key is accidentally pressed.

Keys and UI colours are configurable in the BepInEx config file. The BepInEx Configuration Manager is recommended for changing PID values and other settings in game.

screenshot of an old version?

features and not features

Some of the not features may eventually be implemented.

list of notable features in the mod

In order of implementation, earliest first

• wing leveller and altitude hold
• climb/descend to altitude at set rate
• set target roll angle
• HUD autopilot display
• fuel time and range display
• Medusa auto jam on full capacitor (won’t select targets or weapons)
• Auto-GCAS
• simple autopilot GUI
• course hold
• autothrottle
• waypoints

features not in the mod (yet?)

In approximate likelihood of implementation order descending.

• yaw control
• nap of the earth flying
• proper helicopter support
• auto take-off and landing

Autopilot

vortex-ap.mp4

Autopilot controls roll and pitch. (helicopters somehow work, but probably require small ascent/descent rate limits).

Ascent/descent rate limits and target altitude can be configured with keyboard while flying. There is also GUI that opens with F8 key by default.

Target bank angle can be set so that plane turns in a circle. Should be useful for Medusa, for easier loitering.

Large stick inputs will disengage the autopilot.

Displays current settings on the HUD. The format is [Target Altitude] [Max Climb Rate]\n[Target speed] [Target Bank Angle/course] [distance to next wp]. For example, autopilot set to 3m altitude, at 40m/s climb rate, at 0 degrees bank angle will show up as 3 40 S- R0 on the HUD.

PID values can be tuned further if you like, but the defaults should be quite effective. They may not work in all situations or in all aircraft, however.

There is no limit to the minimum altitude or maximum altitude, but crashes and engine flameouts may result from flying too low or too high.

Auto Jammer

There is also an auto jammer mode for Medusa, that will jam if capacitor is full. The auto jammer will hit the fire button if there is a target selected and the jammer pods are selected.

Fuel time and range display

Also displays fuel time remaining and range.

Units use the game's metric/imperial setting.

Auto-GCAS

vortex-gcas.mp4

Will pull up if you are going to hit the ground and warns you a while before. Can be disabled with \ key by default, and can be configured to start disabled. GCAS OFF warning can be disabled as well.

If you are making large inputs, it will not pull up.

Waypoints

2026-01-13-wp-testlq.mp4

Simple how to use guide: Right click / shift + right click on the map to make a path, then press equals and f8. Hover mouse over the UI for tooltips.

Setting waypoints will work as long as you don't create any yellow unit path lines, so as long as the first unit you have selected is not commandable then you can make a waypoint.

Building from source

prerequisites

• .NET SDK 10 something
• game files

steps

1. clone the repo, cd no-autopilot-mod, checkout a release version.
2. copy dependencies into /Libs folder from game files. (mainly in /Nuclear Option/NuclearOption_Data/Managed). the list is in the .csproj.
3. dotnet build -c Release

releases >3.13.3 reproducible (probably). Getting the correct versions of the dlls might be difficult. You also have to clone the repo and checkout the correct version.