dprophet / albatross-hud-community Goto Github PK

Albatross HUD Community Edition

A customizable piloting HUD skin for Dual Universe!
Watch a Demo · Report Bug

This piloting HUD for Dual Universe is designed for players of all experience levels. It's a visual improvement over the default, adding new features and flight controls to assist both new players and veterans. Our goal with this release is make sure everyone has access to an easy-to-use HUD and make their Dual Universe experience a little better.

Some Key Features:

• Visible key mappings for controls, which reflect your actual key maps
• Condensed improved visual with all the most relevant flight data in one spot
• Automatic planet/moon detection with data on braking time needed and atmo entrance
• Groupable fuel gauges, assign custom categories to your fuel types
• Navball display in atmo for pitch and roll
• Customizable colors and opacity

What This HUD Isn't:

• Not an autopilot; I recommend SagaHUD or ArchHUD for autopilot controls
• Not advanced; this hud is designed with new players in mind to help support DU
• Not pvp; while you can link weapons, the HUD does not support them natively

(back to top)

This HUD is delivered by "autoconf", a feature supported by Dual Universe for custom scripts. You will need to download a file as instructed below to add this HUD to your game's list.

Download the zipped autoconf file from this repo, (right-click this link and "Save link as") ais_albatross_hud

Unzip this, and move the .conf file into the game's autoconf custom folder below. The "ProgramData" folder may be hidden, but if you copy this path and paste it into a File Explorer window, that will still open the folder.

For Steam's game client: C:\Program Files (x86)\Steam\steamapps\common\Dual Universe\data\lua\autoconf\custom

For NQ's game client: C:\ProgramData\Dual Universe\Game\data\lua\autoconf\custom\

After extracting the file, make sure the "ais_albatross_hud_###" conf file is in the custom folder directly, and not inside a subfolder! Next you'll just need to activate it in-game.

For the most part, you won't need link anything! Almost all needs become linked automatically, with the exception of optional radars. You can link multiple radars to your seat before activating the HUD. If you use "Rename Element" on each radar, the HUD will bring in their custom names.

If you add new links (like radars), you will need to re-activate the HUD again with these steps also.

1. Make sure you've installed the file from above ^
2. Right-click on your hoverseat, command seat, or whatever flight unit
3. Select "Advanced", then "Update custom autoconf list"
4. Select "Advanced", "Run custom autoconf"
5. Select Albatross HUD from the list
6. That's it! Hop in the seat and enjoy

(back to top)

If you want to add the voice sounds you've seen from my twitch stream, the zip file here contains a folder called "albatross_hud" with the files inside. This folder has to go into a specific location for Dual Universe to read it, not in the autoconf folder. Before unzipping, move the zip file to:

This PC > Documents > NQ > DualUniverse > audio

Depending on your Windows version, the path may look like: C:\Users\YOURUSER\OneDrive\Documents\NQ\DualUniverse\audio

Make sure when you unzip it that the folder with the sound files is inside audio parent folder. You can rename the folder, if you change the Lua Parameter for the folder name.

Albatross HUD mostly follows the same default key bindings. However, I still recommend taking some time and looking at the button controls of the HUD before you fly. For example, holding ALT with CTRL (brakes) will lock the brakes, so that you can release both keys and still have the brakes active. Pressing G will either raise you to hover height, or lower you back down to the ground.

A:2 means Alt+2, and
AS:2 means Alt+Shift+2

Other Hotkeys:

1. AS:8 :: Enable/disable the burn speed and re-entry limiter
2. AS:9 :: Hide/show the build helper bar
3. S:L :: Toggle headlights

In the chat window, open the Lua tab and type help to get a list of commands you can run here, for example setting a specific AGG singularity, or setting a specific altitude to fly at. Some helpful examples:

1. altitude 2200
2. agg 14000
3. time 152.8
4. align thades
5. align pro
6. align ::pos{0,0,13856701.7693,7386301.6554,-258251.0307}

This HUD has several settings you can modify. Some are customizations like the HUD color, opacity, scale, and FPS rate. Others are key flight mechanics such as the Talent upgrade levels your ship has. If you're not familiar with talents yet, Then you can assume 0 for these (the default).

1. Right-click on your flight unit (seat)
2. Select "Advanced"
3. Select "Edit Lua Parameters"
4. Hover over the label to see a description of each option

Using the steps above, you can change the base color palette of the HUD. I've provided some suggestions below that look best with the HUD's format:

The HUD will automatically group your fuel tanks into single displays based on fuel type.. Atmo, Space, or Rocket. However, you can customize these groupings. For example, if you have some fuel tanks that are dedicated to just hover engines or vertical boosters, then you may want to see that in it's own grouping.

For this, you'll only need to rename the tanks you want to specifically group together. To rename, you'll first need to enter Build Mode (B), and right-click to Rename. Most fuel tanks have a default that looks like:

Space Fuel Tank s [52]

The " s " stands for small, and is needed by the HUD in the current version. But here's an example of what we could rename to:

Space Tank s (vboost) [52]

By adding parethesis and a category, all fuel tanks with a matching parenthesis will be grouped, and you can create as many groupings as you like.

While I do love Dual Universe and its community, I also have very little free time typically. I will try to answer questions via Discord, or if you catch me online on Twitch. But keep in mind this is a free resource, and I've spent a good chunk of time on it, so please be constructive and kind :)

Discord: Albatross HUD on DU-OSI

Twitch: Watch CodeInfused on Twitch
I go online at pretty random times, so if you'd like to catch my streams, just go here and hit Follow

(back to top)

Contributions will be welcome in a future version of the HUD with more advanced features. This community version is intended to stay simple and support a new playerbase coming into the game for the first time, and for players who enjoy a condensed but rich HUD experience. New features will only be considered for this version if they stay in line with that concept.

Use the Discord above if you'd like to give feedback or suggest a simple feature addition.

(back to top)

Distributed under the GNU GPLv3 license. See LICENSE.txt for more information.

(back to top)