FreeSpace Wiki - User contributions [en]

Getting started with FreeSpace 2

2017-02-18T23:30:02Z

Yarn: Added the alternate registry location for 64-bit Windows

<center>'''For up-to-date instructions, choose your platform: [http://www.hard-light.net/forums/index.php?topic=78710.0 Windows] [http://www.hard-light.net/forums/index.php?topic=79545.0 Linux] [http://www.hard-light.net/forums/index.php?topic=79546.0 Mac OS X]'''</center>

This page is under construction (if this page is deemed necessary that is -> [[Talk:Getting_started_with_FreeSpace_2|talk page]]).

It is also outdated. Both the builds and mediaVPs are in 3.6.10 beta phase at this point in time, check Hard-Light Forums for the latest news and stuff.

==Getting Retail FreeSpace 2==
::''Main article [[Getting_FreeSpace]]...''
*Buy CDs
*Buy it online, for example from [http://www.gog.com/en/gamecard/freespace_2 GOG.com]

==Installing Retail FreeSpace 2==
::''Main article [[Installing Freespace 2]]...''
*Install the game
*To use FreeSpace 2 Open only the the retail data files are needed ([[*.VP]] files). This makes it possible for user to 'install' or extract the '''vp''' files from the main game data and then move the files to another platform for example to Linux or OS X. However it is recommended that the data files should be patched before moving them. See [[Fs2 open on Linux]] for more information.
*Make sure you have [http://connect.creativelabs.com/openal/Downloads/Forms/AllItems.aspx OpenAL] installed

==Update the Retail FreeSpace 2==
{{Note|This step is only required if the data has not already been patched}}
*Download and run Freespace 1.2 update
*[http://homepage.ntlworld.com/karajorma/FAQ/Downloads/HotUv1.20Pack.rar FreeSpace 2 Patch (version 1.2)] | Alternate link: [http://www.gameupdates.org/details.php?id=4722 FS2 1.2 patch from gameupdates.org] Note that you will need a [http://en.wikipedia.org/wiki/Comparison_of_BitTorrent_clients BitTorrent] client to download from gameupdates; I recommend uTorrent.
*Some versions have this already preinstalled

==Installing FreeSpace Open==
::''Main articles [[Installing FreeSpace 2 Open]] and [[FreeSpace Open Installer]]...''

===Launcher===
Using a Launcher makes configuring & running FSO much easier. Unless you know what you're doing, use either wxLauncher (preferred) or Launcher 5.5g.
{{Note|In some cases on Windows, you need to run the Launcher as Administrator in order to be able to update the registry correctly}}
*[http://www.hard-light.net/forums/index.php?topic=67950.0 wxLauncher] (Cross Platform)
*[http://swc.fs2downloads.com/files/Launcher55g.zip Launcher 5.5g] (Windows only)

====Launchers still in development====
*[http://www.hard-light.net/forums/index.php?topic=86364.0 Knossos] (Cross Platform, includes installer functionality)
* m!m's new launcher (but I can't find the release thread :() (Windows only)

===Game Builds===
====Latest Official Build====
*[http://www.hard-light.net/forums/index.php?topic=89597.0 Link to FS2 Open 3.7.2]

====Current Development Builds====
*[http://www.hard-light.net/forums/index.php/board,173.0.html Nightly Builds]

===MediaVP File Sets===
*The MediaVPs are a set of upgrades to the game assets, e.g. models, textures, sounds, etc.
*MediaVP sets should always be installed to their own directory that is located in the FreeSpace root directory. The [[FreeSpace_Open_Installer|installer]] is the preferred way to install the mediavps. For manual installs they should in be installed to a versioned directory, e.g. '''c:\games\freespace2\mediavps_3612''' or '''c:\games\freespace2\MediaVPs_2014'''
----
====Latest Official MediaVPs====
*[http://www.hard-light.net/forums/index.php/topic,58230.0.html 3.6.10 MediaVP Release Thread]
*[http://www.hard-light.net/forums/index.php?topic=70739.0 3.6.12 MediaVP Release Thread]
*[http://www.hard-light.net/forums/index.php?topic=86475.0 2014 MediaVP Release Thread]

==Setting up the Launcher==
===Selecting the Game Build===
*First thing to do is to click on the '''Browse...''' button at the top of the Launcher and select the build you installed.
===Audio/Joystic===
*If you have trouble with your joystick not working properly in FS2_Open, you may try the '''Force 0''' or '''Force 1''' options, which will force FS2_Open to use the first or second joysticks, respectively.
===Network===
*Adjust the settings according to your setup.
===Speech===
*If you are using Windows XP, or have the Speech API installed, FS2_Open will be able to read briefings, techroom descriptions, and even in game messages to you using computer-generated voices. Although no match for real voice acting, it is convenient when valid plot points are mentioned in the middle of combat. Speech in the various locations can be turned on and off by checking and unchecking the check boxes; you can choose which of the installed voices to use in FS2_Open by changing the drop-down menu.
===Registry===
*Unless you know what you are doing '''don't''' tamper with these settings
*Default location is: HKEY_LOCAL_MACHINE -> Software -> Volition -> Freespace2
*On 64-bit Windows, the location is one of the following:
**HKEY_CURRENT_USER -> Software -> Classes -> VirtualStore -> MACHINE -> SOFTWARE -> Wow6432Node -> Volition -> Freespace2
**HKEY_LOCAL_MACHINE -> SOFTWARE -> Wow6432Node -> Volition -> FreeSpace2

On OSX / Linux / BSD an .ini file is used instead of the registry. It is located here:

*~/Library/FS2_Open/fs2_open.ini (OSX)
*~/.fs2_open/fs2_open.ini (other *nix variants)

===Video===
* On some older or special builds user can choose which API to use (OpenGL or Direct3D) however usually it defaults to '''OpenGL'''. In any case it is '''recommended to use OpenGL''' as DirectX is unstable and not actively supported.
* Select the preferred resolution for the game.
===Features===
*This tab is where most of FS2_Open's options can be toggled on and off. At the top is a readout of your current command line. You should include this if you ever need to report an error with FS2_Open.
*'''Easy setup''' basically allows you to turn lots of features on or off at once. Generally most people use it and then fine tune the settings immediately afterwards.
*'''Custom flags''' allows you to add any command line flags that don't show up in the Launcher. This may be because they require additional arguments, as is the case with the '''-fov''' command line argument (for more information, you can see the [[Command-Line Reference]] page of the wiki). Its recommended to add '''''-ambient_factor 50''''' to the command line.
*Finally, the two boxes below this let you toggle the various new features in FS2 Open individually. The list type option lets you choose between graphics, sound etc and the tickboxes let you turn the feature on or off.
===MOD===
*This tab is used to select mods for the game. For example this installation guide directs you to install MediaVPs in such a way that FS2 will treat them as a mod. Click '''Select MOD''' and choose '''''mediavps''''' folder that you picked earlier.
*The reason that we installed the media VPs as a mod is that if FS2_Open doesn't work you can select the '''no MOD''' button and run without them and check if the problem is with the build or with the media VPs. It also means that you can still run retail FS2 if you want to.

[[Category:The games]]

Hud gauges.tbl

2016-09-15T04:34:43Z

Yarn:

{{SCP table}}

{{TableVersionGit|2016-09-14|f9bc01c}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that is used to raise the probability of hitting a target with primary weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that indicates where your shots will end up, as opposed to Lead Indicator that indicates where you have to shoot at to hit your target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
{{table375|
:[[Hud_gauges.tbl#Center Text On Gauge X-Position:|Center Text On Gauge X-Position:]] (Optional)
}}

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons in place of Primary/Secondary Top/Middle/Bottom files.

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Afterburner Energy:|+Afterburner Energy:]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

====Center Text On Gauge X-Position:====
{{Table375|
Sets whether to position the center of the text to the gauge's X-position.
*Syntax '''Boolean'''
*Default Value: '''false''' if the gauge is explicitly given a position, '''true''' otherwise
Used by: [[Hud_gauges.tbl#+Fixed Messages:|+Fixed Messages:]]}}

[[Category:Tables]]

Template:Table375

2016-09-15T04:31:53Z

Yarn: Created page with "<noinclude>Table375</noinclude> <div style="padding: 1px 2px 1px 2px; background-color: #156364; border: solid 1px #1d8788; padding: 0px 4px; font-size: -1…"

<noinclude>[[Category:Templates|Table375]]</noinclude>
<div style="padding: 1px 2px 1px 2px; background-color: #156364; border: solid 1px #1d8788; padding: 0px 4px; font-size: -1; color: #31e5e7">'''FS2 Open, 3.7.5:''' {{{1}}}</div>

Hud gauges.tbl

2016-09-11T06:18:10Z

Yarn: /* +Extra Target Data: */

{{SCP table}}

{{TableVersionGit|2016-02-07|0ed147f}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD. This can either be a string or a number. A string references a font with a specific name while a number references a font with a specific index in the fonts table. The number option is deprecated and is only there for backwards-compatibility. Use the name if possible.

*Syntax: '''String''' or '''Integer''' font index number
*Valid Values: Any name or font index as defined in [[Fonts.tbl]]

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Order Max Width:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that is used to raise the probability of hitting a target with primary weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that indicates where your shots will end up, as opposed to Lead Indicator that indicates where you have to shoot at to hit your target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons in place of Primary/Secondary Top/Middle/Bottom files.

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Afterburner Energy:|+Afterburner Energy:]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

[[Category:Tables]]

Messages.tbl

2016-06-28T00:43:42Z

Yarn: Updated +AVI Name: to document the behavior of newer builds

{{TableVersion|10943}}

The '''messages.tbl''' is used to link actions, animations, and sounds of the messages received during the mission. Personas are used to group messages by the same talker, for example, all the Wingman 1 (Male Terran Pilot) messages go with a Wingman 1 persona.

Each message is composed of a text macro, and optionally a head .ani and/or an audio macro.

[[Tables|List of Tables]]

==#Message Frequencies==
{{Table3615|
Optional Group. Defines how often and how many times during the campaign the messages should be shown.}} 

===$Name:===
{{Table3615|
Required. Defines the message to augment.
*Syntax: '''String'''
*Available Values: See [[Messages.tbl#.24Name:_2|$Name in Messages.tbl]]}} 

===+Occurrence Chance:===
{{Table3615|
Optional. Defines the % chance this message will be played when the associated event occurs. For example, if you score a kill, and the '''+Occurrence Chance:''' is 10 for a Praise message, then there is a 10% chance that you a Praise message will play.
*Syntax: '''Integer'''
*Available Values: '''Between 0 and 100'''}} 

===+Maximum Count:===
{{Table3615|
Optional. Defines the maximum number of times this message will be played during a given mission.
*Syntax: '''Integer'''}} 

===+Minimum Delay:===
{{Table3615|
Optional. Defines the minimum delay time between being queue by the game and the time the message actually plays. (This helps simulate "organic" AI's)
*Syntax: '''Integer''' in milliseconds}} 

==#Moods==
{{Table3615|
Optional. You can change the mission mood using the new set-mission-mood SEXP, and those moods can be used to filter what built-in messages are played by defining a mood within a message. This section lists all available moods for use in the table and in the SEXP.}} 

===$Mood:===
{{Table3615|
Optional. The name of a mood to be attached to a message and set as a mission mood. Example: Happy, Vengeful, etc.
*Syntax: '''String'''}} 

==#End==
{{Table3615|
The moods section, if it exists, must end with #End.}}

==#Personas==
Required. The #Personas group is used to define the all of the personas used for the messages. 

===$Persona:===
Required. Defines the name of the persona
*Syntax: '''String''' 

===$Type:===
Required. Defines the type of the persona
*Syntax: '''String'''
*Available types:
::'''wingman'''
::'''support'''
::'''large'''
::'''command''' 

===+<Species>===
Optional. The +<Species> (such as '''+Vasudan''') can be used to assign personas to other species. If omitted, the Persona is assigned to the '''default''' species.
*Syntax: +'''String''' 

===$Allow substitution of missing messages:===
{{Table373|Optional. This is set to true by default, meaning that in cases where a Persona does not have defined messages for all built-in message types, the engine will try to find a matching message from other personas of the same type and species.
*Syntax: '''Boolean''' }}

==#Messages==
Required. The #Messages group contains all available messages. 

===$Name:===
Required. Defines the type of the message
*Syntax: '''String'''
*Available types (types marked with '''*''' do not have code support) :
::'''Arrive Enemy'''
::'''Attack Target'''
::'''Beta Arrived'''
::'''Check 6'''
::'''Engage'''
::'''Gamma Arrived'''
::'''Help'''
::'''Praise'''
::'''Backup'''
::'''Ignore Target'''
::'''No'''
::'''Oops 1''' * (Only Command has code support in Retail)
::'''Permission''' *
::'''Stray''' *
::'''Depart'''
::'''yes'''
::'''Rearm on Way'''
::'''On way'''
::'''Rearm warping in'''
::'''No Target'''
::'''Docking Start''' *
::'''Repair Done'''
::'''Repair Aborted'''
::'''Traitor'''
::'''Rearm'''
::'''Disable Target'''
::'''Disarm Target'''
::'''Player Dead'''
::'''Death'''
::'''Support Killed'''
::'''All Clear''' *
::'''All Alone'''
::'''Repair'''
::'''Delta Arrived'''
::'''Epsilon Arrived'''
::'''Instructor Hit'''
::'''Instructor Attack'''
::'''Stray Warning'''
::'''Stray Warning Final'''
::'''AWACS at 75'''
::'''AWACS at 25'''
{{Table3611|
::'''Praise Self'''
::'''High Praise'''
::'''Primaries Low'''}} 

===$Message: and $MessageNew:===
Defines the message shown in game screen when the message is triggered. Value is a reference to [[tstrings.tbl]]. 
'''$Message:''' is used for single-line messages, while '''$MessageNew:''' is used for multi-line messages (but can also be used for single-line messages)
*'''$MessageNew:''' is preferred over '''$Message:'''
*Syntax: XSTR("'''string'''", '''integer''') 

===+Persona:===
Optional. Defines the persona associated with the message
*Syntax:
'''String''' 

===+AVI Name:===
Optional. Determines the ANI file to be played when the message is triggered.

In FSO 3.7.4 and later, the game initially attempts to use the file ''<string>''.ani with a persona message. In earlier versions, or if ''<string>''.ani does not exist, the game picks one of ''<string>''a.ani, ''<string>''b.ani and ''<string>''c.ani each time. So if you have defined ''+Avi Name: Head-Joe'', and ''Head-Joe.ani'' does not exist, the game will attempt to use the files ''Head-Joea.ani'', ''Head-Joeb.ani'' and ''Head-Joec.ani''. For wingmen personas, the ''c'' variant is assumed to be a death animation.
*Syntax: '''String''' 

===+Wave Name:===
Optional. Sets the sounds file that is played when the message is triggered
*Syntax: '''String''' 

===$Mood:===
{{Table3615|
The mood where this message should ideally be played. It may be played on other moods as long as it is not excluded for them below, if no better matching message is found.
*Syntax: '''String'''}} 

===$Exclude Mood:===
{{Table3615|
A list of moods not to play this message, ever. The list goes in parentheses. See Terran 'Attack Target' example below for usage.
*Syntax: '''String List'''}} 

==#End==
{{Table3615|
The very last entry must be #End. No exceptions.}} 

==#Simulated Speech Overrides==
{{Table3613|
Optional. Used to add file names to the generic message list, which defaults to 'none', 'cuevoice', 'emptymsg', 'generic', and 'msgstart'. Filenames listed below will be overridden by Text to Speech (TTS) when it is enabled, in addition to those in the default list.}} 

===$File Name:===
{{Table3613|
Optional. File name to add to the overrides list. Filenames provided here, however, must include an extension or a warning will be issues, for example msg_1.wav.
*Syntax: '''String'''}} 

==#End==
{{Table3613|
Must also end the optional Simulated Speech Overrides section with #End.}} 

==Sample==
This is a snippet of the retail FreeSpace 2 table, highlighting two major examples between a default (Terran) persona and a species (Vasudan) persona. Command, Support, and Large ship message examples are also included. Newer features have been added for extra clarification of their usage.
<pre>;; This is a list of moods that the game will use for builtin
;; messages. Any message without a mood is treated as General

#Moods

$Mood: Happy
$Mood: Angry
$Mood: Vengeful

#End

#Personas

$Persona: Wingman 1
$Type: wingman

$Persona: Wingman 6
$Type: wingman
+Vasudan

$Persona: Support Ship
$Type: support

$Persona: Support Ship Vasudan
$Type: support
+Vasudan

$Persona: Large Ship
$Type: large

$Persona: Large Ship Vasudan
$Type: large
+Vasudan

$Persona: Terran Command
$Type: Command

#Messages

;; ALL CLEAR ..................................................................................

$Name: All Clear
$Message: XSTR("Command, we have secured the area.", 2725)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_allclear.wav

$Name: All Clear
$Message: XSTR("All enemy forces negated.", 2730)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_allclear.wav

;; ARRIVAL (Enemy) ...................................................................

$Name: Arrive Enemy
$Message: XSTR("Bandits incoming!", 1079)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_arrival.wav

$Name: Arrive Enemy
$Message: XSTR("Reading hostile indicators.", 2734)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_arrival.wav

$Name: Arrive Enemy
$Message: XSTR("Incoming jump signature! Hostile configuration!", 2736)
+Persona: Terran Command
+Avi Name: Head-CM2
+Wave Name: TC_arrival.wav

;; ATTACK MY TARGET ...........................................................................

$Name: Attack Target
$Message: XSTR("Roger that, sir. Engaging your target.", 2737)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_attack.wav

$Name: Attack Target
$Message: XSTR("Yes sir, I'll make the bastards pay for Capella!", 2737)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_attack.wav
$Mood: Vengeful
$Exclude Mood: ( "Happy" )

$Name: Attack Target
$Message: XSTR("Yes sir. I just love killing Shivans!", 2737)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_attack.wav
$Mood: Angry
$Exclude Mood: ( "Angry" "Vengeful" )

$Name: Attack Target
$Message: XSTR("Affirmative. We will destroy your target.", 2742)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_attack.wav

;; BACKUP ARRIVAL (previously named "REINFORCEMENTS") .........................................

$Name: Backup
$Message: XSTR("Reinforcements on station. Request status brief.", 2744)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_backup.wav

$Name: Backup
$Message: XSTR("We are here to assist. What is your status?", 2749)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_backup.wav

;; BETA WING ARRIVAL ..........................................................................

$Name: Beta Arrived
$Message: XSTR("Beta wing here. Standing by.", 2751)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_beta.wav

$Name: Beta Arrived
$Message: XSTR("Beta wing is on station.", 2756)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_beta.wav

;; CHECK YOUR SIX .............................................................................

$Name: Check 6
$Message: XSTR("Check your six!", 2758)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_Check6.wav

$Name: Check 6
$Message: XSTR("Take evasive action, pilot!", 2763)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_Check6.wav

;; DEATH (previously wingman scream)...................................................

$Name: Death
$Message: XSTR("Noooooooo!!!", 2765)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_Death.wav

$Name: Death
$Message: XSTR("Avenge me!", 2770)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_Death.wav

;; DELTA WING ARRIVAL .........................................................................

$Name: Delta Arrived
$Message: XSTR("This is Delta wing. What's your status?", 2772)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_Delta.wav

$Name: Delta Arrived
$Message: XSTR("Delta wing is ready to assist, pilot.", 2777)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_Delta.wav

;; DEPART (previously named "WARPOUT") ........................................................

$Name: Depart
$Message: XSTR("Yes, sir! I'm outta here!", 2779)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_depart.wav

$Name: Depart
$Message: XSTR("We are departing as ordered.", 2784)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_depart.wav

$Name: Depart
$Message: XSTR("I copy. Engaging jump drive now.", 2786)
+Persona: Support Ship
+Avi Name: Head-TP3
+Wave Name: S_depart.wav

$Name: Depart
$Message: XSTR("Departing field of engagement.", 2787)
+Persona: Support Ship Vasudan
+Avi Name: Head-VP2
+Wave Name: VS_depart.wav

$Name: Depart
$Message: XSTR("We are departing as ordered.", 2788)
+Persona: Large Ship Vasudan
+Avi Name: Head-VP1
+Wave Name: 6_depart.wav

;; DISABLE TARGET .............................................................................

$Name: Disable Target
$Message: XSTR("Roger that, sir. Disabling your target.", 2789)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_Disable.wav

$Name: Disable Target
$Message: XSTR("Affirmative. Disabling your target.", 2794)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_Disable.wav

;; DISARM TARGET ..............................................................................

$Name: Disarm Target
$Message: XSTR("Yes, sir! Targeting weapons now!", 2796)
+Persona: Wingman 1
+Avi Name: Head-TP1
+Wave Name: 1_Disarm.wav

$Name: Disarm Target
$Message: XSTR("Acknowledged. Weapon subsystem targeted. ", 2801)
+Persona: Wingman 6
+Avi Name: Head-VP1
+Wave Name: 6_Disarm.wav

#End

#Simulated Speech Overrides

$File Name: msg_1.wav
$File Name: msg_2.wav
$File Name: msg_3.wav
$File Name: msg_4.wav
$File Name: msg_5.wav
$File Name: msg_6.wav

#End</pre>
[[Category:Tables]]

Wolf 359

2016-03-24T02:47:40Z

Yarn: Removed a garbage character

===Celestial Information===
*''Distance from Sol:'' 7.797 lyrs, 2.391 par
*''Type of System:'' Singular
*''Color:'' M6e-Red Dwarf
*''Right Ascension:'' 10h 54m 6s
*''Declination:'' +7° 19' 12"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Alphard]]
*[[Luyten 726-8]]

[[Category:Stars and Planets]]

Vega

2016-03-24T02:47:24Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and constellation:'' Alpha Lyrae, Lyra. The original name "Wega", then turned into "Vega", comes from the Arabic word waqi meaning ''falling'', via the phrase النسر الواقع an-nasr al-wāqi‘, which is translated with ''the falling eagle'' or ''the swooping vulture.''
*''Other name(s) and meaning:'' Dayan-same (Assyrian for ''Judge of Heaven''), Tir-anna (Akkadian for ''Life of Heaven''), Dilgan (Babylonian name given to many other stars, which means ''the Messenger of Light''), Zhi Nü 織女 (Chinese name), Vultur Cadens (Latin word with the same meaning as Vega).

*''Distance from Sol:'' 25.30 ly, 7.756 pc
*''Type of System:'' Singular
*''Color:'' A0-White Main Sequence
*''Right Ascension:'' 18h 36m 56.332s
*''Declination:'' +38° 47' 1.17"

===Important Events===
*The PVD ''Typhon'' was first sighted during the "[[Vega Engagement]]" during the Terran-Vasudan War, resulting in the destruction of the GTD ''Eisenhower''. The Terran 4th fleet (as described in the Typhon techroom description) was decimated during this engagement.
*Along with Beta Cygni, cited as one of the first systems attacked by the Shivans.
* (25/1/2335) The 3rd fleet (GTA) is reported as having lost the GTD ''Amadeus'' in Vega at some point prior to the joint Terra-Vasudan declaration of war on the Shivans.
* (15/2/2335) The Vasudan fleet was decimated by a Hammer of Light attack in Vega. The Vasudan fleet had been massing in Vega for a counterstrike after the initial Shivan attacks while the GTA fortified [[Antares]]. The Shivans bypassed both systems and reached [[Deneb]] via an uncharted jump node.
*The [[GTD Bastion|GTD ''Bastion'']] was transferred to Vega at some point between FS1 and FS2. Vega remains the 4th Fleet's base.
*The players training missions "take place" in Vega at the beginning of FS2.
*Home of the 4th Fleet in FreeSpace 2
*GTVA refugees were evacuated to Vega and [[Epsilon Pegasi]] during the Shivan invasion and subsequent destruction of Capella.
*The Shivans launched a "massive attack" upon the Vega node whilst the ''Bastion'' was being deployed in Capella to destroy the [[Epsilon Pegasi]] node.
*During the same time period, the GTD ''Nereid'' was sent (laden with Meson Bombs) from Vega to destroy the node connection to Capella.
*The Meson Bomb was developed at the Hideki Institute in Vega.
*In FreeSpace 2, Admiral Petrarch transfers the player to the Vega Penal Colony if the player is a traitor.

===Jump Nodes===
*[[Antares]] ([[Node Inconsistencies#CBAnim|CBAnim]])
*[[Beta Aquilae]]
*[[Capella]] (collapsed in 2367)
*[[Deneb]]
*[[Ribos]] ([[Node Inconsistencies#CBAnim|CBAnim]])

[[Category:Stars and Planets]]

Sol

2016-03-24T02:46:19Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Sol is Latin for "Sun". [[Image:Intel earth.png|right|]]
*''Other name(s) and meaning:'' Sun
*''Distance from Sol:'' 0 lyrs, 0 par
*''Type of System:'' Singular
*''Color:'' G2-Yellow Main Sequence
*''Right Ascension:'' 0h 0m 0s
*''Declination:'' +0° 0' 0"

===Known Planets===
*Mercury
*Venus
*[[Earth]]
*Mars
*Jupiter
*Saturn
*Uranus
*Neptune
===Important Events===
*Birthplace of [[Terrans|Terran]] civilization
*March 2335: Cut off from subspace node network.

===Jump Nodes===
*[[Beta Aquilae]] ([[Node Inconsistencies#CBAnim|CBAnim]] - presumed collapsed in 2335)
*[[Delta Serpentis]] (collapsed in 2335)
*[[Deneb]] ([[Node Inconsistencies#CBAnim|CBAnim]] - presumed collapsed in 2335)

[[Category:Stars and Planets]]

Sirius

2016-03-24T02:46:00Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name and Constellation:'' Alpha Canis Maioris, Canis Maior. Adaption to Latin of the Greek Σείριος (Seirios, which means ''glowing'' or ''scorcher''), though the name might not be of Greek origin.
*''Other name(s):'' Alhabor, Al-Shira (Arabic for ''The Leader''), Aschere (derivation of Al-Shira), Mrgavyadha and Lubdhaka (Sanskrit for ''deer hunter'' and ''hunter'', respectively), Lokabrenna (name used in Scandinavia, that means ''burning done by Loki'' or ''Loki's torch''), Aoboshi (Japanese for ''blue star'').

*''Distance from Sol:'' 8.601 ly, 2.637 pc
*''Type of System:'' Binary
*''Color:'' A1-White Main Sequence, A2-White Dwarf
*''Right Ascension:'' 6h 45m 8.871s
*''Declination:'' -16° 42' 57.99"

===Important Events===
*2366: Sirius follows Bosch's lead and leaves the [[GTVA]] in favour of joining the [[Neo-Terran Front]].

===Jump Nodes===
*[[Alpha Centauri]]
*[[Delta Serpentis]] ([[Node Inconsistencies#Pseudocanon|Pseudocanon]])
*[[Deneb]]
*[[Regulus]]

[[Category:Stars and Planets]]

Ross 128

2016-03-24T02:45:37Z

Yarn: Removed a garbage character

===Celestial Information===
*''Distance from Sol:'' 10.89 lyrs, 3.338 par
*''Type of System:'' Singular
*''Color:'' M4n-Red Dwarf
*''Right Ascension:'' 11h 47m 44.426s
*''Declination:'' +0° 48' 16.96"

===Known planets===
*''SR-5'' - the planet orbited by [[FreeSpace 1 Terran Ship Database#GTI Riviera|Outpost Riviera]]. Destroyed by the ''Lucifer'' according to the [[FreeSpace Reference Bible]].

===Important Events===
*2335: The first contact with the [[Shivans]] took place in the Ross 128 system, when a Shivan scouting party engaged and destroyed several [[Terrans|Terran]] and [[Vasudans|Vasudan]] fighters, that were engaged in combat. The lone survivor, Lt. Ash, died fleeing to the Riviera installation, which was subsequently destroyed by the Shivan Superdestroyer ''[[SD Lucifer|Lucifer]]''.
*[[The Return to Ross 128]]: Galactic Terran Intelligence sends a group of fighters to Ross 128, who witness an intense furball between [[Hades Rebellion|rogue]] GTI units and Shivans.

===Jump Nodes===
*[[Delta Serpentis]]
*[[Laramis]]

[[Category:Stars and Planets]]

Regulus

2016-03-24T02:44:46Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Leonis, Leo. "Regulus" is Latin for "king of a small land", "young king", "prince", "basilisk", "queen bee".
*''Other name(s) and meaning:'' Qalb Al Asad (Arabic, meaning ''the heart of the lion'', Kabeleced (same meaning as Qalb Al Asad), Cor Leonis (same meaning, but in Latin)
*''Distance from Sol:'' 77.5 ly, 23.8 pc
*''Type of System:'' Trinary
*''Color:'' B7-Blue Main Sequence, K1-Orange Main Sequence, M-Red Dwarf
*''Right Ascension:'' 10h 8m 22.315s
*''Declination:'' +11° 58' 1.89"

===Important Events===
*Became headquarters of the [[Regulus Syndicate]] after the collapse of the [[Galactic Terran Alliance]].
*2366: Following Bosch's coup in [[Polaris]], Regulus secedes from the [[GTVA]], joining the [[Neo-Terran Front]].

===Jump Nodes===
*[[Polaris]]
*[[Sirius]]
*Unknown System

==Notes==
*Regulus is misspelled as "Regulas" in [[Love the Treason...]], the second mission of the first [[Special Operations Command|SOC loop]].

[[Category:Stars and Planets]]

Procyon

2016-03-24T02:44:21Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Canis Minoris, Canis Minor. The name comes from the Greek προκύον (prokúon), meaning ''before the dog'' (since it precedes the Dog Star, [[Sirius]])
*''Other name(s) and meaning:'' Elgomaisa, 南河三 Nánhésān (Chinese for ''the Third Star in the Southern River'').

*''Distance from Sol:'' 11.41 ly, 3.497 pc
*''Type of System:'' Binary
*''Color:'' F5-Yellow Main Sequence, A-White Dwarf
*''Right Ascension:'' 7h 39m 18.113s
*''Declination:'' +5° 13' 30.06"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Adhara]]

Though this is a double-star system, only the primary star is indicated on [[Official Volition Node Map|the Official Volition Node Map]].

[[Category:Stars and Planets]]

Polaris

2016-03-24T02:43:59Z

Yarn: Removed a garbage character

:''This article is about the star system. For the non-canon installation, see [[GTI Polaris]].''

==Celestial Information==
*''Name, meaning and Constellation:'' Alpha Ursae Minoris, Ursa Minor.
*''Other name(s) and meaning:'' Alrukaba, Cynosura, Alruccabah, Phoenice, Lodestar, Pole Star, Tramontana, Angel Stern, Navigatoria, Star of Arcady, Yilduz, Mismar, Polyarnaya.

*''Distance from Sol:'' 431 ly, 132 pc
*''Type of System:'' Binary
*''Color:'' F7-Yellow Giant, F3-Yellow Main Sequence
*''Right Ascension:'' 2h 31m 48.704s
*''Declination:'' +89° 15' 50.72"

==Known Planets==
*[[Neo-Terra]] - Mention is made of a new homeworld for the Terrans in Polaris, envisioned by Admiral Bosch as Neo-Terra, thus a (presumably habitable) planet must be present here. No mention of its current name is given

==Important Events==
*2366: [[Admiral Bosch]] leads a violent military coup and seizes control of Polaris, giving rise to the [[Neo-Terran Front]].

==Jump Nodes==
*[[Epsilon Pegasi]]
*[[Regulus]]

[[Category:Stars and Planets]]

Mirfak

2016-03-24T02:43:17Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Persei, Perseus. It comes from the Arabic word for ''Elbow'' from the Arabic Marfiķ al Thurayya,
*''Other name(s) and meaning:'' Mirphak, Marfak, Mirzac(all with the same meaning as Mirfak), Algenib, Algeneb, Elgenab, Gęnib, Chenib or Alchemb(all coming from the Arabic الجنب al-janb, or الجانب al-jānib, meaning ''the flank'' or ''side''), Hinali'i(Hawaiian name).

*''Distance from Sol:'' 600 ly, 184 pc
*''Type of System:'' Singular
*''Color:'' F-Yellow Supergiant
*''Right Ascension:'' 3h 24m 19s
*''Declination:'' +49° 51' 40"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Epsilon Pegasi]]
*Unknown System

[[Category:Stars and Planets]]

Luyten 726-8

2016-03-24T02:42:49Z

Yarn: Removed a garbage character

===Celestial Information===
*''Distance from Sol:'' 8.554 lyrs, 2.632 par
*''Type of System:'' Binary
*''Binary Separation:'' 2.1-8.8 AU
*''Color:'' M5.5e-Red Dwarf, M6e-Red Dwarf
*''Right Ascension:'' 1h 36m 25s
*''Declination:'' -18° 12' 42"

===Important Events===
*Became headquarters of the [[Luyten New Alliance]] after the collapse of the [[Galactic Terran Alliance]].

===Jump Nodes===
*[[Barnard's Star]]
*[[Laramis]]
*[[Wolf 359]]

Though this is a double-star system, only the primary star is indicated on [[Official Volition Node Map|the Official Volition Node Map]].

===Notes===
* Both stars are flare-variant red dwarfs. Therefore it is likely that, even if any planets lay within their narrow habitable zone, any colonies would need significant radiation shielding to protect themselves from the flares.

* Because the system is binary, and the stars come as close as about 2.1 AU to one another, no stable orbits exist past about half an AU from each star. Stable orbits are possible farther out, but not likely given the rather eccentric path of the stars themselves.

* According to the [[GTM MX-64|Rockeye]] tech description, [[Corporations#STX Exploration|STX Exploration]] has mining facilities in this system.

[[Category:Stars and Planets]]

Lupus Nebula

2016-03-24T02:42:14Z

Yarn: Removed some garbage characters

{{non-canon}}
===Celestial Information===
*''Distance from Sol:'' 7,100 ± 280 light-years
*''Type of System:'' Nebula
*''Color:'' Unknown
*''Right Ascension:'' 15h 02m 50s
*''Declination:'' -41° 56'

The '''Lupus Nebula''' is one of two primary real-world candidates for the [[Nebula System]]. The other is the [[Crab Nebula]]. For more information, see [[Nebula System#Identity of the Nebula System|Identity of the Nebula System]].

[[Category:Stars and Planets]]

Gamma Draconis

2016-03-24T02:41:22Z

Yarn: Removed a garbage character

[[Image:gammadrax.PNG|right|490px|thumb|The GTSC Erikson's findings.]]

===Celestial Information===
*''Name, meaning and Constellation:'' Gamma Draconis, Draco.
*''Other name(s) and meaning:'' Etamin, Etanin, Eltanin, Ettanin (all there Arabic names stand for ''Heart of the Dragon''), Rastaban, Rasaben (now used for Beta Draconis. All these names maintain a meaning connected to the words ''dragon'' and ''serpent''), Zenith star.

*''Distance from Sol:'' 101 lyrs, 31 par
*''Type of System:'' Singular
*''Color:'' K5-Orange Giant
*''Right Ascension:'' 17h 56m 36.4s
*''Declination:'' +51° 29' 20"

===Important Events===
*2352: The GTSC ''Erikson'' briefly surveys Gamma Draconis and finds nothing of interest.
*2367: The NTC ''Trinity'', under the orders of Admiral Bosch, activates the [[Knossos]] portal and enters the nebula beyond.
*2367: [[Shivans]] enter Gamma Draconis, beginning the [[Second Shivan Incursion]].
*2367: Admiral Bosch, aboard the [[NTF Iceni|NTF ''Iceni'']], escapes into the nebula, along with the NTC ''Alexandria'' and NTT ''Grall'', as the [[Neo-Terran Front]] comes to an end.
*2367: The [[Galactic Terran-Vasudan Alliance]] destroys the [[Knossos]] to prevent the [[SJ Sathanas|SJ ''Sathanas'']] from entering Allied space. The attempt is ultimately unsuccessful.

===Jump Nodes===
*[[Capella]]
*[[Nebula System]] (via [[Knossos]])

===Notes===
* Gamma Draconis is also known by its proper name, Eltanin, though it is never referred to as such in the game.
* In the FreeSpace continuity, there are no planets, moons, or other stellar bodies in the Gamma Draconis system whatsoever. It is possible that another previous close encounter with another system stripped it of its circumstellar material, but no canon information on this is given.
* Amusingly, one HLP member has noticed that an anagram of "Gamma Draconis" is "Armada's Coming." ([http://www.hard-light.net/forums/index.php/topic,18458.msg356457.html#msg356457])

[[Category:Stars and Planets]]

Epsilon Pegasi

2016-03-24T02:41:05Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Epsilon Pegasi, Pegasus.
*''Other name(s) and meaning:'' Enif (derived from the Arabic word for ''nose'').
*''Distance from Sol:'' 522 ly, 160 pc
*''Type of System:'' Singular
*''Color:'' K2-Red Dwarf
*''Right Ascension:'' 21h 44m 11.2s
*''Declination:'' +09° 52' 30"

===Known Planets===
*Epsilon Pegasi b [[File:Epsilon Pegasi b.png|frame|right|Planet Epsilon Pegasi b]]

===Important Events===
*2367: The [[GTVA Colossus|GTVA ''Colossus'']] rescues [[Enif Station]] from attack on its first combat deployment. ([[The Sixth Wonder]])
*2367: The ''Colossus'' destroys the NTD ''Repulse'', killing Rear Admiral Koth and marking the beginning of the end for the [[Neo-Terran Front]].

===Jump Nodes===
*[[Adhara]]
*[[Capella]] (collapsed in 2367)
*[[Mirfak]]
*[[Polaris]]

[[Category:Stars and Planets]]

Dubhe

2016-03-24T02:40:45Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Ursae Majoris, Ursa Major. The name comes from the Arabic for ''bear'', dubb, from the phrase ظهر الدب الاكبر‎ żahr ad-dubb al-akbar ''the back of the Greater Bear''.

*''Other name(s) and meaning:'' Dubb, Alruccabah (Arabic names), 北斗一 and 天樞 (Chinese for ''the First Star of the Northern Dipper'' and ''the Celestial Pivot'', respectively).

*''Distance from Sol:'' 123.6 ly
*''Type of System:'' Singular
*''Color:'' K0-Red Giant
*''Right Ascension:'' 11h 03m 43.7s
*''Declination:'' +61° 45' 03"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Alphard]]
*[[Barnard's Star]]
*Unknown System

[[Category:Stars and Planets]]

Deneb

2016-03-24T02:40:27Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Cygni, Cygnus. The name "Deneb" is derived from dheneb, the Arabic word for ''tail'', from the phrase ذنب الدجاجة ḏanab ad-dajājah, or ''tail of the hen''.
*''Other name(s) and meaning:'' Arided, Aridif, Gallina, Arrioph (derived from Aridf and Al Ridf, ''the hindmost''), Os Rosae (Latin for ''mouth/beak/face/head of the rose'', Rosemund (German name), Uropygium (''the parson's nose''), 天津四 (Chinese for ''the Fourth Star of the Celestial Ford'').

*''Distance from Sol:'' 1600 ly, 491 pc
*''Type of System:'' Singular
*''Color:'' A2-White Super Giant
*''Right Ascension:'' 20h 41m 25.917s
*''Declination:'' +45° 16' 49.31"

===Known planets===
*''[[Cygnus Prime]]'' - Inhabited planet
*''[[Deneb II]]''
*''[[Deneb III]]'' - patrolled by the ''Bastion'' during [[Enter the Dragon]]
*''[[Deneb e]]'' - appears in [[The Romans Blunder]]

===Important Events===
*2335: The GTD ''Galatea'' is destroyed by the ''[[SD Lucifer|Lucifer]]''.
*2335: The first [[Battle of Deneb (2335)|Battle of Deneb]] occurs between the ''Lucifer'' fleet and a joint Terran-Vasudan force.
*2335: The SD ''Lucifer'' travels to [[Vasuda]] through subspace from Deneb and launches a devastating surprise attack. Following thirteen hours of bombardment, Vasuda Prime is rendered uninhabitable.
*2367: Second [[Battle of Deneb (2367)|Battle of Deneb]] occurs over a period of at least 72 hours as the GTVA and the NTF fight for control of the system. The [[NTF Iceni|NTF ''Iceni'']] escapes the fighting and flees to Sirius after Bosch's [[NTF Boadicea]] base is discovered and destroyed.

===Jump Nodes===
*[[Alpha Centauri]] ([[Node Inconsistencies#Hearsay|Hearsay]])
*[[Altair]] ([[Node Inconsistencies#Pseudocanon|Pseudocanon]])
*[[Sirius]]
*[[Sol]] ([[Node Inconsistencies#CBAnim|CBAnim]] - presumed collapsed in 2335)
*[[Vasuda]]
*[[Vega]]

[[Category:Stars and Planets]]

Delta Serpentis

2016-03-24T02:39:58Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Delta Serpentis, Serpens.
*''Other name(s) and meaning:'' Qin or Chin (from the Mandarin 秦朝, Qín Cháo, a reference to the Qin Dinasty), it's also the Sixth Star of Right Wall of Heavenly Market Enclosure (天市右垣六 in Mandarin) in Chinese constellations.

*''Distance from Sol:'' 210 ly, 64.4 pc
*''Type of System:'' Binary
*''Color:'' F0-White Subgiant, F0-White Subgiant
*''Binary Separation:'' 375 AU on average
*''Right Ascension:'' 15h 34m 48s
*''Declination:'' +10° 32' 21"

===Important Events===
*March 2335: The destruction of the ''[[SD Lucifer|Lucifer]]'' whilst it is in subspace destabilizes the jump node to [[Sol]], cutting off all communication with the [[Terrans|Terran]] homeworld.
*2335: Delta Serpentis becomes the new capital for the remainder of the [[Galactic Terran Alliance]]. Contact with Sol not re-established as of 2367.

===Jump Nodes===
*[[Beta Aquilae]]
*[[Ross 128]]
*[[Sirius]] ([[Node Inconsistencies#Pseudocanon|Pseudocanon]])
*[[Sol]] (collapsed in 2335)

[[Category:Stars and Planets]]

Capella

2016-03-24T02:39:02Z

Yarn: Removed a garbage character

[[File:Capella1.PNG|right|thumb|400px|The planets of the Capella system.]]
[[File:Capella2.PNG|right|thumb|400px|An analysis of the subspace anomaly that destroyed the Capella star.]]

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Aurigae, Auriga. "Capella" is Latin for "female goat". It's a reference to Amalthea, the goat that ensured Zeus's survival. "Capella" was also the ''cognomen'' of a Roman ''gens''.
*''Other name(s) and meaning:'' Alhajoth, Purra (Australian aboriginal name), al-'Ayyuq العيوق Alhajoth (Arabic name meaning ''Goat''), Brahmahridaya (Hindu name meaning ''Heart of Brahma''), Bozbān بزبان and Negahbān نگهبان (Persian names which mean ''goat-keeper'' and ''guard'', respectively), Colca (Inca name), Hircus (another Latin name, meaning ''goat''), Hokulei (Hawaiian for ''Star-Wreath''), 五车二 Wǔjū'èr (Chinese for ''the Second Star of the Five Chariots'').

*''Distance from Sol:'' 42.2 lyrs, 12.9 par
*''Type of System:'' Binary
*''Color:'' G8 III / G0 III
*''Right Ascension:'' 5h 16m 41.353s
*''Declination:'' +45° 59' 52.9"

===Important Events===
*2367: A ''[[SC Rakshasa|Rakshasa]]'' cruiser and a wing of ''[[SF Mara|Mara]]'' fighters destroy the GTC ''Vigilant'', marking the beginning of the [[Second Shivan Incursion]].
*2367: The [[GTVA Colossus|GTVA ''Colossus'']] destroys the first [[SJ Sathanas|''Sathanas'' juggernaut]].
*2367: ''Sathanas'' juggernauts, by means unknown, cause the Capella star to go supernova.

===Jump Nodes===
*[[Epsilon Pegasi]] (collapsed in 2367)
*[[Gamma Draconis]]
*[[Vega]] (collapsed in 2367)

===Notes===
*In [[FreeSpace 2]], this is the home star of the [[GTVA]] 3rd Fleet, of which the player is a pilot.

[[Category:Stars and Planets]]

Betelgeuse

2016-03-24T02:38:14Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Alpha Orionis, Orion. The name "Betelgeuse" is the result of the corruption of the Arabic ''yad al-jawzā'', "hand of the central zone".
*''Other name(s) and meaning:'' Beteigeuze (same meaning as Betelgeuse), Al Dhira (''The Arm''), Al Mankib (''The Shoulder''), Al Yad al Yamma (''The Right Hand''), Ardra (Hindi name), Bahu (Sanskrit name), Bašn (Persian name, means ''the Arm''), Gula (Euphratean name), Ied Algeuze (''Orion's Hand''), Klaria (Coptic name, means ''an Armlet'') Yedelgeuse, Shēnsùsì (Chinese name, means ''the Fourth Star of the Constellation of Three Stars'').

*''Distance from Sol:'' 427 ly, 131 pc
*''Type of System:'' Singular
*''Color:'' M2-Red Giant
*''Right Ascension:'' 5h 55m 10.37s
*''Declination:'' +7° 24' 25.35"

===Important Events===
*The GTC ''Orff'' comes under attack by Vasudan scout units. ([[Eve of Destruction]])

===Jump Nodes===
*[[Antares]] ([[Node Inconsistencies#Hearsay|Hearsay]])
*[[Beta Cygni]]
*[[Ribos]] ([[Node Inconsistencies#CBAnim|CBAnim]])

[[Category:Stars and Planets]]

Beta Cygni

2016-03-24T02:37:41Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Beta Cygni, Cygnus. The name of the star was originally Minqār al-Dajājah, ''the hen's beak'' as in Arabic texts.
*''Other name(s) and meaning:'' Albireo (this name is the result of a few misunderstandings of the original Arabic form since Latin scholars thought that the name came from a kind of herb, and translated it into ab ireo (''from ireus''). Later this was treated as a misprint of an Arabic term and transcribed as al-bireo.

*''Distance from Sol:'' 391 ly, 120 pc
*''Type of System:'' Binary
*''Color:'' K3-Red Giant, B9.5-Blue Main Sequence
*''Right Ascension:'' 19h 30m 43.3s
*''Declination:'' +27° 57' 35"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Antares]]
*[[Betelgeuse]]
*[[Ikeya]] ([[Node Inconsistencies#Pseudocanon|Pseudocanon]])
*[[Ribos]] ([[Node Inconsistencies#Pseudocanon|Pseudocanon]])

[[Category:Stars and Planets]]

Beta Aquilae

2016-03-24T02:37:09Z

Yarn: Removed a garbage character

===Celestial Information===
*''Name, meaning and Constellation:'' Beta Aquilae, Aquila. The name comes from the Arabic term الشاهين aš-šāhīn ''the (peregrine) falcon''. This pseudo-Arabic name is derived from the Persian Šāhīn tarāzū (or possibly Šāhīn tara zed).
*''Other name(s) and meaning:'' Alschairn, Alshain

*''Distance from Sol:'' 44.7 ly, 13.7 pc
*''Type of System:'' Binary
*''Color:'' G8-Yellow Subgiant, M3-Red Dwarf
*''Right Ascension:'' 19h 55m 18.799s
*''Declination:'' +6° 24' 24.29"

===Important Events===
*2335: The [[GTD Hades|GTD ''Hades'']] is destroyed, ending the [[Hades Rebellion]].
*The Beta Aquilae Convention, or [[Beta Aquilae Convention|BETAC]], is signed by representatives of the [[Vasudans|Vasudan]] and [[Terrans|Terran]] governments in 2358
*With the ratification of BETAC, Beta Aquilae becomes the new capital of the [[Galactic Terran-Vasudan Alliance]] and the GTVA Security Council (see [[Briefing_texts_%28FS2%29#Into_the_Maelstrom|Debriefing 6 of Into the Maelstrom]] ).

===Jump Nodes===
*[[Antares]]
*[[Delta Serpentis]]
*[[Sol]] ([[Node Inconsistencies#CBAnim|CBAnim]] - presumed collapsed in 2335)
*[[Vasuda]] ([[Node Inconsistencies#Implied|Implied]])
*[[Vega]]

[[Category:Stars and Planets]]

Barnard's Star

2016-03-24T02:36:23Z

Yarn: Removed a garbage character and fixed a spelling error

===Celestial Information===
*''Distance from Sol:'' 5.941 lyrs, 1.821 par
*''Type of System:'' Singular
*''Color:'' M4-Red Dwarf
*''Right Ascension:'' 17h 57m 48.515s
*''Declination:'' +4° 41' 35.83"

===Important Events===
*To be filled in later.

===Jump Nodes===
*[[Dubhe]]
*[[Luyten 726-8]]

[[Category:Stars and Planets]]

Mod.ini

2016-03-23T03:10:00Z

Yarn: Changed Google Code link to the backup on archive.org since the original page is now gone

:(Copied from the mod.ini documentation on wxLauncher's old Google Code wiki ([https://web.archive.org/web/20150118024053/http://code.google.com/p/wxlauncher/wiki/ModIniOptions https://code.google.com/p/wxlauncher/wiki/ModIniOptions]) with modifications)

This page describes all of the mod.ini options available to mod/[[Total conversions|total conversion (TC)]] authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.ini#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.ini#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have an image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have an image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

==See also==
[[Mod.ini_(old)|Old mod.ini documentation]]

Capture Missions

2016-03-16T08:01:37Z

Yarn: Corrected spelling and hyphenation

Often, during the course of your campaign, it may become neccesary to capture, rather than destroy, an enemy vessel. Missions involving this tactic can be referred to as '''capture missions'''. Examples of this type of mission would be [[Enter the Dragon]] and [[First Strike]] in FreeSpace 1, with First Strike more typical of the way this mission type is often encountered in user-made campaigns.

==FREDding a Capture Mission==

Capture missions can be quite difficult to make and fully test, largely because of the design of the FreeSpace AI, which is geared towards destroying things, rather than simply damaging them enough to capture. Moreover, making a coherent and realistic plot for these missions is also potentially difficult. When FREDding, bear the following suggestions in mind: 
*Decide early on exactly how much resistance the vessel you are capturing will put up, and how much you want the player to do to make the area safe for any capturing vessels. [[Shivans|Shivan]] ships, for example, will need to be entirely disabled and disarmed before they can be captured, whereas civilian ships may give up after simply losing their engines. Read [[Disarming ships|this]] article for additional hints.

*The next major problem you will face is the FreeSpace AI. Just ordering them to disable and/or disarm a ship is not enough. You must then remind them that the vessel is now off limits as far as attacking is concerned. There are several ways to accomplish this: 
**Adding Ignore Ship AI to friendly fighters - This will work, but must be added to all ships in the field of battle to be effective.
**Protecting the disabled Ship - This has the same effect as the ignore AI directives, with much less intensive SEXPing.
**Changing the IFF of the disabled ship - This will work, but is not recommended, as it implies that the ship has become friendly, rather than simply having been subdued. Moreover, this will cause any hostile fighters that may warp in to protect it to regard it as an enemy (though this may be beneficial if, for example, they would rather destroy the ship than see its crew fall into enemy hands). Volition used this method.
*Just as your wingmen will continue attacking a disabled ship, so will that ship keep attacking your wingmen if you do not order it not to. If you're not changing its AI to friendly, remember to lock all the turrets and beams of a surrendering ship.
*Use the escort list wisely, and remember that any vessels doing the capturing should be placed on this list. Lack of escorted vessels is a classic sign of less than stellar mission, and should be avoided.
*Weapons and engines are not the only subsystems of relevance to a captured ship. An intact communications subsystem may allow a vessel to call for reinforcements, while a destroyed navigation subsytem may prevent a ship from jumping to subspace even when its engines are still intact. Use these non-core subsystems in your missions, but be aware of the amount of damage you're doing to a ship. Smaller vessels may take considerable damage if you destroy multiple subsystems and turrets, potentially risking their unintentional destruction by the player.
*Ensure the capture transport sends messages often, keeping the pilots updated about the status of the capture operation.
*The capture transport will make a tempting target for hostile fighters, and its protection should be a goal for the player. Make sure that you have contingencies in place should this first attempt at capturing fail, whether that be sending more transports, or declaring the mission a failure. This may be grounds to trigger an order to destroy the disabled vessel, rather than allow the enemy to reclaim and repair it.
*Be sensible in your choice of capture vessel. While a [[GTS Hygeia|GTS ''Hygeia'']] is perfectly appropriate for capturing a disabled enemy fighter, it almost certainly will not be able to deploy enough troops to subdue the crew of a destroyer.
*Keep in mind the potential for multiple points of entry on disabled vessels. Many ships have multiple dockpoints which can now be accessed thanks to the Source Code Project's multidocking code, and larger vessels may be able to be infiltrated through their fighterbays.
*Keep in mind that a disabled vessel should not warp under its own power unless its engines are repaired, and while a docked vessel can warp out and take the captured vessel with it, this should, ideally, only occur between vessels of comparable size.
*'''Note that non-friendly fighters that are part of a wing and that have been disabled ''or'' disarmed will self-destruct after a short period of time.''' This is intentional behavior but can be surprising and frustrating for FREDders trying to create a capture mission for an enemy wingman. To avoid this behavior, set the ship to friendly after it is disabled, or remove it from the wing. Note that Arjuna 1 in [[Enter the Dragon]] was not part of a wing.

[[Category:FRED Tips]]

Hud gauges.tbl

2016-02-10T21:03:27Z

Yarn: Added documentation for $Force Scaling Above:

{{SCP table}}

{{TableVersionGit|2016-02-07|0ed147f}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD.

*Syntax: '''Integer''' font index number
*Valid Values: Any font index as defined in [[Fonts.tbl]]

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Force Scaling Above:===
{{Table373|
Optional. If gauge scaling is disabled, then gauges will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

*Syntax: ('''Integer''' width, '''Integer''' height)
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs an animation with one frame)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional) (needs an animation with one frame)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs an animation with one frame)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 4 frames, 3rd is without auto-match-speed enabled, 4th is with... and frames 0 & 1 are not used, done this way because retail fs2 uses the same animation file for the auto speed & auto targeting gauges)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (needs an animation with a single frame)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional) (needs animation with one frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Alt Ballistic Filename:|Alt Ballistic Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (animation needs 8 frames; 0->3 are the top, right, bottom & left shield quads; 4->7 are the same except brighter for when the quad is flashing from being hit)
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional) (needs animation with a single frame)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 1 frame)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Offsets:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Dock Offsets:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, only the 2nd frame is used)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs animation with 2 frames, the 1st is the bar lit for zero energy, the 2nd is the bar lit for max energy)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy. Note that it only supports a vertical fill.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with 4 frames, the 3rd is the bar lit for zero energy, the 2nd is the bar lit for max energy, frames 1 & 2 are not used)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that is used to raise the probability of hitting a target with primary weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that indicates where your shots will end up, as opposed to Lead Indicator that indicates where you have to shoot at to hit your target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
}}
{{table373|
:[[Hud_gauges.tbl#Force Scaling Above:|Force Scaling Above:]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional) (needs an animation with a single frame)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional) (needs animation with a single frame)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Force Scaling Above:====

{{Table373|
Optional. If scaling is disabled for this gauge, then it will be scaled as though the base resolution were this resolution or the real base resolution, whichever is greater.

Use this to disable scaling at lower resolutions while preventing gauges from getting too small at higher resolutions.

To disable this feature, use '''(-1, -1)'''.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: ('''Integer''' width, '''Integer''' height)

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left side of gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====First Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right side of the gauge.

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Last Background Filename:====
Optional. Alias for [[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]]

====Entry Background Filename:====
Optional. Designates which file to use for the (Wing) Entry section of the gauge (aka the middle sections).

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Alt Ballistic Filename:====
Optional. Designates an alternate file to be used for ballistic weapons in place of Primary/Secondary Top/Middle/Bottom files.

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Afterburner Energy:|+Afterburner Energy:]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames (but only the 2nd frame is used ?!?!? for threat & weapon linking so far)

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active.

Internally FSO also refers to this as the "laser threat warning".

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Needs to be an [[Multimedia_Files#ANI|ani]] with a least 2 frames. The 1st frame is "no warning", the rest of the frames are cycled through when a warning is active. Frames cycle twice as fast when a lock has been acquired, compared to when a lock is being acquired.

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected (not that this should ever be able to happen), 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====

Designates the file to use for primary linking for ships with two primary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames:
* Frame 0 is no banks selected
* Frame 1 is 1st bank selected
* Frame 2 is 2nd bank selected
* Frame 3 is both banks selected/linked

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====

Designates the file to use for selected secondary bank for ships with a single secondary bank.

Needs to be an [[Multimedia_Files#ANI|ani]] with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====

Designates the file to use for selected secondary bank for ships with two secondary banks.

Needs to be an [[Multimedia_Files#ANI|ani]] with 4 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected, 4th is bank 3 selected.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

[[Category:Tables]]

Mod.ini

2016-01-06T05:39:31Z

Yarn:

:(Copied from the mod.ini documentation on wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) with modifications)

This page describes all of the mod.ini options available to mod/[[Total conversions|total conversion (TC)]] authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.ini#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.ini#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have an image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have an image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

==See also==
[[Mod.ini_(old)|Old mod.ini documentation]]

Mod.ini

2016-01-06T05:37:12Z

Yarn: /* [skin] (TCs only) */

:(Copied from the mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) with modifications)

This page describes all of the mod.ini options available to mod/[[Total conversions|total conversion (TC)]] authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.ini#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.ini#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have an image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have an image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

==See also==
[[Mod.ini_(old)|Old mod.ini documentation]]

Mod.ini

2016-01-06T05:36:06Z

Yarn:

:(Copied from the mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) with modifications)

This page describes all of the mod.ini options available to mod/[[Total conversions|total conversion (TC)]] authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.ini#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.ini#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have a image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have a image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

==See also==
[[Mod.ini_(old)|Old mod.ini documentation]]

Mod.ini

2016-01-06T04:25:04Z

Yarn:

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

This page describes all of the mod.ini options available to mod/TC authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.ini#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.ini#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have a image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have a image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

Mod.ini

2016-01-06T04:03:59Z

Yarn:

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

This page describes all of the mod.ini options available to mod/TC authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.tbl#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.tbl#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===
<pre>
[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = Welcome to wxLauncher ... 
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

The skin section is where you can change the launcher's appearance. You can alter several visual elements (window title bar text, window icon, etc) without having to distribute a custom-built launcher. You can also choose to specify only part of the skin. Any parts that you don't specify will be provided by the default launcher skin. '''Only TCs can skin the launcher.'''

====windowtitle====
The text in the title bar of the launcher window. Use only letters and numbers if possible. There is no official character limit, but keep the text to a reasonable size. Since this is a window title bar, all formatting will be ignored.

====windowicon====
Launcher's window icon. Must be in Windows icon (ICO) format. '''Note:''' Skinning the window icon is currently not supported on OS X.

====banner====
The welcome page banner. Must be in PNG format. Recommended size is 600x150, with maximum width of 630 pixels and required height of 150 pixels. Will be centered in the welcome page.

====welcometext====
The text found on the welcome page. Can contain basic HTML tags (such as <tt> <ul<<a><ol><emphasis></tt>) -- see [http://docs.wxwidgets.org/2.8/wx_wxhtml.html#htmltagssupported the wxWidgets wiki] for a complete list.

====modimage255x112====
The image that is shown in the mod info dialog when a particular mod doesn't have a image defined. Must have the same resolution as the ordinary mod image (255x112).

====modimage182x80====
The image that is shown in the mod list when a particular mod doesn't have a image defined. Must have the same resolution as the mod list-sized image (182x80). If this image is not provided, it will be generated automatically by scaling down the <tt>modimage255x112</tt> image, if it is provided.

====iconok====
Icon used in the status bar to indicate that a operation (like news retrieval) succeeded. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarn====
Icon used in the status bar to indicate that a non-critical operation (like news retrieval) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconwarnbig====
Icon used in the modinfo window to indicate that the note specified by the mod author is important and must be read. Must be in PNG format. Must be 64x64 pixels in size.

====iconerror====
Icon used in the status bar to indicate that a critical operation (like launching the game) failed. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfo====
Icon used in the status bar to indicate various miscellaneous details. Must be in PNG format. Must be 24x24 pixels in size.

====iconinfobig====
Icon used in the mods page to bring attention to information there. Must be in PNG format. Must be 64x64 pixels in size.

====iconhelp====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 32x32 pixels in size.

====iconhelpbig====
Icon used when asking the player for network access for retrieving the news. Must be in PNG format. Must be 64x64 pixels in size.

====iconideal====
Icon that is currently not used but may eventually be used to mark recommended flags. Must be in PNG format. Must be 24x24 pixels in size.

====newssource====
The name of the source that wxLauncher should get its news from. Current supported values are <tt>hlp</tt> and <tt>diaspora</tt>, with unrecognized values resulting in the default value <tt>hlp</tt> being selected. More values will be added as more TCs ship with wxLauncher.

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

Mod.ini

2016-01-04T09:44:38Z

Yarn:

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

This page describes all of the mod.ini options available to mod/TC authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.tbl#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file ''must'' be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (<tt>/</tt>), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a <tt>#</tt> character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.tbl#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of <tt>1</tt> (a one, not a lowercase L) if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===

====windowtitle====

====windowicon====

====banner====

====welcometext====

====modimage255x112====

====modimage182x80====

====iconok====

====iconwarn====

====iconwarnbig====

====iconerror====

====iconinfo====

====iconinfobig====

====iconhelp====

====iconhelpbig====

====iconideal====

====newssource====

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

Mod.ini

2016-01-04T08:45:12Z

Yarn: /* [recommendedlighting] */

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

This page describes all of the mod.ini options available to mod/TC authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.tbl#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file must be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (/), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a # character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.tbl#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of 1 if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===
<pre>
[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 75 ... -ogl_spec 60
</pre>

This section allows you to provide a recommended selection of [[Command-Line_Reference#Lighting|lighting settings]] for the player. ''This will replace the "Baseline recommended" entry in the lighting presets GUI.'' These settings are ''not'' graphics settings. They are just the knobs for adjusting the level of ambient light, how shiny ships are, and the like.

====name====
The name that wxLauncher will use to label these settings in the GUI. Limited to 32 characters.

====flagset====
The flags to be set.

===[skin] (TCs only)===

====windowtitle====

====windowicon====

====banner====

====welcometext====

====modimage255x112====

====modimage182x80====

====iconok====

====iconwarn====

====iconwarnbig====

====iconerror====

====iconinfo====

====iconinfobig====

====iconhelp====

====iconhelpbig====

====iconideal====

====newssource====

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

Mod.ini

2016-01-04T08:42:56Z

Yarn: /* [multimod] */

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

This page describes all of the mod.ini options available to mod/TC authors. Most options are available to both mods and TCs, with the exception that '''the skin feature is available to TCs only'''.

==Introduction==
First, take a look at the [[Mod.tbl#Complete_mod.ini_sample|complete mod.ini sample]] to get a sense of the new mod.ini format's capabilities.

About the old format, there are two important points:

*'''ALL of the mod.ini settings are OPTIONAL.''' The only requirement is that the mod.ini file must be present, even if it is blank.
*'''This format is 100% compatible with the old mod.ini format.''' Therefore, you can use your existing mod without any changes, as long as the mod has a mod.ini file in its mod folder.

==General notes==
There are several details that should be considered when creating a mod.ini:

*Resource files specified in the mod.ini do not have to be placed in the same folder as the mod.ini itself. They can be in a subfolder instead. Thus you can have a "resources" subfolder in your mod and place all the files there so that they don't clutter your main folder. Separate folders must be specified in the mod.ini using a forward slash (/), as in <tt>resources/my_image.png</tt>.
*You can add comments to your file by starting lines with a # character. Those lines will be ignored by the launcher when it reads your mod.ini.
*No labels should be left without a value. In other words, all lines in the mod.ini that are not comments or section headers (such as <tt>[launcher]</tt>) should follow the format <tt>label = value</tt>.
*Edit your file with a syntax-highlighting capable text editor, such as [http://www.notepad-plus-plus.org/ Notepad++] (Windows), [http://www.barebones.com/products/textwrangler/ TextWrangler] or [http://aquamacs.org/ Aquamacs] (OS X), or [http://www.scintilla.org/ Scintilla] or [http://www.vim.org/ Gvim/Vim] (Linux).

==Common sense (aka TLDR)==
As noted before, all of the options in the mod.ini are optional. However, as a courtesy for the players, you should include at the very least:

*Mod name (<tt>modname</tt>)
*Your name (<tt>author</tt>)
*Mod description (<tt>infotext</tt>)
*If your mod depends on any mods, list those (<tt>secondarylist</tt>)

To make things easy, you can copy this [[Mod.ini#Basic_mod.ini_sample|basic mod.ini]] file, fill it in, and include it with your mod. It asks for exactly these pieces of information.

==Sections==

This guide follows the mod.ini sections in the order they appear in the [[Mod.tbl#Complete_mod.ini_sample|sample mod.ini]]. To make the examples fit better, long lines are abbreviated using ellipses (...).

As stated in the sample mod.ini, this example deals with a fictional mod named "The Descent" for [http://babylon.hard-light.net/ The Babylon Project].

===[launcher]===
<pre>
[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence ... towards Earth.
author = kkmic
notes = You'll need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com
</pre>

This section is an expanded version of the old mod.ini. It allows you to define basic details about your mod.

====modname====
Your "fancy" mod name. There is no length limit, although you should keep it below 50 characters, including spaces. This is the name that will appear in the launcher to identify your mod to the player.

====image255x112====
The image that defines your mod. Must be 255x112 pixels. Although you can use any of BMP, PNG, or GIF formats, you should use BMP if you want to keep your mod compatible with the Windows launcher. If you don't specify an image, the current skin's [[Mod.ini#modimage255x112|modimage255x112]] will be used instead.

====image182x80====
The image that is shown on the mod list. Use it if you don't like the way the launcher shrinks your big image or if you want to emphasize some detail from it. Try not to confuse the user with two totally different images, though.

====infotext====
Introductory text for your mod. Summary. Teaser. Use your imagination.

'''Note:''' All of the text must be written on a single line in the mod.ini file. However, if you want to have a line break in the text (that is, text on a new line) write "\n" (without the quotes) -- see the sample for an example. Also note that the Windows launcher does not support this and will just print the "\n" as they are.

====author====
Your name. Or your team's name. People who play your mod should know whose hard work gives them joy. Or an agonizing death. Depending on your modding skills.

====notes====
Notes regarding your mod. Technical details. Acknowledgements. You name them. Again, must be one line. See [[Mod.ini#infotext|infotext]] for details.

====warn====
Give this a value of 1 if your [[Mod.ini#notes|notes]] are of critical importance to the player.

The effect: a warning sign appears besides your mod once selected and also in the mod detail window beside the note itself.

====website====
Your mod's mighty homepage.

====forum====
A link to a dedicated forum/forum section for your mod. If not specified, the [http://www.hard-light.net/forums/index.php?board=124.0 Missions and Campaigns forum] is used.

====bugs====
This is where the players should report bugs in your mod. Might be a dedicated bug tracker or a simple forum/forum section.

====support====
A link to the forum/forum section for support of your mod.

===[resolution]===
<pre>
[resolution]
minhorizontalres = 1024
minverticalres = 768
</pre>

This section allows you to specify a minimum resolution for your mod. All resolutions smaller than the one you specify will not appear in the Basic Settings page's "Resolution" drop down box. This section is useful in cases such as when your mod doesn't have low-res interface art.

'''Caution:''' Be extra-careful with typos when using this section. If you accidentally specify a super-high resolution (say, 1024x7680), then players will be unable to play your mod.

====minhorizontalres====
The minimum horizontal resolution supported by your mod. Default value is 640.

====minverticalres====
The minimum vertical resolution supported by your mod. Default value is 480.

===[multimod]===
<pre>
[multimod]
primarylist = ;
secondarylist = zathras;
</pre>

This section lists additional mods that need to be loaded for your mod to work properly.

====primarylist/secondarylist====

Contains mods listed by their folder name.

The mods listed in these values will be added to the [[Command-Line_Reference#-mod|-mod]] command line option for the FS2 Open engine and FRED2 Open editor.

To construct the <tt>-mod</tt> option, the the current mod's folder name is appended to the mods in the primary mod list, which then has the secondary mod list appended to it, resulting in <tt>primarylist, folder name, secondarylist</tt>.

'''Note:''' <tt>secondrylist</tt> can be used in place of <tt>secondarylist</tt> because of a bug in the original Windows launcher. However, it is deprecated and should not be used. It is provided for compatibility purposes only.

===[recommendedlighting]===

====name====

====flagset====

===[skin] (TCs only)===

====windowtitle====

====windowicon====

====banner====

====welcometext====

====modimage255x112====

====modimage182x80====

====iconok====

====iconwarn====

====iconwarnbig====

====iconerror====

====iconinfo====

====iconinfobig====

====iconhelp====

====iconhelpbig====

====iconideal====

====newssource====

==Samples==

===Basic mod.ini sample===
<pre>
# Just replace the text in <> with information about your mod
# and then put the file in your mod folder.
# For more things you can do with a mod.ini file, see
# <http://www.hard-light.net/wiki/index.php/Mod.ini>

[launcher]
modname = <NameOfYourMod>
infotext = <Describe your mod. You can use \n to add line breaks.>
author = <YourName>

# If your mod requires other mods to run, include this section,
# otherwise remove it.
[multimod]
secondarylist = <ModDependency1>,<ModDependency2>,<etc.>
</pre>

===Complete mod.ini sample===
<pre>
# This is a fully-fledged mod.ini sample using ALL of the options
# available to mod/TC authors. Please visit the mod.ini wiki page
# to learn about what different options do:
# <http://www.hard-light.net/wiki/index.php/Mod.ini>
#
# This sample was created for a fictional mod named "The Descent"
# for the Babylon Project total conversion.

[launcher]
modname = The Descent
image255x112 = skin/logo.png
image182x80 = skin/logo_small.png
infotext = The aging behemoth was floating in silence among the stars. An eternity has passed, and the Astrid was still sleeping in the coldness of space. Without warning, her forward thrusters fired with an eerie glow, sending vibrations throughout the ship. Metal screamed in protest, as more thrusters fired, shaking the solar dust of the hull. \n\nThen it was silence again. \n\nNothing appeared to have changed, yet slowly but surely, the destroyer had begun its descent towards Earth.
author = kkmic
notes = You will need the zathras mod to play this
warn = 1
website = http://www.thedescentmod.com
forum = http://www.forum.thedescentmod.com
bugs = http://www.bugs.thedescentmod.com
support = http://www.support.thedescentmod.com

[resolution]
minhorizontalres = 1024
minverticalres = 768

[recommendedlighting]
name = Descent recommended
flagset = -ambient_factor 90 -spec_exp 0.7 -spec_tube 1.0 -spec_point 0.7 -spec_static 1.0 -ogl_spec 15 -bloom_intensity 20

[multimod]
primarylist = ;
secondarylist = zathras;

[skin]
windowtitle = Astrid CIC
windowicon = skin/astrid.png
banner = skin/welcome_page_banner.png
welcometext = <center>Welcome to wxLauncher, your one-stop-shop for Freespace 2 and related content If you're new to the Freespace 2 universe, you might want to check out these links first: = <a href='http://www.hard-light.net/wiki/index.php/Main_Page'>FS2 Wiki</a> = <a href='http://www.hard-light.net/forums/'>FS2 Forum</a> = <a href='http://en.wikipedia.org/wiki/FreeSpace_2'>Wikipedia FS2 page</a> = <a href='http://scp.indiegames.us/mantis/main_page.php'> Reporting bugs</a> = Also, don't forget the help file, there is a nice 'Getting Started' tutorial there. </center>
modimage255x112 = skin/modimage.png
modimage182x80 = skin/modimage_small.png
iconok = skin/icon_ok.png
iconwarn = skin/icon_warn.png
iconwarnbig = skin/icon_warn_big.png
iconerror = skin/icon_error.png
iconinfo = skin/icon_info.png
iconinfobig = skin/icon_info_big.png
iconhelp = skin/icon_help.png
iconhelpbig = skin/icon_help_big.png
iconideal = skin/icon_ideal.png
newssource = hlp
</pre>

Mod.ini

2016-01-04T08:36:44Z

Yarn: /* [resolution] */

Mod.ini

2016-01-04T08:35:06Z

Yarn: /* [launcher] */

Mod.ini

2016-01-04T08:29:42Z

Yarn: /* Sections */

Mod.ini

2016-01-04T08:27:20Z

Yarn: /* Common sense (aka TLDR) */

Mod.ini

2016-01-04T08:25:11Z

Yarn: /* Common sense (aka TLDR) */

Mod.ini

2016-01-04T08:22:41Z

Yarn: /* General notes */

Mod.ini

2016-01-04T08:12:32Z

Yarn:

Mod.ini

2016-01-04T07:51:48Z

Yarn:

The mod.ini documentation from wxLauncher's old Google Code wiki (https://code.google.com/p/wxlauncher/wiki/ModIniOptions) is currently being ported to this page. For the old mod.ini page, see here: [[mod.ini (old)]]

==Introduction==

==General notes==

==Common sense (aka TLDR)==

==Sections==

===[launcher]===

====modname====

====image255x112====

====image182x80====

====infotext====

====author====

====notes====

====warn====

====website====

====forum====

====bugs====

====support====

===[resolution]===

====minhorizontalres====

====minverticalres====

===[multimod]===

====primarylist/secondarylist====

===[recommendedlighting]===

====name====

====flagset====

===[skin] (TCs only)===

====windowtitle====

====windowicon====

====banner====

====welcometext====

====modimage255x112====

====modimage182x80====

====iconok====

====iconwarn====

====iconwarnbig====

====iconerror====

====iconinfo====

====iconinfobig====

====iconhelp====

====iconhelpbig====

====iconideal====

====newssource====

Mod.ini

2016-01-04T07:13:30Z

Yarn: moved Mod.ini to Mod.ini (old): The current mod.ini documentation on this wiki is outdated and will be replaced with the one from wxLauncher's old Google Code wiki. This page is being renamed to serve as a backup, at least for now.

#REDIRECT [[Mod.ini (old)]]

Mod.ini (old)

2016-01-04T07:13:30Z

==Introduction==
Mod.ini defines the options for a given mod.
The core use for these is to allow a mod to easily use assets from another mod, such as the MediaVPs.

The file must be called "mod.ini" and be in the main folder of the mod.
It must be in ASCII text format (not Unicode) and use Windows-style end-of-line markers.
::: '''''PLEASE NOTE''': '''Launcher v 5.4''' or later, '''must be used'''. Earlier versions had some bugs that would cause this explanation about mod.ini to fail.''

==Sections==
===Launcher===
<pre>[launcher]</pre>
Information about the mod, displayed in the Launcher.

Attributes:
*modname = ''Name of the mod'';
*image255x112 = ''Mod bitmap.bmp'';
*infotext = ''Information about the mod'';
*website = ''URL to the mod's website, if applicable'';
*forum = ''URL to the mod's forum, if applicable'';
*mantis = ''URL to the mod's bugtracker, if applicable '''(no longer supported as of Launcher 5.5)''''';

The mod bitmap is displayed in the Launcher, under the "MOD" tab, when the mod is selected.
===Multimod===
<pre>[multimod]</pre>
Defines other mods that are used at the same time.

Attributes:
*primarylist = ''list of mods'';
**These mods will override assets in the current mod. Primarylist is needed very rarely. Currently only [[Silent Threat: Reborn]] requires the use of primarylist. Multiple mods are separated by commas.
*secondarylist = ''list of mods'';
**These mods will be added to the assets for the current mod, and may be overridden by data in the current mod. Multiple mods are separated by commas.

===Settings===
<pre>[settings]</pre>
Defines other required settings.

Attributes:
*flags = ''list of additional commandline flags '''(no longer supported as of Launcher 5.5)''''';

==Examples==
Below are examples of different mod.inis in various situations.
===MediaVPs 3.6.10===
The mod.ini provided with the MediaVPs doesn't use any other mods, as the MediaVPs are selected as a mod only when the player wants to play the regular FS2 campaign with better graphics. The mod.ini does, however, provide a Launcher image and links to Hard Light Productions.
<pre>
[launcher]
image255x112 = FSU-MVP.bmp;
infotext = Freespace II - 3.6.10 MediaVPs;
website = http://www.hard-light.net/;
forum = http://www.hard-light.net/forums;
mantis = http://www.hard-light.net/mantis;

[multimod]
primarylist = ;
secondarylist = ;
</pre>
===Derelict===
The [[Derelict]] mod.ini contains a reference to the MediaVPs, because many users want to play Derelict, and other mods, with better graphics provided by the MediaVPs. Also, the person who originally created the mod.ini deemed it necessary to include the -spec flag, though most people already have it turned on in their Launchers.
<pre>
[launcher]
image255x112 = Derelict.bmp;
infotext = Five years have passed since the jump node to the Capella system was collapsed...;
website = http://www.3dap.com/hlp/hosted/ce/;
forum = http://dynamic.gamespy.com/~freespace/forums/forumdisplay.php?s=83686deb4fd49b5f670f6d92203b257d&forumid=89;

[multimod]
primarylist = ;
secondarylist = mediavps;

[settings]
flags = -spec;
</pre>

===Cardinal Spear===
[[Cardinal Spear]] is a mod that requires FSPort. Therefore, the secondarylist includes "fsport" in addition to "mediavps".
<pre>
[launcher]
image255x112 = CardinalSpear.bmp;
infotext = In the tenth year of our war against the Vasudans, humanity had attempted one last desperate strike to end the war outright - a spear in the dark. The Cardinal Fleet had been laid ruin, and the crew of the GTD Agamemnon was being hunted by a Vasudan general. It was too late for victory, but not too late for vengeance...;
website = http://fsport.hard-light.net/;
forum = http://www.hard-light.net/forums/index.php/board,39.0.html;

[multimod]
secondarylist = fsport,mediavps;
</pre>

===Silent Threat: Reborn===
Due to some design issues, Silent Threat: Reborn doesn't work correctly with the MediaVPs, if it is designated as the primary mod, with the other mods being of a secondary nature. The FSPort MediaVPs have to be read before ST:R for ST:R to function correctly. Therefore, "fsport-mediavps" is entered into the primarylist line.
<pre>
[launcher]
modname = Silent Threat: Reborn v1.0;
image255x112 = fsport-str.bmp;
infotext = As the Great War rages on, you've been commissioned by Galactic Terran Intelligence for special intelligence operations. Your objectives are to contain the Shivan onslaught and preserve the fragile Terran-Vasudan alliance. But a series of suspicious events cloud the GTI's spotless record. Is the GTI setting you up or are the Shivans spreading their evil rage?;
website = http://fsport.hard-light.net/website/str/;
forum = http://www.hard-light.net/forums/index.php/board,140.0.html;

[multimod]
primarylist = fsport-mediavps;
secondarylist = fsport,mediavps;
</pre>

[[Category:Modding]]

Mod.ini (old)

2016-01-04T06:58:44Z

Yarn:

Hud gauges.tbl

2015-12-10T04:40:51Z

Yarn: Added fields that were implemented recently as well as Ship Name Max Width

{{SCP table}}

{{TableVersionGit|2015-12-09|85a36e6fd8}}

The '''hud_gauges.tbl''' is used for modifying the elements of the HUD. Not all gauges can be modified. However, custom gauges may be added to mimic their behavior (such as the wingman status display).

HUD Elements in FS2 are called Gauges, and each gauge has various options to customize appearance and, in some cases, their behavior as well.

This table is one of the [[Modular Tables]] and can be extended with xxx-hdg.tbm

[[Tables|List of Tables]]

==HUD Configurations==
The following entries are used on the HUD system, but have not been grouped with any particular gauge.

===$Load Retail Configuration:===
Optional. If yes, any gauge missing from the HUD gauge definitions below will be loaded using the retail defaults.

If no, any missing (default) gauge will prompt an error.

*Syntax: '''Boolean'''

===$Color:===
Optional. Sets the default HUD color for all gauges.

*Syntax: ('''Integer''' Red, '''Integer''' Green, '''Integer''' Blue)
*Valid Values: all values from 0 to 255

===$Font:===
Optional. Sets the font type to use for the HUD.

*Syntax: '''Integer''' font index number
*Valid Values: Any font index as defined in [[Fonts.tbl]]

===$Max Directives:===
Optional. Sets the default maximum number of directives displayed simultaneously.

*Syntax: '''Integer''' maximum number of directives
*Valid Values: Any positive number
*Default Value: '''5'''

===$Max Escort Ships:===
Optional. Sets the default maximum number of escort ships to be shown in the escort list.

*Syntax: '''Integer'''
*Valid Values: Any positive number
{{Warning|
Entries more than 16 will cause the list to overflow into the weapons list for resolutions lower than 1024x768.}}

===$Length Unit Multiplier:===
Optional. Sets the multiplier to applied to the reported distances. For example, if the multiplier is 0.5, then the distance reported to the player will (or at least should) be 0.5 x actual distance.

*Syntax: '''Float'''
*Valid Values: Any positive number

===$Speed Unit Multiplier:===
Optional. Analogous to [[Hud_gauges.tbl#$Length Unit Multiplier:|$Length Unit Multiplier]], this sets the multiplier to be applied to all speeds reported to the player. For example, if the multiplier is 0.5, the the speed reported to the player will (or at least should) be 0.5 x actual speed.

*Syntax: '''Float'''
*Valid Values: Any positive number
*Default Values:
:'''The value used in $Length Unit Multiplier''', or
:'''1''', if $Length Unit Multiplier is undefined

===$Wireframe Targetbox:===
Optional. Defines the default draw method for the target viewer (a.k.a. targetbox).

*Syntax: '''Integer''' Draw method ID
*Valid Values:
::'''0''' - Standard with full, bright lighting
::'''1''' - Wireframe
::'''2''' - Standard with proper lighting (i.e. lit the same as the actual target)
{{Table3615|
::'''3''' - Untextured with full bright lighting (i.e. drawn with a single flat color)}}

===$Targetbox Shader Effect:===
{{Table3615|
Optional. If set, defines a unique ID for a shader effect to be used when rendering a ship for the targeting box. The ID will be passed to the main shader as in [[Post_processing.tbl##Ship_Effects|#Ship_Effects]], but a table entry for the effect is not needed.

*Syntax: '''Integer'''
*Valid Values: Any positive number
}}

===$Lock Wireframe Mode:===
Optional. If set, prevents targetbox draw method from being changed during the gaming session.
*Syntax: '''Boolean'''

===$Scale Gauges:===
{{Table371|
Optional. If set, all gauges will use this value as the default for scaling individual gauge sizes (i.e. doesn't affect gauges that use Position:, and doesn't affect the values of Offset:. In addition, if "$Load Retail Configuration:" is true then all unspecified retail gauges will use this value.

If not set, defaults to yes.

*Syntax: '''Boolean'''
}}

===$Reticle Style:===
Optional. Defines which aiming reticle to use.
*Syntax: '''String'''
*Valid Values:
:'''FS1''' - uses '''''reticle1_fs1.ani'''''
:'''FS2''' - uses '''''reticle1.ani'''''

==#Gauge Config==
The following entries define default gauge appearance and behavior. Each gauge has the option of overriding these options.

===$Ship:===
Deprecated and superceded by $Ships in FSO revision 9208. If defined, the following config data will only be used if the player ship is of the supplied ship class. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*Syntax: '''String''', ship class name

===$Ships:===
Optional. Can be used to define a list of ships the hud definition that follows will be applied to. Can be defined multiple times within a #Gauge config group to allow unique HUD configurations per ship class.

If not defined, all following config data will be applied to all ships.

*`Syntax: '''( "Class name 1" "Class name 2" )''', ship class names formatted like a flag list.

====$Load Retail Configuration:====
Optional. Overrides the [[Hud_gauges.tbl#$Load Retail Configuration: 1|$Load Retail Configuration]] global option for this ship class.

*Syntax: '''Boolean'''

====$Color:====
Optional. Overrides the [[Hud_gauges.tbl#$Color: 1|$Color]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color]]

====$Font:====
Optional. Overrides the [[Hud_gauges.tbl#$Font: 1|$Font]] global option for this ship class.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font]]

===$Base:===
Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as [[Hud_gauges.tbl#Position:|Position:]] / [[Hud_gauges.tbl#Origin:|Origin:]] / [[Hud_gauges.tbl#Offset:|Offset:]]) will use as its coordinate system.

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Scale Gauges:===
{{Table371|
Optional. If set, will configure gauges Scaling behaviour for gauges in this #Gauge Config section. i.e. overriding the default, or the value specified at the top of the file. Individual gauges can override this setting.

*Syntax: '''Boolean'''
}}

===$Required Aspect:===
Optional. If set, this configuration will only be loaded for the specified aspect ratios.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: '''String'''
*Valid Values:
:"Full Screen" (4:3, aspect ratio < 1.5)
:"Wide Screen" (16:9, 16:10, or similar, aspect ratio >= 1.5)

===$Min:===
Optional. Minimum resolution for this config. Any resolution lower than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Max:===
Optional. Maximum resolution for this config. Any resolution higher than specified will not use this configuration.

Used as a filter when there are multiple $Base: resolutions in the table

*Syntax: ('''Integer''' width, '''Integer''' height)
*Valid Values: All supported resolutions (?)

===$Gauges:===
Following entries define gauge-specific behavior. For the most part, each gauge has its own overrides that, if not defined, would otherwise use the global values.

Since many gauges have the same configuration options, each gauge entry has a list of valid sub-entries. Unless stated otherwise, these options must be defined in the same order as they are shown, starting from the top and ending at the bottom.

====+Custom:====
Adds a custom gauge type.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Name:|Name:]]
:[[Hud_gauges.tbl#Text:|Text:]]
:[[Hud_gauges.tbl#X Offset:|X Offset:]] (Optional)
:[[Hud_gauges.tbl#Y Offset:|Y Offset:]] (Optional)
:[[Hud_gauges.tbl#Gauge Type:|Gauge Type:]]
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Active by default:|Active by default:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Messages:====
Adds a gauge that display mission messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Max Lines:|Max Lines:]] (Optional)
:[[Hud_gauges.tbl#Max Width:|Max Width:]] (Optional)
:[[Hud_gauges.tbl#Line Height:|Line Height]] (Optional)
:[[Hud_gauges.tbl#Total Lifetime:|Total Lifetime:]] (Optional)
:[[Hud_gauges.tbl#Scroll Time:|Scroll Time]] (Optional)
:[[Hud_gauges.tbl#Step Size:|Step Size:]] (Optional)
:[[Hud_gauges.tbl#Hidden By Comms Menu:|Hidden By Comms Menu:]] (Optional)

====+Training Messages:====
Adds a text box, like the ones seen in the FS1 and FS2 training missions.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Support:====
Adds a text box that shows the Support ship's status and ETA

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text Y-offset:|Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Status X-offset:|Dock Status X-offset:]] (Optional)
:[[Hud_gauges.tbl#Dock Time X-offset:|Dock Time X-offset:]] (Optional)

====+Damage:====
Adds a gauge that shows how much damage a target (or the player?) has.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Offsets:|Hull Integrity Offsets]] (Optional)
:[[Hud_gauges.tbl#Hull Integrity Value X-offset:|Hull Integrity Value X-offset]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Height:|Subsystem Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Subsystem List Start Offsets:|Subsystem List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Entry Value X-offset:|Subsystem Entry Value X-offset:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)

====+Wingman Status:====
Adds a gauge that monitors the status of your wing and squadron.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Left Background Filename:|Left Background Filename:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Right Background Filename:|Right Background Filename:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)}}
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
{{table373|
[[Hud_gauges.tbl#Fixed Header Position:|Fixed Header Position:]] (Optional)}}
:[[Hud_gauges.tbl#Left Background Width:|Left Background Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#First Background Size:|First Background Size:]] (Optional)}}
:[[Hud_gauges.tbl#Entry Width:|Entry Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Entry Size:|Entry Size:]] (Optional)
:[[Hud_gauges.tbl#Right Background Offset:|Right Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Offset:|Last Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Single Wing Offsets:|Single Wing Offsets:]] (Optional)
:[[Hud_gauges.tbl#Multiple Wing Start Offsets:|Multiple Wing Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Wing Name Offsets:|Wing Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dot Offsets:|Dot Offsets:]] (Optional)
:[[Hud_gauges.tbl#Expansion Mode:|Expansion Mode:]] (Optional)

====+Auto Speed:====
Adds the Auto-Speed mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Auto Target:====
Adds the Auto-target mode gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Auto Offsets:|Auto Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Offsets:|Target Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#On Text Color:|On Text Color:]] (Optional)
:[[Hud_gauges.tbl#On Text Color:|Off Text Color:]] (Optional)}}

====+Countermeasures:====
Adds a gauge that monitors the amount of remaining countermeasures the player's ship currently has.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Talking Head:====
Adds a video window to display pilot message videos (a.k.a talking heads).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Offsets:|Animation Offsets:]] (Optional)
:[[Hud_gauges.tbl#Animation Background Size:|Animation Background Size:]] (Deprecated)
{{table373|
:[[Hud_gauges.tbl#Animation Size:|Animation Size:]] (Optional)
}}

====+Directives:====
Adds a gauge that displays all currently active directives (includes current , completed, and failed)

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)
:[[Hud_gauges.tbl#Max Line Width:|Max Line Width:]] (Optional)
}}

====+Weapons:====
Adds a weapon status and ammunition gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Primary List Top Background Filename:|Primary List Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Primary List Middle Background Filename:|Primary List Middle Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Primary List Bottom Background Filename:|Primary List Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Top Background Filename:|Secondary List Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Entry Background Filename:|Secondary List Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Bottom Background Filename:|Secondary List Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Text X-offset:|Text X-offset:]] (Optional)
:[[Hud_gauges.tbl#Top Primary Frame Height:|Top Primary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Top Secondary Frame Height:|Top Secondary Frame Height:]] (Optional)
:[[Hud_gauges.tbl#Primary List Start Y-offset:|Primary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary List Start Y-offset:|Secondary List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Ammo X-offset:|Primary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Link X-offset:|Primary Weapon Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Name X-offset:|Primary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Ammo X-offset:|Secondary Weapon Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Linked X-offset:|Secondary Weapon Linked X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Name X-offset:|Secondary Weapon Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Reload X-offset:|Secondary Weapon Reload X-offset:]] (Optional)
:[[Hud_gauges.tbl#Primary Weapon Entry Height:|Primary Weapon Entry Height:]] (Optional)
:[[Hud_gauges.tbl#Secondary Weapon Entry Height:|Secondary Weapon Entry Height:]] (Optional)

====+Objective notify:====
Adds a Objective notifier gauge. This gauge alerts the player when receiving a new objective, or when an objective has been completed or failed. Additionally, this gauge alerts the player when entering subspace, and when a Red Alert mission orders are being received (prior to a forced subspace jump).

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#Objective Text Y-offset:|Objective Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Objective Value Y-offset:|Objective Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Text Y-offset:|Subspace Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Subspace Value Y-offset:|Subspace Value Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Text Y-offset:|Red Alert Text Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Red Alert Value Y-offset:|Red Alert Value Y-offset:]] (Optional)

====+Squad Message====
Adds the squad message gauge. In FS1 and FS2, this gauge is used to send commands to your squad. (?)

*Valid sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Background Height:|Top Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset|Bottom Background Offset]] (Optional)}}
:[[Hud_gauges.tbl#Command X-offset:|Command X-offset:]] (Optional)
:[[Hud_gauges.tbl#Page Up Offsets:|Page Up Offsets:]] (Optional)
:[[Hud_gauges.tbl#Page Down Offsets:|Page Down Offsets:]] (Optional)

====+Lag:====
Adds a Lag gauge.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]

====+Mini Target Shields:====
Adds a mini Target shields gauge. In FS1 and FS2, the Mini Target Shield gauge is the one right below the center reticle, and shows the hull damage in %

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]]
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]]
:[[Hud_gauges.tbl#3 Digit Hull Offsets:|3 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#2 Digit Hull Offsets:|2 Digit Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#1 Digit Hull Offsets:|1 Digit Hull Offsets:]] (Optional)

====+Player Shields:====
Adds a gauge that shows the shield and hull status icon of the player's craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Target Shields:====
Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Escort View:====
Adds an escort monitor/view gauge. This gauge monitors the status of all ships assigned to the player to escort.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Top Background Filename:|Top Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Bottom Background Filename:|Bottom Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height]] (Optional)
:[[Hud_gauges.tbl#Entry Stagger Width:|Entry Stagger Width:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Bottom Background Offset:|Bottom Background Offset:]] (Optional)}}
:[[Hud_gauges.tbl#Header Text:|Header Text]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#List Start Offsets:|List Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull X-offset:|Hull X-offset]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset]] (Optional)
:[[Hud_gauges.tbl#Status X-offset:|Status X-offset]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Ship Name Max Width:|Ship Name Max Width:]] (Optional)}}
{{table373|
:[[Hud_gauges.tbl#Right-Align Ship Names:|Right-Align Ship Names:]] (Optional)}}

====+Mission Time:====
Adds a gauge that displays the current mission time.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+ETS Retail:====
{{Table3613|
Draws the three other ETS gauges as a single gauge. Will automatically rearrange itself (like retail) if shields or other systems are missing.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
}}
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
{{Table3613|
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)
:[[Hud_gauges.tbl#Gauge Offset:|Gauge Offset:]] (Optional)

}}

====+ETS Weapons:====
Adds a gauge that displays the energy transfer rate for the energy weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Engines:====
Adds a gauge that displays the energy transfer rate for the afterburner/engines.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+ETS Shields:====
Adds a gauge that displays the energy transfer rate for the shields.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Letter Offsets:|Letter Offsets:]] (Optional)
:[[Hud_gauges.tbl#Top Offsets:|Top Offsets:]] (Optional)
:[[Hud_gauges.tbl#Bottom Offsets:|Bottom Offsets:]] (Optional)

====+Target Monitor:====
Adds a target monitor gauge that shows the targeted ship's relative orientation and hull strength, among other things.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Monitor Filename:|Monitor Filename:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Monitor Alpha Mask Filename:|Monitor Alpha Mask Filename:]] (Optional)}}
:[[Hud_gauges.tbl#Integrity Bar Filename:|Integrity Bar Filename:]] (Optional)
:[[Hud_gauges.tbl#Viewport Offsets:|Viewport Offsets:]] (Optional)
:[[Hud_gauges.tbl#Viewport Size:|Viewport Size:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Offsets:|Integrity Bar Offsets:]] (Optional)
:[[Hud_gauges.tbl#Integrity Bar Foreground Clip Height:|Integrity Bar Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Status Offsets:|Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Class Offsets:|Class Offsets:]] (Optional)
:[[Hud_gauges.tbl#Distance Offsets:|Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Speed Offsets:|Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Hull Offsets:|Hull Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Contents Offsets:|Cargo Contents Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Start Offsets:|Cargo Scan Start Offsets:]] (Optional)
:[[Hud_gauges.tbl#Cargo Scan Size:|Cargo Scan Size:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Subsystem Name Offsets:|Subsystem Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Subsystem Integrity Offsets:|Subsystem Integrity Offsets:]] (Optional)
:[[Hud_gauges.tbl#Disabled Status Offsets:|Disabled Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Desaturate:|Desaturate:]] (Optional)
}}

====+Extra Target Data:====
Adds a gauge that displays "extra" target data, such as its current orders and docking status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Bracket Offsets:|Bracket Offsets:]] (Optional)
:[[Hud_gauges.tbl#Dock Offsets:|Dock Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Dock Max Width:|Dock Offsets:]] (Optional)}}
:[[Hud_gauges.tbl#Order Offsets:|Order Offsets:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Order Max Width:|Dock Offsets:]] (Optional)}}
:[[Hud_gauges.tbl#Time Offsets:|Time Offsets:]] (Optional)

====+Radar:====
Adds a standard radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar Orb:====
Adds a 3D orb radar gauge

*Valid Sub-entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
{{table373|
:[[Hud_gauges.tbl#Radar Center Offsets:|Radar Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Radar Size:|Radar Size:]] (Optional)
}}
:[[Hud_gauges.tbl#Infinity Distance Offsets:|Infinity Distance Offsets]] (Optional)
:[[Hud_gauges.tbl#Long Distance Offsets:|Long Distance Offsets:]] (Optional)
:[[Hud_gauges.tbl#Short Distance Offsets:|Short Distance Offsets:]] (Optional)

====+Radar BSG:====
Adds a BSG style radar (a.k.a DRADIS).

:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#XY Disc Filename:|XY Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#XZ YZ Disc Filename:|XZ YZ Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Sweep Disc Filename:|Sweep Disc Filename:]] (Optional)
:[[Hud_gauges.tbl#Default Contact Filename:|Default Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Unknown Contact Filename:|Unknown Contact Filename:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]]
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]]
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Loop Volume:|Loop Volume:]] (Optional)
:[[Hud_gauges.tbl#Minimum Beep Delay:|Minimum Beep Delay]] (Optional)

====+Afterburner Energy:====
Adds a gauge that shows the remaining afterburner energy.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)

====+Weapon Energy:====
Adds a gauge that shows the remaining weapon energy.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Text Alignment:|Text Alignment:]] (Optional)
:[[Hud_gauges.tbl#Always Show Text:|Always Show Text:]] (Optional)
:[[Hud_gauges.tbl#Text Follows:|Text Follows:]] (Optional)
:[[Hud_gauges.tbl#Show Ballistic Ammo:|Show Ballistic Ammo:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Offsets:|Armed Guns List Offsets:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Alignment:|Armed Guns List Alignment:]] (Optional)
:[[Hud_gauges.tbl#Armed Guns List Entry Height:|Armed Guns List Entry Height:]] (Optional)
}}

====+Text Warnings:====
Adds a gauge that warns the player (current warnings are EMP, Launch, Evaded, Collision, Blast & Engine Wash).

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)

====+Center Reticle:====
Adds a "custom" center reticle.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Firepoint display:|Firepoint display:]] (Optional)
:[[Hud_gauges.tbl#Firepoint size:|Firepoint size:]] (Optional)
:[[Hud_gauges.tbl#Firepoint X coordinate multiplier:|Firepoint X coordinate multiplier:]] (Optional)
:[[Hud_gauges.tbl#Firepoint Y coordinate multiplier:|Firepoint Y coordinate multiplier:]] (Optional)

====+Throttle:====
Adds a gauge that shows the current throttle position.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Bottom Y-offset:|Foreground Clip Bottom Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Width:|Foreground Clip Width:]] (Optional)
:[[Hud_gauges.tbl#Foreground Clip Height:|Foreground Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Afterburner Clip Height:|Afterburner Clip Height:]] (Optional)
:[[Hud_gauges.tbl#Show Background:|Show Background:]] (Optional)
:[[Hud_gauges.tbl#Max Speed Label Offsets:|Max Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Max Speed Label:|Show Max Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Min Speed Label Offsets:|Min Speed Label Offsets:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Show Min Speed Label:|Show Min Speed Label:]] (Optional)}}
:[[Hud_gauges.tbl#Orbit Center Offsets:|Orbit Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Orbit Radius:|Orbit Radius:]] (Optional)
{{table3615|
:[[Hud_gauges.tbl#Current Speed Offsets:|Current Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Target Speed Offsets:|Target Speed Offsets:]] (Optional)
:[[Hud_gauges.tbl#Show Percentage:|Show Percentage:]] (Optional)
:[[Hud_gauges.tbl#Glide Status Offsets:|Glide Status Offsets:]] (Optional)
:[[Hud_gauges.tbl#Match Speed Status Offsets:|Match Speed Status Offsets:]] (Optional)
}}

====+Threat Indicator:====
Adds a gauge that indicates when a lock-on has been achieved by an attacker, and if the player is being shot at.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Filename:|Dumbfire Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Dumbfire Offsets:|Dumbfire Offsets:]] (Optional)
:[[Hud_gauges.tbl#Lock Offsets:|Lock Offsets:]] (Optional)

====+Multiplayer Messages:====
Adds a gauge that displays the multiplayer messages.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Voice Status:====
Adds a gauge that displays the voice status.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Ping:====
Adds a gauge that the ping time to the multiplayer server.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Supernova:====
Adds a gauge that warns the player of an impending supernova shock wave.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Lock Indicator:====
Adds a Lock Indicator gauge.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Lock Filename:|Lock Filename:]] (Optional)
:[[Hud_gauges.tbl#Locked Filename:|Locked Filename:]] (Optional)
:[[Hud_gauges.tbl#Lock Center Offsets:|Lock Center Offsets:]] (Optional)
:[[Hud_gauges.tbl#Locked Center Offsets:|Locked Center Offsets:]] (Optional)

====+Offscreen Indicator:====
Adds an Offscreen Indicator.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Target Brackets:====
Adds a Target Bracket gauge. This is drawn around current target(s) and talkers.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Dot Filename:|Dot Filename:]] (Optional)

====+Hostile Triangle:====
Adds a gauge that points to the nearest attacker, if it is off-screen and is not currently targeted.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Target Triangle:====
Adds a gauge that points to the targeted craft, if it is currently off-screen.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Missile Triangles:====
Adds a gauge that is used during attempting to lock onto a target when using an aspect seeking missile.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)
:[[Hud_gauges.tbl#Triangle Base:|Triangle Base:]] (Optional)
:[[Hud_gauges.tbl#Triangle Height:|Triangle Height:]] (Optional)

====+Lead Indicator:====
Adds a gauge that is used to raise the probability of hitting a target with primary weapons.

*Valid Sub-entries:
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0: Secondaries lead indicator (Dumbfire)
::Frame #1: Secondaries lead indicator (Homing)
::Frame #2: Primaries lead indicator
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)

====+Orientation Tee:====
Adds a gauge that indicates the targeted craft's orientation in relation to the player's craft.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Radius:|Radius]] (Optional)

====+Lead Sight:====
Adds a gauge that indicates where your shots will end up, as opposed to Lead Indicator that indicates where you have to shoot at to hit your target. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
::Frame #0 is used for secondaries
::* If only one frame is found in the file, then it is used for primaries instead
::Frame #1 is used for primaries

====+Kills:====
Adds a gauge that keeps track of how many kills the player has scored during a mission.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Text Offsets:|Text Offsets:]] (Optional)
:[[Hud_gauges.tbl#Value Offsets:|Value Offsets:]] (Optional)

====+Weapon Linking:====
Adds a gauge that indicates the selected weapons and their firing rates.

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Arc Filename:|Arc Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Filename:|Single Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Filename:|Double Primary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Filename:|Single Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Filename:|Double Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Filename:|Triple Secondary Filename:]] (Optional)
:[[Hud_gauges.tbl#Single Primary Offsets:|Single Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Primary Offsets:|Double Primary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Single Secondary Offsets:|Single Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Double Secondary Offsets:|Double Secondary Offsets:]] (Optional)
:[[Hud_gauges.tbl#Triple Secondary Offsets:|Triple Secondary Offsets:]] (Optional)

====+Fixed Messages:====

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position]] (Optional)
{{table371|
:[[Hud_gauges.tbl#Scale Gauge:|Scale Gauge:]] (Optional)
:[[Hud_gauges.tbl#Origin:|Origin:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Offset:|Offset:]])
:[[Hud_gauges.tbl#Offset:|Offset:]] (Optional, incompatible with [[Hud_gauges.tbl#Position:|Position:]], requires [[Hud_gauges.tbl#Origin:|Origin:]])
}}
{{table3615|
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
}}
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)

====+Flight Path Marker:====
{{table3615|
Adds a gauge that indicates the direction where your ship is traveling. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Center Offsets:|Center Offsets:]] (Optional)}}

====+Warhead Count:====
{{table3615|
Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Filename:|Filename:]] (Optional)
:[[Hud_gauges.tbl#Name Offsets:|Name Offsets:]] (Optional)
:[[Hud_gauges.tbl#Count Offsets:|Count Offsets:]] (Optional)
:[[Hud_gauges.tbl#Icon Width:|Icon Width:]] (Optional)
:[[Hud_gauges.tbl#Icon Height:|Icon Height:]] (Optional)
:[[Hud_gauges.tbl#Max Icons:|Max Icons:]] (Optional)
:[[Hud_gauges.tbl#Max Columns:|Max Columns:]] (Optional)
:[[Hud_gauges.tbl#Name Alignment:|Name Alignment:]] (Optional)
}}

====+Hardpoints:====
{{table3615|
Draws a silhouette of the player's ship and mounted weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Size:|Size:]] (Optional)
:[[Hud_gauges.tbl#Line Width:|Line Width:]] (Optional)
:[[Hud_gauges.tbl#View Direction:|View Direction:]] (Optional)
:[[Hud_gauges.tbl#Show Primary Weapons:|Show Primary Weapons:]] (Optional)
:[[Hud_gauges.tbl#Show Secondary Weapons:|Show Secondary Weapons:]] (Optional)
}}

====+Primary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
}}

====+Secondary Weapons:====
{{table3615|
Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by [[Diaspora]].

*Valid Sub-Entries:
:[[Hud_gauges.tbl#Position:|Position:]] (Optional)
:[[Hud_gauges.tbl#Cockpit Target:|Cockpit Target:]] (Optional)
::[[Hud_gauges.tbl#Canvas Size:|Canvas Size:]] (Optional)
::[[Hud_gauges.tbl#Display Offset:|Display Offset:]] (Optional)
::[[Hud_gauges.tbl#Display Size:|Display Size:]]
:[[Hud_gauges.tbl#Color:|Color:]] (Optional)
:[[Hud_gauges.tbl#Font:|Font:]] (Optional)
:[[Hud_gauges.tbl#Slew:|Slew:]] (Optional)
:[[Hud_gauges.tbl#Header Offsets:|Header Offsets:]] (Optional)
:[[Hud_gauges.tbl#Header Text:|Header Text:]] (Optional)
:[[Hud_gauges.tbl#First Background Filename:|First Background Filename:]] (Optional)
:[[Hud_gauges.tbl#First Background Height:|First Background Height:]] (Optional)
:[[Hud_gauges.tbl#First Background X-offset:|First Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Filename:|Entry Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Entry Background Height:|Entry Background Height:]] (Optional)
:[[Hud_gauges.tbl#Entry Background X-offset:|Entry Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Filename:|Last Background Filename:]] (Optional)
:[[Hud_gauges.tbl#Last Background X-offset:|Last Background X-offset:]] (Optional)
:[[Hud_gauges.tbl#Last Background Y-offset:|Last Background Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Entry Height:|Entry Height:]] (Optional)
:[[Hud_gauges.tbl#List Start Y-offset:|List Start Y-offset:]] (Optional)
:[[Hud_gauges.tbl#Ammo X-offset:|Ammo X-offset:]] (Optional)
:[[Hud_gauges.tbl#Link X-offset:|Link X-offset:]] (Optional)
:[[Hud_gauges.tbl#Name X-offset:|Name X-offset:]] (Optional)
:[[Hud_gauges.tbl#Unlink X-offset:|Unlink X-offset:]] (Optional)
:[[Hud_gauges.tbl#Reload X-offset:|Reload X-offset:]] (Optional)
}}

===$End Gauges===
The Gauges section must end with $End Gauges. No Exceptions.

==#End==
The very last entry in the Hud_gauges.tbl must be #End. No Exceptions.

----
----

==Gauge Configuration Options==
Since a vast majority of gauges share the same entries, the configuration options for each gauge have been grouped here for formatting consistency.

====Position:====
Defines the screen coordinates for the upper left corner of this gauge.

*Syntax: '''Integer''' horizontal pixel, '''Integer''' vertical pixel position

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]] (and many others)

====Scale Gauge:====

{{table371|
Define if a gauge size will scale or not.

If false then gauge bitmaps will always show at their original size which may result in gauges being very small at high resolutions.

If true then gauge bitmaps will scale in proportion to the current resolution vs the base HUD resolution in use. This may result in gauges becoming blurry at non-base resolutions.

Defaults to yes/true.

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Boolean''' scale_this_gauge

Used by: most gauges
}}

====Origin:====

{{table371|
Define gauge position as a ratio of the screen size (base or current, it doesn't matter).

Requires [[Hud_gauges.tbl#Offset:|Offset:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Float''' horizontal ratio 0.0 - 1.0, '''Float''' vertical ratio 0.0 - 1.0

Used by: most gauges
}}

====Offset:====

{{table371|
Define gauge offset from [[Hud_gauges.tbl#Origin:|Origin:]] in base resolution pixels

Requires [[Hud_gauges.tbl#Origin:|Origin:]]

Incompatible with [[Hud_gauges.tbl#Position:|Position:]]

*Syntax: '''Integer''' horizontal pixel offset from Origin:, '''Integer''' vertical pixel offset from Origin:

Used by: most gauges
}}

====Cockpit Target:====
The cockpit display that this gauge will be rendered to. Refers to the +Display Name: defined in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]].

*Syntax: '''String''' String defined in +Display Name: in [[ships.tbl#$Cockpit Display:|$Cockpit Display:]]

=====Canvas Size:=====
The off-screen canvas this gauge will be rendered to before being interpolated into the actual cockpit display. The smaller this number is, the larger the gauge will appear on the cockpit display.

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Offset:=====
The position of the canvas on the cockpit display texture

*Syntax: '''Integer''' width, '''Integer''' height

=====Display Size:=====
The interpolated size on the cockpit display texture that the canvas will be rendered to.

*Syntax: '''Integer''' width, '''Integer''' height

====Color:====
Optional. Overrides both previous color settings ([[Hud_gauges.tbl#$Color: 1|$Color]] HUD option and [[Hud_gauges#$Color: 2|$Color]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Color: 1|$Color:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Font:====
Optional. Overrides both previous font settings ([[Hud_gauges.tbl#$Font: 1|$Font]] HUD option and [[Hud_gauges#$Font: 2|$Font]] ship class option) for this particular gauge.

*Syntax: See [[Hud_gauges.tbl#$Font: 1|$Font:]]

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Training Messages:|+Training Messages:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Name:====
Defines the name of this custom gauge.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Text:====
Default text to be displayed. Can be altered using the hud-set-message, hud-set-text and hud-set-directive sexps.

*Syntax: '''String'''
*Max Length: 32 characters

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====X Offset:====
Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Y Offset:====
Optional. Defines the vertical pixel offset (from the gauge's origin defined by [[Hud_gauges.tbl#Position:|Position:]]) that the Text will be displayed.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Gauge Type:====
Defines the type of gauge this is.

*Syntax: '''String'''
*Valid Values: Any one of the possible [[gauge types]].

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Slew:====
Optional. Determines whether or not this gauge is affected by afterburner shaking or similar effects. If set to "true", the gauge will not follow the player's head movements when using TrackIR/padlock. i.e. should be used for gauges like the gunsight/leadsight.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Max Lines:====
Optional. Specifies the maximum number of message lines that are displayed.

*Syntax: '''Integer'''
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Max Width:====
Optional. Determines how long each message line may be.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Line Height:====
Optional. Determines the distance between line origins. (i.g. for a 12pt Font, there are needs to be at least 12 pixels between the bottom of one line and the next, otherwise the text will overlap each)

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 9

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Total Lifetime:====
Optional. Determines the maximum time the message gauge will be displayed from the time a new message is received.

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 14000 (14 seconds)

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Scroll Time:====
Optional. Determines the time for the messages to scroll up one step.( See [[Hud_gauges.tbl#Step Size:|Step Size:]] )

*Syntax: '''Integer'''
*Units: milliseconds
*Default Value: 30

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Step Size:====
Optional. Determines how many pixels to shift message lines during scrolling. Messages will be shifted up by this amount until they are on the next line (as defined by [[Hud_gauges.tbl#Line Height:|Line Height:]])

*Syntax: '''Integer'''
*Units: Pixels
*Default Value: 3

Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]

====Active by default:====
Optional. Determines whether or not this gauge is always active, or only available after being activated via sexp.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]]

====Filename:====
Designates the [[Multimedia_Files#ANI|.ANI]] or [[Multimedia_Files#EFF|.EFF]] used for this gauge's background graphic.
{{Note| All HUD .ANI's must have the same color palette as the retail .ANI's in order to render properly. (.EFF's do not have this restriction)}}

*Syntax: '''Filename'''
**No filename extension is needed.

Used by: [[Hud_gauges.tbl#+Custom:|+Custom:]], [[Hud_gauges.tbl#+Support:|+Support]]

====Top Background Filename:====
Optional. Designates which file to use for the top background. (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Bottom Background Filename:====
Optional. Designates which file to use for the Bottom background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]]

====Left Background Filename:====
Optional. Designates which file to use for the Left background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Right Background Filename:====
Optional. Designates which file to use for the Right background (?)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Background Filename:====
Optional. Designates which file to use for the Entry background

*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Damage|+Damage]], [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Primary List Top Background Filename:====
Optional. Designates which file to use for the Primary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Middle Background Filename:====
Optional. Designates which file to use for the Primary List Middle Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Bottom Background Filename:====
Optional. Designates which file to use for the Primary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Top Background Filename:====
Optional. Designates which file to use for the Secondary List Top Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Entry Background Filename:====
Optional. Designates which file to use for the Secondary List Entry Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Bottom Background Filename:====
Optional. Designates which file to use for the Secondary List Bottom Background

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Dot Filename:====
Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot)

*Syntax: '''Filename'''

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Header Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]], [[Hud_gauges.tbl#+Damage|+Damage:]]

====Fixed Header Position:====
Optional. If set, the header text will not change position when the gauge changes size.

*Syntax: '''Boolean'''

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Text Y-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship Text. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Text Offsets:====
Optional. Defines the screen position offsets for the text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Value Offsets:====
Optional. Defines the screen position offsets for the value label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: :[[Hud_gauges.tbl#+Countermeasures:|+Countermeasures:]]

====Dock Status X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock status. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Dock Time X-offset:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship's dock time. (?)

*Syntax: '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Support:|+Support:]]

====Hull Integrity Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the Damage gauge Hull integrity textbox(?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Hull Integrity Value X-offset:====
Optional. Designates the offsets from the hull integrity textbox's upper left corner for the hull integrity value. (?)

*Syntax: '''Integer''' horizontal offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Top Background Height:====
Optional. Designates the height of the Top background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Left Background Width:====
Optional. Defines the width of the Left Background.

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Entry Width:====
Optional. Defines the width of the Entry Background (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Subsystem Entry Height:====
Optional. Designates the height of the Subsystem entry (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem List Start Offsets:====
Optional. Designates the offsets from the gauge's upper left corner for the for the start of the Subsytem List (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Subsystem Entry Value X-offset:====
Optional. Designates the horizontal offset from the Subsystem List's position (?)

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]

====Single Wing Offsets:====
Optional. Designates the offset from the gauge's upper left corner for a single wing (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Multiple Wing Start Offsets:====
Optional. Designates the offset from the gauge's upper left corner for multiple wings (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Wing Name Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the Support Ship header (?)

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Dot Offsets:====
Optional. Designates the offset from the gauge's upper left corner for the All wingman status icons.
*Syntax:
:'''Integer''' x, '''Integer''' y ;; Wingman 1
:'''Integer''' x, '''Integer''' y ;; Wingman 2
:'''Integer''' x, '''Integer''' y ;; Wingman 3
:'''Integer''' x, '''Integer''' y ;; Wingman 4
:'''Integer''' x, '''Integer''' y ;; Wingman 5
:'''Integer''' x, '''Integer''' y ;; Wingman 6
*Units: Pixels

{{Warning|
All 6 wingman positions must be defined}}

Used by: [[Hud_gauges.tbl#+Wingman Status:|+Wingman Status:]]

====Expansion Mode:====
Optional. Denotes which direction (in relation to the player's wing) that the other wings should be appended to the gauge

*Syntax: '''String'''
*Valid Values:
:*Right ;; Wings are added to the right of the previous wing

Used by: [[Hud_gagues.tbl#+Wingman Status:|+Wingman Status:]]

====Auto Offsets:====
Optional. Defines the screen coordinates for the "Auto" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]], [[Hud_gagues.tbl#+Auto Target:|+Auto Target:]]

====Speed Offsets:====
Optional. Defines the screen coordinates for the "Speed" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gagues.tbl#+Auto Speed:|+Auto Speed:]]

====Target Offsets:====
Optional. Defines the screen coordinates for the "Target" text label.

*Syntax: '''Integer''' horizontal position, '''Integer''' vertical position
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Auto Target:|+Auto Target:]]

====Animation Offsets:====
Optional. Defines the offsets for the animation graphics.

*Syntax: '''Integer''' horizontal offset, '''Integer''' vertical offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Background Size:====
Deprecated. Originally, this set the size of the black box that's drawn behind the animation. Since Git revision 556e9a4 (2015-11-01), it has the same effect as [[Hud_gauges.tbl#Animation Size:|Animation Size:]].

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]

====Animation Size:====
{{table373|
Optional. Defines the size of the animation. All animations will be scaled to match this size.

*Syntax: '''Integer''' horizontal size, '''Integer''' vertical size
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Talking Head:|+Talking Head:]]
}}

====List Start Offsets:====
Optional. Defines the screen coordinate offsets for the start of the Directives list.

*Syntax: '''Integer''' x, '''Integer''' y
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Entry Height:====
Optional. Defines the height of each Directive

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_guages.tbl#+Directives:|+Directives:]]

====Top Primary Background X-offset:====
Optional. Defines the screen coordinate offset for the Top Primary Background

*Syntax: '''Integer'''
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Text X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Primary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Top Secondary Frame Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary List Start Y-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Link X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Ammo X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Linked X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Name X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Reload X-offset:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Primary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====Secondary Weapon Entry Height:====

Used by: [[Hud_gauges.tbl#+Weapons:|+Weapons:]]

====3 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 3 digit range (i.e. >= 100%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====2 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 2 digit range (i.e. 100% > hull damage% >= 10%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====1 Digit Hull Offsets:====
Designates the screen position offsets for the hull damage % when it is the 1 digit range (i.e. 10% > hull damage% >= 0%)

*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Mini Target Shields:|+Mini Target Shields:]]

====Objective Text Y-offset:====
Designates the screen position offset for the Objective label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Objective Value Y-offset====
Designates the screen position offset for the Objective value

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Text Y-offset:====
Designates the screen position offset for the Subspace label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Subspace Value Y-offset====
Designates the screen position offset for the Subspace value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Text Y-offset====
Designates the screen position offset for the Red Alert label

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Red Alert Value Y-offset====
Designates the screen position offset for the Red Alert value (?)

*Syntax: '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Objective notify:|+Objective notify:]]

====Command X-offset:====
*Syntax: '''Integer''' x offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Up Offsets:====
*Syntax: '''Integer''' x offset, '''Integer''' y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Page Down Offsets:====
*Syntax: '''Integer''' x offset, ''' Integer y offset
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Squad Message:|+Squad Message:]]

====Entry Height:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Entry Stagger Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Text:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Header Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====List Start Offsets:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Hull X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Name X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Status X-offset:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Ship Name Max Width:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Right-Align Ship Names:====

Used by: [[Hud_gauges.tbl#+Escort View:|+Escort View:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Letter Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Top Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Bottom Offsets:====

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Gauge Offset:====
*Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+ETS Retail:|+ETS Retail:]]

====Monitor Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Filename:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Viewport Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Integrity Bar Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Status Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Name Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Class Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Speed Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Hull Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Contents Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Start Offsets:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Cargo Scan Size:====

Used by: [[Hud_gauges.tbl#+Target Monitor:|+Target Monitor:]]

====Bracket Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Dock Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Order Max Width:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Time Offsets:====

Used by: [[Hud_gauges.tbl#+Extra Target Data:|+Extra Target Data:]]

====Radar Center Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Radar Size:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

====Infinity Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the infinity radar range symbol.

====Long Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the long range radar text (i.e. 10k).

====Short Distance Offsets:====

Used by: [[Hud_gauges.tbl#+Radar:|+Radar:]]

Offset to draw the short range radar text (i.e. 2k).

====Size:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XY Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====XZ YZ Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Sweep Disc Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Default Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Unknown Contact Filename:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG:]]

====Loop Volume:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Minimum Beep Delay:====

Used by: [[Hud_gauges.tbl#+Radar BSG:|+Radar BSG]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Afterburner Energy:|+Afterburner Energy:]]

====Firepoint display:====
Displays the positions of the gun firepoints on your ship
*Syntax: '''Boolean''', YES or NO

NOTE: The position of the firepoints is calculated from the Eye Point position in the POF. You may encounter weird results if you have no Eye Point defined, but no debug warnings will be raised.

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint size:====
Diameter of the gunpoint circles. '''Must be 4 or greater''' in order to work properly.
*Syntax: '''Integer'''

Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint X coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Firepoint Y coordinate multiplier:====
Used by: [[Hud_gauges.tbl#+Center Reticle:|+Center Reticle]]

====Foreground Clip Bottom Y-offset:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Width:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Foreground Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Afterburner Clip Height:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Show Background:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Max Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Min Speed Label Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Center Offsets:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Orbit Radius:====

Used by: [[Hud_gauges.tbl#+Throttle:|+Throttle:]]

====Arc Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Dumbfire Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Offsets:====
*Filename for the background graphic for this gauge
*Syntax: '''Filename'''

Used by: [[Hud_gauges.tbl#+Threat Indicator:|+Threat Indicator:]]

====Lock Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Filename:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Lock Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Locked Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lock Indicator:|+Lock Indicator:]]

====Radius:====
Defines the distance from the center of the screen to the base of the Hostile Triangle gauge.

*Syntax: '''Integer'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Base:====
Defines the width of the Hostile Triangle's base.

*Syntax: '''Float'''
*Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Triangle Height:====
Defines the height of the Hostile Triangle.

*Syntax: '''Float'''
Default value:
*Units: Pixels

Used by: [[Hud_gauges.tbl#+Hostile Triangle:|+Hostile Triangle:]]

====Center Offsets:====

Used by: [[Hud_gauges.tbl#+Lead Indicator:|+Lead Indicator:]]

====Single Primary Filename:====
Designates the file to use for the primary single fire-mode.

Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Filename:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Filename:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Filename:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Filename:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Primary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Single Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Double Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Triple Secondary Offsets:====
Used by: [[Hud_gauges.tbl#+Weapon Linking:|+Weapon Linking:]]

====Hidden By Comms Menu:====
{{Table3615|
Defines whether the messages gauge may be drawn at the same time as the wingman comms menu.
*Syntax: '''Boolean'''
*Default Value: '''false''' (messages are not visible while the comms menu is open)
Used by: [[Hud_gauges.tbl#+Messages:|+Messages:]]}}

====Bottom Background Offset:====
{{Table3615|
Defines the vertical pixel offset added to the position of the bottom background frame.
*Syntax: '''Integer''' vertical offset
*Units: Pixels
Used by: [[Hud_gauges.tbl#+Damage:|+Damage:]]}}

[[Category:Tables]]

Fs2 open on Linux/I18n and Key mapping problems

2015-11-09T06:24:01Z

Yarn: fixed the corrupted non-ASCII characters

{{Page Navigation|
BookName=[[The fs2_open on Linux Guide]]|
CurrentPage=I18n and Key mapping problems|i18n and Key mapping problems|
PrevPage=[[Fs2_open on Linux/ERROR: "Web cursor bitmap not found."|ERROR: "Web cursor bitmap not found."]]|
NextPage=[[Fs2_open on Linux/Dedicated X Display|Dedicated X Display]]}}

Ok, imagine that like me you don't have an us keyboard but a french one (or anything). Well, you probably have problems mapping some keys or even using the default mapping.

Actually, the problem is fs2_open does not take modifiers into account, as it uses them internally as modifiers for keys, and it won't accept non-us charset either.

On a french keyboard layout, the numbers ''1 2 3 4 5 6 7 8 9 0'' are on the same keys than on a US layout, but you have to press shift to use them. The primary function for theses keys are ''& é " ' ( - è _ ç à )''. These characters won't be accepted by freespace, and if you press shift to get a number, it won't work. This can be a problem, as theses keys are needed to use the communication system, and cannot be bound to anything. Also, as you won't get access some keys on your keyboard, it will be difficult to map every command on a key, or you'll have to use modifiers for nearly each key.

However, there is a solution. You can tell X to remap the keyboard before launching the game, and restore your normal keymap afterwards.

For exemple, I map 123456790 to &é"'(-è_çà keys so I can use the communication system, and I put , and ; on the Alt-Gr and Menu keys for convenience, as I binded thoses keys to next primary weapon and next secondary weapon.

To do this, I use a slightly enhanced startup script, which I put in ~/bin (this directory is in my path), together with a customized xmodmap.

* First, dump your current xmodmap :

<tt>~ $ xmodmap -pke > ~/xmodmap.current</tt>

* Then edit it with your favorite text editor. You'll see a bunch of lines looking like this :

<tt>
keycode 8 =
keycode 9 = Escape
keycode 10 = 1 ampersand onesuperior exclamdown onesuperior exclamdown
</tt>

The syntax is ''keycode <number> = <symbol list>''.

Use '''xev''' to scan the keycodes. The symbols are defined in ''/usr/include/X11/keysymdef.h''. Just make sure you write them without the ''XK_'' prefix. You'll find more information about xmodmap in the xmodmap manual page.

Just modify the keys you need, and be patient. This can be a long process. Test it with xmodmap :

<tt>~ $ xmodmap - < <filename></tt>

But don't forget to have your previous keymap at hand to recover your settings !
If you mess everything up, just restart X. Your default keymap will be applied from the X configuration.

Here is my own fs2 xmodmap, derived from fr-latin1 as described above. Feel free to use it if you're too lazy to modify your own. However, it may not fit with your needs. You may always use it as an exemple, thougt.
* http://clement.hermann.free.fr/fs2/xmodmap

Then, when the file is modified at your liking, just save it as '''~/.fs2_open/xmodmap'''

We'll start fs2_open with a slightly more elaborate startup script which will backup/apply/restore the keymap in addition of running the games with some options in the right directory.

<tt>
#!/bin/sh
# This script lauches fs2. If there is a file named $FS2_modmap (see below),
# backup the current modmap as $TMP_modmap and load it as the new modmap.
# The current modmap will be restored afterwards.

TMP_modmap="$HOME/xmodmap.tmp"
FS2_modmap="$HOME/.fs2_open/xmodmap"

FS2_OPEN_DIR=/usr/local/games/fs2_open

FS2_ARGS="-glow -spec -spec_exp 11 -spec_point 0.6 -spec_static 0.8 -spec_tube 0.4 \
-fps -jpgtga -ambient_factor 75 -targetinfo -nograb"

FS2_BIN="$FS2_OPEN_DIR/fs2_open_r"

die() {
echo "** Fatal error : $1" >&2
exit 1
}

cd $FS2_OPEN_DIR || die "Could not change directory to $FS2_OPEN_DIR"

# dump current xmodmap
[ -f "$FS2_modmap" ] && xmodmap -pke > $TMP_modmap

# load xmodmap
[ -f "$FS2_modmap" ] && xmodmap - < $FS2_modmap

# prepare to restore xmodmap on crash or exit
trap "xmodmap - < $TMP_modmap && rm $TMP_modmap" 0 2 3 4 9 11 15

# launch fs2
$FS2_BIN $FS2_ARGS $* || die "Error while running \"$FS2_BIN\" with arguments \
\"$FS2_ARGS\" ($?)"
</tt>

Adapt this script to your needs, and save it somewhere in your PATH - I for exemple use ''~/bin/freespace2''. Make it executable with chmod +x ''<file>''

That's it, now you can use fs2 with full control over your keyboard.

[[Category:FreeSpace Open on Linux|l18n]]