hud_gauges.tbl

Revision information OFP Revision: #122 Set the revision to your PR when your PR changes what this page documents. Leave it alone for edits that only fix or improve the documentation.

The hud_gauges.tbl changes the HUD. Not all gauges can be modified, but custom gauges can be added that mimic the built-in ones (such as the wingman status display).

HUD elements are called gauges, and each gauge has options to customize its appearance and, in some cases, its behavior.

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

Code: /hud/hudparse.cpp. See Tables for every table.

Badges show the version a field or behavior was added in.

Contents

1. #HUD Config Settings
2. HUD Configurations
3. #Gauge Config
4. Gauge Configuration Options

Field index (every field, one per line in table order; click one to jump to it)

#HUD Config Settings

• $Show Default HUD:
• $Head Animation:
• $Shield Gauge Ship:
• $Shield Gauge Target Ship:
• $Primary Weapons:
• $Secondary Weapons:
• $Example Wing Names:
• $Color Preset 1:, $Color Preset 2:, $Color Preset 3:
  • +Name:
  • +XSTR ID:
  • +Color:
  • +Default
• $Default Preset File:

HUD Configurations

• $Load Retail Configuration:
• $Color:
• $Font:
• $Chase View Only:
• $Max Directives:
• $Max Escort Ships:
• $Length Unit Multiplier:
• $Speed Unit Multiplier:
• $Wireframe Targetbox:
• $Wireframe Color Override:
• $Targetbox Shader Effect:
• $Lock Wireframe Mode:
• $Scale Gauges:
• $Force Scaling Above:
• $Reticle Style:

#Gauge Config

• $Ship:
• $Ships:
  • $Load Retail Configuration:
  • $Color:
  • $Font:
  • $Chase View Only:
• $Name:
  • $Show in HUD Config:
  • $Shield Gauge Ship:, $Shield Gauge Target Ship:, $Primary Weapons:, $Secondary Weapons:
  • $Load Retail Configuration:, $Color:, $Font:, $Chase View Only:
• $Base:
• $Scale Gauges:
• $Force Scaling Above:
• $Required Aspect:
• $Min:
• $Max:
• $Gauges:
  • +Custom:
  • +Scripted Gauge:
  • +Messages:
  • +Training Messages:
  • +Support:
  • +Damage:
  • +Wingman Status:
  • +Auto Speed:
  • +Auto Target:
  • +Countermeasures:
  • +Talking Head:
  • +Directives:
  • +Weapons:
  • +Objective notify:
  • +Squad Message
  • +Lag:
  • +Mini Target Shields:
  • +Player Shields:
  • +Target Shields:
  • +Escort View:
  • +Mission Time:
  • +ETS Retail:
  • +ETS Weapons:
  • +ETS Engines:
  • +ETS Shields:
  • +Target Monitor:
  • +Extra Target Data:
  • +Radar:
  • +Radar Orb:
  • +Radar BSG:
  • +Afterburner Energy:
  • +Weapon Energy:
  • +Text Warnings:
  • +Center Reticle:
  • +Throttle:
  • +Threat Indicator:
  • +Multiplayer Messages:
  • +Voice Status:
  • +Ping:
  • +Supernova:
  • +Lock Indicator:
  • +Offscreen Indicator:
  • +Target Brackets:
  • +Hostile Triangle:
  • +Target Triangle:
  • +Missile Triangles:
  • +Lead Indicator:
  • +Orientation Tee:
  • +Lead Sight:
  • +Kills:
  • +Weapon Linking:
  • +Fixed Messages:
  • +Flight Path Marker:
  • +Warhead Count:
  • +Hardpoints:
  • +Primary Weapons:
  • +Secondary Weapons:
• $End Gauges

Gauge Configuration Options

• Position:
• Scale Gauge:
• Force Scaling Above:
• Origin:
• Offset:
• Cockpit Target:
  • Canvas Size:
  • Display Offset:
  • Display Size:
• Color:
• Font:
• Name:
• Text:
• X Offset:
• Y Offset:
• Gauge Type:
• Slew:
• Max Lines:
• Max Width:
• Line Height:
• Total Lifetime:
• Scroll Time:
• Step Size:
• Active by default:
• Filename:
• Top Background Filename:
• Bottom Background Filename:
• Left Background Filename:
• First Background Filename:
• Right Background Filename:
• Last Background Filename:
• Entry Background Filename:
• Primary List Top Background Filename:
• Primary List Middle Background Filename:
• Primary List Bottom Background Filename:
• Secondary List Top Background Filename:
• Secondary List Entry Background Filename:
• Secondary List Bottom Background Filename:
• Alt Ballistic Filename:
• Dot Filename:
• Header Offsets:
• Fixed Header Position:
• Text Y-offset:
• Text Offsets:
• Value Offsets:
• Dock Status X-offset:
• Dock Time X-offset:
• Hull Integrity Offsets:
• Hull Integrity Value X-offset:
• Top Background Height:
• Left Background Width:
• Entry Width:
• Subsystem Entry Height:
• Subsystem List Start Offsets:
• Subsystem Entry Value X-offset:
• Single Wing Offsets:
• Multiple Wing Start Offsets:
• Wing Name Offsets:
• Dot Offsets:
• Expansion Mode:
• Use Full Wing Names:
• Wingname Align Mode:
• Key Line X Offset:
• Use Expanded Colors:
• Auto Offsets:
• Speed Offsets:
• Target Offsets:
• Animation Offsets:
• Animation Background Size:
• Animation Size:
• List Start Offsets:
• Entry Height:
• Alt Ballistic Offsets:
• Top Primary Background X-offset:
• Text X-offset:
• Alt Ballistic X-offset:
• Top Primary Frame Height:
• Top Secondary Frame Height:
• Primary List Start Y-offset:
• Secondary List Start Y-offset:
• Primary Weapon Ammo X-offset:
• Primary Weapon Link X-offset:
• Primary Weapon Name X-offset:
• Secondary Weapon Ammo X-offset:
• Secondary Weapon Unlinked X-offset:
• Secondary Weapon Linked X-offset:
• Secondary Weapon Name X-offset:
• Secondary Weapon Reload X-offset:
• Primary Weapon Entry Height:
• Secondary Weapon Entry Height:
• 3 Digit Hull Offsets:
• 2 Digit Hull Offsets:
• 1 Digit Hull Offsets:
• Objective Text Y-offset:
• Objective Value Y-offset
• Subspace Text Y-offset:
• Subspace Value Y-offset
• Red Alert Text Y-offset
• Red Alert Value Y-offset
• Command X-offset:
• Page Up Offsets:
• Page Down Offsets:
• Entry Height:
• Entry Stagger Width:
• Header Text:
• Header Offsets:
• List Start Offsets:
• Hull X-offset:
• Name X-offset:
• Status X-offset:
• Ship Name Max Width:
• Right-Align Ship Names:
• Foreground Clip Height:
• Letter Offsets:
• Top Offsets:
• Bottom Offsets:
• Gauge Offset:
• Monitor Filename:
• Integrity Bar Filename:
• Viewport Offsets:
• Viewport Size:
• Integrity Bar Offsets:
• Integrity Bar Foreground Clip Height:
• Status Offsets:
• Name Offsets:
• Class Offsets:
• Distance Offsets:
• Speed Offsets:
• Hull Offsets:
• Cargo Contents Offsets:
• Cargo Scan Type:
• Cargo Scan Start Offsets:
• Cargo Scan Size:
• Bracket Offsets:
• Dock Offsets:
• Dock Max Width:
• Order Offsets:
• Order Max Width:
• Time Offsets:
• Radar Center Offsets:
• Radar Size:
• Infinity Distance Offsets:
• Long Distance Offsets:
• Short Distance Offsets:
• Size:
• XY Disc Filename:
• XZ YZ Disc Filename:
• Sweep Disc Filename:
• Default Contact Filename:
• Unknown Contact Filename:
• Loop Volume:
• Minimum Beep Delay:
• Firepoint display:
• Firepoint size:
• Firepoint X coordinate multiplier:
• Firepoint Y coordinate multiplier:
• Autoaim Frame:
• Flight Cursor Frame:
• Foreground Clip Bottom Y-offset:
• Foreground Clip Width:
• Afterburner Clip Height:
• Show Background:
• Max Speed Label Offsets:
• Min Speed Label Offsets:
• Orbit Center Offsets:
• Orbit Radius:
• Arc Filename:
• Dumbfire Filename:
• Lock Filename:
• Dumbfire Offsets:
• Lock Offsets:
• Lock Filename:
• Locked Filename:
• Lock Center Offsets:
• Locked Center Offsets:
• Loop Locked Animation:
• Blink Locked Animation:
• Radius:
• Triangle Base:
• Triangle Height:
• Center Offsets:
• Single Primary Filename:
• Double Primary Filename:
• Single Secondary Filename:
• Double Secondary Filename:
• Triple Secondary Filename:
• Single Primary Offsets:
• Double Primary Offsets:
• Single Secondary Offsets:
• Double Secondary Offsets:
• Triple Secondary Offsets:
• Hidden By Comms Menu:
• Bottom Background Offset:
• Always Display:
• Center Text On Gauge X-Position:
• Ngon Sides:
• Ngon Offset:
• Cockpit View Choice:
• Enable Rearm Timer:
• First Background Size:
• Entry Size:
• Right Background Offset:
• Last Background Offset:
• On Text Color:
• Max Line Width:
• Monitor Alpha Mask Filename:
• Subsystem Name Offsets:
• Subsystem Integrity Offsets:
• Disabled Status Offsets:
• Desaturate:
• Wireframe:
• Wireframe Color:
• Text Alignment:
• Always Show Text:
• Text Follows:
• Show Ballistic Ammo:
• Armed Guns List Offsets:
• Armed Guns List Alignment:
• Armed Guns List Entry Height:
• Show Max Speed Label:
• Show Min Speed Label:
• Current Speed Offsets:
• Target Speed Offsets:
• Show Percentage:
• Glide Status Offsets:
• Match Speed Status Offsets:
• Enable Target Info:
• Count Offsets:
• Icon Width:
• Icon Height:
• Max Icons:
• Max Columns:
• Name Alignment:
• Line Width:
• View Direction:
• Show Primary Weapons:
• Show Secondary Weapons:
• First Background Height:
• First Background X-offset:
• Entry Background Height:
• Entry Background X-offset:
• Last Background X-offset:
• Last Background Y-offset:
• List Start Y-offset:
• Ammo X-offset:
• Link X-offset:
• Unlink X-offset:
• Reload X-offset:
• Off Text Color:

Every setting with "Color" in its name is also accepted spelled "Colour".

---

#HUD Config Settings

Optional, and must come first in the table if used. These set up the HUD options screen: its preview, its color presets and its default preset.

$Show Default HUD:

• Whether the default HUD layout is listed in the HUD options screen. It's always listed if there are no named layouts (see $Name:).
• Default: YES
• Syntax: Boolean

$Head Animation:

• The head animation shown in the HUD options preview.
• Syntax: String, file name

$Shield Gauge Ship:

• The ship class whose shield shape the preview's player shield gauge shows. An unknown class logs a warning.
• Syntax: String, ship class name

$Shield Gauge Target Ship:

• The ship class whose shield shape the preview's target shield gauge shows. An unknown class logs a warning.
• Syntax: String, ship class name

$Primary Weapons:

• The primary weapons shown in the preview's weapons gauge.
• Syntax: ( "Weapon 1" "Weapon 2" ... )

$Secondary Weapons:

• The secondary weapons shown in the preview's weapons gauge.
• Syntax: ( "Weapon 1" "Weapon 2" ... )

$Example Wing Names:

• The wing names shown in the preview's wingman status gauge, up to five.
• Default: Alpha, Beta, Gamma, Delta, Epsilon
• Syntax: ( "Wing 1" "Wing 2" ... )

$Color Preset 1:, $Color Preset 2:, $Color Preset 3:

• The three HUD color presets the player can pick in the HUD options. Each is optional and needs all of the fields below.

+Name:

• The preset's name.
• Syntax: String

+XSTR ID:

• The translation index for the name.
• Syntax: Integer

+Color:

• The color.
• Syntax: Integer red, Integer green, Integer blue, each 0 to 255; values outside are clamped

+Default

• Optional. Makes this preset the default.

$Default Preset File:

• The HUD configuration preset file used by default.
• Default: hud_3.hcf
• Syntax: String, file name

---

HUD Configurations

The following entries are used on the HUD system, but have not been grouped with any particular gauge. They can be preceded by an optional #HUD Global Settings line.

$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

$Chase View Only:

Optional. Sets gauges to be displayed only in Chase View.

• Syntax: Boolean
• Default Value: False

$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

$Distance Unit Multiplier: is accepted as a synonym

$Speed Unit Multiplier:

Optional. Analogous to $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)

3 - Untextured with full bright lighting (i.e. drawn with a single flat color)

$Wireframe Color Override:

Optional. Allows using a static color for the target monitor wireframe instead of one based on the target's IFF.

• Syntax: ( Color ), three integers, values from 0 to 255; red, green and blue respectively
• Example: ( 0, 255, 0 )

$Targetbox Shader Effect:

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 #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:

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:

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 superseded by $Ships. Using it logs a note. 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 $Load Retail Configuration global option for this ship class.

• Syntax: Boolean

$Color:

Optional. Overrides the $Color global option for this ship class.

• Syntax: See $Color

$Font:

Optional. Overrides the $Font global option for this ship class.

• Syntax: See $Font

$Chase View Only:

Optional. Overrides the $Chase View Only global option for this ship class.

• Syntax: See $Chase View Only

$Name:

Optional, instead of $Ship: or $Ships:. Gives this HUD layout a name. Ships use it by listing the name in $HUD Gauge Configs: in ships.tbl, and it's offered as a layout in the HUD options screen.

• Syntax: String

$Show in HUD Config:

Optional. Whether this layout is listed in the HUD options screen.

• Default: YES
• Syntax: Boolean

$Shield Gauge Ship:, $Shield Gauge Target Ship:, $Primary Weapons:, $Secondary Weapons:

Optional. The same as in #HUD Config Settings, for this layout's preview.

$Load Retail Configuration:, $Color:, $Font:, $Chase View Only:

Optional. The same as for $Ships: above.

$Base:

Required. Defines the base resolution for this HUD configuration, upon which other gauge options (such as Position: / Origin: / Offset:) will use as its coordinate system.

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

$Scale Gauges:

Optional. If set, will configure gauges Scaling behavior 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:

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:
  • Position:
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Name:
  • Text:
  • X Offset: (Optional)
  • Y Offset: (Optional)
  • Gauge Type:
  • Slew: (Optional)
  • Active by default: (Optional)
  • Filename:
  • 

+Scripted Gauge:

Adds a scripted gauge type.

• Valid Sub-Entries:
  • Position:
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Name:

+Messages:

Adds a gauge that display mission messages.

• Valid Sub-Entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Max Lines: (Optional)
  • Max Width: (Optional)
  • Line Height (Optional)
  • Total Lifetime: (Optional)
  • Scroll Time (Optional)
  • Step Size: (Optional)
  • 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:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Support:

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

• Valid Sub-Entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename:
  • Header Offsets: (Optional)
  • Text Y-offset: (Optional)
  • Dock Status X-offset: (Optional)
  • Dock Time X-offset: (Optional)
  • Enable Rearm Timer: (Optional boolean. Enables the countdown timer for rearm and repair. Overrides the commandline setting.)

+Damage:

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

• Valid Sub-Entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Top Background Filename: (Optional)
  • Entry Background Filename: (Optional)
  • Bottom Background Filename: (Optional)
  • Header Offsets: (Optional)
  • Hull Integrity Offsets (Optional)
  • Hull Integrity Value X-offset (Optional)
  • Top Background Height: (Optional)
  • Subsystem Entry Height: (Optional)
  • Subsystem List Start Offsets: (Optional)
  • Subsystem Entry Value X-offset: (Optional)
  • Bottom Background Offset: (Optional)
  • Always Display: (Optional)

+Wingman Status:

Adds a gauge that monitors the status of your wing and squadron.

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Left Background Filename: (Optional) (needs an animation with one frame)
  • First Background Filename: (Optional) (needs an animation with one frame)
  • Entry Background Filename: (Optional) (needs an animation with one frame)
  • Right Background Filename: (Optional) (needs an animation with one frame)
  • Last Background Filename: (Optional) (needs an animation with one frame)
  • Dot Filename: (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
  • Header Offsets: (Optional)
  • Fixed Header Position: (Optional)
  • Left Background Width: (Optional)
  • First Background Size: (Optional)
  • Entry Width: (Optional)
  • Entry Size: (Optional)
  • Right Background Offset: (Optional)
  • Last Background Offset: (Optional)
  • Single Wing Offsets: (Optional)
  • Multiple Wing Start Offsets: (Optional)
  • Wing Name Offsets: (Optional)
  • Dot Offsets: (Optional)
  • Expansion Mode: (Optional)
  • Use Full Wing Names: (Optional)
  • Use Expanded Colors: (Optional)
  • Wingname Align Mode: (Optional)

+Auto Speed:

Adds the Auto-Speed mode gauge.

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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)
  • Auto Offsets: (Optional)
  • Speed Offsets: (Optional)
  • On Text Color: (Optional)
  • Off Text Color: (Optional)

+Auto Target:

Adds the Auto-target mode gauge.

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (needs animation with 2 frames, 1st is without auto-targeting enabled, 2nd is with)
  • Auto Offsets: (Optional)
  • Target Offsets: (Optional)
  • On Text Color: (Optional)
  • Off Text Color: (Optional)

+Countermeasures:

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

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (needs an animation with a single frame)
  • Text Offsets: (Optional)
  • Value Offsets: (Optional)

+Talking Head:

Adds a video window to display pilot message videos (a.k.a talking heads).

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename:
  • Header Offsets: (Optional)
  • Animation Offsets: (Optional)
  • Animation Background Size: (Deprecated)
  • Animation Size: (Optional)

+Directives:

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

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Top Background Filename: (Optional) (needs animation with one frame)
  • Entry Background Filename: (Optional) (needs animation with one frame)
  • Bottom Background Filename: (Optional) (needs animation with one frame)
  • Header Offsets: (Optional)
  • Top Background Height: (Optional)
  • List Start Offsets: (Optional)
  • Entry Height: (Optional)
  • Bottom Background Offset: (Optional)
  • Max Line Width: (Optional)
  • Key Line X Offset: (Optional)

+Weapons:

Adds a weapon status and ammunition gauge.

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Primary List Top Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Primary List Middle Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Primary List Bottom Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Secondary List Top Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Secondary List Entry Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Secondary List Bottom Background Filename: (Optional) (needs animation with a single frame)
  • Alt Ballistic Filename: (Optional) (needs animation with a single frame)
  • Header Offsets: (Optional)
  • Alt Ballistic Offsets: (Optional)
  • Top Primary BackgroundX-offset: (Optional)
  • Alt Ballistic X-offset: (Optional)
  • Text X-offset: (Optional)
  • Alt Ballistic X-offset: (Optional)
  • Top Primary Frame Height: (Optional)
  • Top Secondary Frame Height: (Optional)
  • Primary List Start Y-offset: (Optional)
  • Secondary List Start Y-offset: (Optional)
  • Primary Weapon Ammo X-offset: (Optional)
  • Primary Weapon Link X-offset: (Optional)
  • Primary Weapon Name X-offset: (Optional)
  • Secondary Weapon Ammo X-offset: (Optional)
  • Secondary Weapon Linked X-offset: (Optional)
  • Secondary Weapon Name X-offset: (Optional)
  • Secondary Weapon Reload X-offset: (Optional)
  • Primary Weapon Entry Height: (Optional)
  • 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:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename:
  • Objective Text Y-offset: (Optional)
  • Objective Value Y-offset: (Optional)
  • Subspace Text Y-offset: (Optional)
  • Subspace Value Y-offset: (Optional)
  • Red Alert Text Y-offset: (Optional)
  • 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: Position (Optional)

Scale Gauge: (Optional)

Force Scaling Above: (Optional)

Origin: (Optional, incompatible with Position:, requires Offset:) Offset: (Optional, incompatible with Position:, requires Origin:)

Cockpit Target: (Optional) Canvas Size: (Optional) Display Offset: (Optional) Display Size:

Color: (Optional) Font: (Optional)

Chase View Only: (Optional)

Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

Slew: (Optional) Top Background Filename: (Optional) Entry Background Filename: (Optional) Bottom Background Filename: (Optional) Header Offsets: (Optional) List Start Offsets: (Optional) Top Background Height: (Optional) Entry Height: (Optional)

Bottom Background Offset (Optional)

Command X-offset: (Optional) Page Up Offsets: (Optional) Page Down Offsets: (Optional)

+Lag:

Adds a Lag gauge.

• Valid Sub-entries:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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:
  • Position
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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)
  • 3 Digit Hull Offsets: (Optional)
  • 2 Digit Hull Offsets: (Optional)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)

+Target Shields:

Adds a gauge that shows the shield and hull status icon of the targeted craft or ship.

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Top Background Filename: (Optional)
  • Entry Background Filename: (Optional)
  • Bottom Background Filename: (Optional)
  • Entry Height (Optional)
  • Entry Stagger Width: (Optional)
  • Bottom Background Offset: (Optional)
  • Header Text (Optional)
  • Header Offsets: (Optional)
  • List Start Offsets: (Optional)
  • Hull X-offset (Optional)
  • Name X-offset (Optional)
  • Status X-offset (Optional)
  • Ship Name Max Width: (Optional)
  • Right-Align Ship Names: (Optional)

+Mission Time:

Adds a gauge that displays the current mission time.

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Text Offsets: (Optional)
  • Value Offsets: (Optional)

+ETS Retail:

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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Foreground Clip Height: (Optional)
  • Letter Offsets: (Optional)
  • Top Offsets: (Optional)
  • Bottom Offsets: (Optional)
  • Gauge Offset: (Optional)

+ETS Weapons:

Adds a gauge that displays the energy transfer rate for the energy weapons.

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Foreground Clip Height: (Optional)
  • Letter Offsets: (Optional)
  • Top Offsets: (Optional)
  • Bottom Offsets: (Optional)

+ETS Engines:

Adds a gauge that displays the energy transfer rate for the afterburner/engines.

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Foreground Clip Height: (Optional)
  • Letter Offsets: (Optional)
  • Top Offsets: (Optional)
  • Bottom Offsets: (Optional)

+ETS Shields:

Adds a gauge that displays the energy transfer rate for the shields.

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Foreground Clip Height: (Optional)
  • Letter Offsets: (Optional)
  • Top Offsets: (Optional)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Monitor Filename: (Optional) (needs animation with 2 frames, 1st is the background for the target, 2nd is the border; rendered last)
  • Monitor Alpha Mask Filename: (Optional) (needs animation with a single frame)
  • Integrity Bar Filename: (Optional) (needs animation with 2 frames, 1st is a zero/dark filled bar, 2nd is a max/bright filled bar)
  • Viewport Offsets: (Optional)
  • Viewport Size: (Optional)
  • Integrity Bar Offsets: (Optional)
  • Integrity Bar Foreground Clip Height: (Optional)
  • Status Offsets: (Optional)
  • Name Offsets: (Optional)
  • Class Offsets: (Optional)
  • Distance Offsets: (Optional)
  • Speed Offsets: (Optional)
  • Hull Offsets: (Optional)
  • Cargo Contents Offsets: (Optional)
  • Cargo Scan Start Offsets: (Optional)
  • Cargo Scan Size: (Optional)
  • Subsystem Name Offsets: (Optional)
  • Subsystem Integrity Offsets: (Optional)
  • Disabled Status Offsets: (Optional)
  • Desaturate: (Optional)
  • Wireframe: (Optional. Valid values match $Wireframe Targetbox: and will override the global setting)
  • Wireframe Color: (Optional. Color. Takes three ints 0-255, R,G,B; will override the global setting)
  • Cargo Scan Type: (Optional)

+Extra Target Data:

Adds a gauge that displays "extra" target data, such as its current orders and docking status.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional) (needs an animation with 1 frame)
  • Bracket Offsets: (Optional)
  • Dock Offsets: (Optional)
  • Dock Max Width: (Optional)
  • Order Offsets: (Optional)
  • Order Max Width: (Optional)
  • Time Offsets: (Optional)

+Radar:

Adds a standard radar gauge

• Valid Sub-entries:

  • Ngon Sides: (Optional)
  • Ngon Offset: (Optional)
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Filename: (Optional) (needs animation with 2 frames, only the 2nd frame is used)
  • Radar Center Offsets: (Optional)
  • Radar Size: (Optional)
  • Infinity Distance Offsets (Optional)
  • Long Distance Offsets: (Optional)
  • Short Distance Offsets: (Optional)

+Radar Orb:

Adds a 3D orb radar gauge

• Valid Sub-entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Filename: (Optional) (needs animation with 2 frames, only the 2nd frame is used)
  • Radar Center Offsets: (Optional)
  • Radar Size: (Optional)
  • Infinity Distance Offsets (Optional)
  • Long Distance Offsets: (Optional)
  • Short Distance Offsets: (Optional)

+Radar BSG:

Adds a BSG style radar (a.k.a DRADIS).

Position (Optional)

Scale Gauge: (Optional)

Force Scaling Above: (Optional)

Origin: (Optional, incompatible with Position:, requires Offset:) Offset: (Optional, incompatible with Position:, requires Origin:)

Font: (Optional)

Chase View Only: (Optional)

Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

Size: (Optional) XY Disc Filename: (Optional) XZ YZ Disc Filename: (Optional) Sweep Disc Filename: (Optional) Default Contact Filename: (Optional) Unknown Contact Filename: (Optional) Cockpit Target: (Optional) Canvas Size: Display Offset: Display Size: Loop Volume: (Optional) 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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)
  • Foreground Clip Height: (Optional)
  • Text Offsets: (Optional)
  • Text Alignment: (Optional)
  • Always Show Text: (Optional)
  • Text Follows: (Optional)
  • Show Ballistic Ammo: (Optional)
  • Armed Guns List Offsets: (Optional)
  • Armed Guns List Alignment: (Optional)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)

+Center Reticle:

Adds a "custom" center reticle.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Filename: (Optional)
  • Firepoint display: (Optional)
  • Firepoint size: (Optional)
  • Firepoint X coordinate multiplier: (Optional)
  • Firepoint Y coordinate multiplier: (Optional)
  • Autoaim Frame: (Optional)
  • Flight Cursor Frame: (Optional)

+Throttle:

Adds a gauge that shows the current throttle position.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Filename: (Optional)
  • Foreground Clip Bottom Y-offset: (Optional)
  • Foreground Clip Width: (Optional)
  • Foreground Clip Height: (Optional)
  • Afterburner Clip Height: (Optional)
  • Show Background: (Optional)
  • Max Speed Label Offsets: (Optional)
  • Show Max Speed Label: (Optional)
  • Min Speed Label Offsets: (Optional)
  • Show Min Speed Label: (Optional)
  • Orbit Center Offsets: (Optional)
  • Orbit Radius: (Optional)
  • Current Speed Offsets: (Optional)
  • Target Speed Offsets: (Optional)
  • Show Percentage: (Optional)
  • Glide Status Offsets: (Optional)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Arc Filename: (Optional)
  • Dumbfire Filename: (Optional)
  • Lock Filename: (Optional)
  • Dumbfire Offsets: (Optional)
  • Lock Offsets: (Optional)

+Multiplayer Messages:

Adds a gauge that displays the multiplayer messages.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Voice Status:

Adds a gauge that displays the voice status.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Ping:

Adds a gauge that the ping time to the multiplayer server.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Supernova:

Adds a gauge that warns the player of an impending supernova shock wave.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Lock Indicator:

Adds a Lock Indicator gauge.

• Valid Sub-Entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Lock Filename: (Optional)
  • Locked Filename: (Optional)
  • Lock Center Offsets: (Optional)
  • Locked Center Offsets: (Optional)
  • Loop Locked Animation: (Optional)
  • Blink Locked Animation: (Optional)

+Offscreen Indicator:

Adds an Offscreen Indicator.

• Valid Sub-Entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")

+Target Brackets:

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

• Valid Sub-Entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Dot Filename: (Optional) (needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen)
  • Enable Target Info: (Optional boolean. Adds the target name and class to the brackets. Overrides the commandline setting.)

+Hostile Triangle:

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

• Valid Sub-entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Radius (Optional)
  • Triangle Base: (Optional)
  • Triangle Height: (Optional)

+Target Triangle:

Adds a gauge that points to the targeted craft, if it is currently off-screen.

• Valid Sub-entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Radius (Optional)
  • Triangle Base: (Optional)
  • 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:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Radius (Optional)
  • Triangle Base: (Optional)
  • Triangle Height: (Optional)

+Lead Indicator:

Adds a gauge that leads (is in front) of the target. Aim your crosshairs at this indicator to increase probability of hitting the target.

• Valid Sub-entries:
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Filename: (Optional) Frame #0: Secondaries lead indicator (Dumbfire) Frame #1: Secondaries lead indicator (Homing) Frame #2: Primaries lead indicator
  • 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:
  • Position (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Radius (Optional)

+Lead Sight:

Adds a gauge that lags (is behind) the target. Indicates where your shots will end up relative to the target's position. To score a hit, this gauge should be over the target. Notably used by Diaspora.

• Valid Sub-Entries:
  • Position (Optional)
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • 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:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional)
  • Text Offsets: (Optional)
  • Value Offsets: (Optional)

+Weapon Linking:

Adds a gauge that indicates the selected weapons and their firing rates.

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Arc Filename: (Optional)
  • Single Primary Filename: (Optional)
  • Double Primary Filename: (Optional)
  • Single Secondary Filename: (Optional)
  • Double Secondary Filename: (Optional)
  • Triple Secondary Filename: (Optional)
  • Single Primary Offsets: (Optional)
  • Double Primary Offsets: (Optional)
  • Single Secondary Offsets: (Optional)
  • Double Secondary Offsets: (Optional)
  • Triple Secondary Offsets: (Optional)

+Fixed Messages:

• Valid Sub-Entries:
  • Position (Optional)
  • Scale Gauge: (Optional)
  • Force Scaling Above: (Optional)
  • Origin: (Optional, incompatible with Position:, requires Offset:)
  • Offset: (Optional, incompatible with Position:, requires Origin:)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Center Text On Gauge X-Position: (Optional)

+Flight Path Marker:

Adds a gauge that indicates the direction where your ship is traveling. Notably used by Diaspora.

• Valid Sub-Entries:
  • Color: (Optional)
  • Filename: (Optional)
  • Center Offsets: (Optional)

+Warhead Count:

Displays the name of the current secondary weapon. Tallies the ammo left. Notably used by Diaspora.

• Valid Sub-Entries:
  • Position: (Optional)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Filename: (Optional) (needs an animation with a single frame)
  • Name Offsets: (Optional)
  • Count Offsets: (Optional)
  • Icon Width: (Optional)
  • Icon Height: (Optional)
  • Max Icons: (Optional)
  • Max Columns: (Optional)
  • Name Alignment: (Optional)

+Hardpoints:

Draws a silhouette of the player's ship and mounted weapons. Notably used by Diaspora.

• Valid Sub-Entries:
  • Position: (Optional)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Size: (Optional)
  • Line Width: (Optional)
  • View Direction: (Optional)
  • Show Primary Weapons: (Optional)
  • Show Secondary Weapons: (Optional)

+Primary Weapons:

Like the Weapons gauge but simpler. Only displays primary weapons. Notably used by Diaspora.

• Valid Sub-Entries:
  • Position: (Optional)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Header Offsets: (Optional)
  • Header Text: (Optional)
  • First Background Filename: (Optional) (needs animation with a single frame)
  • First Background Height: (Optional)
  • First Background X-offset: (Optional)
  • Entry Background Filename: (Optional) (needs animation with a single frame)
  • Entry Background Height: (Optional)
  • Entry Background X-offset: (Optional)
  • Last Background Filename: (Optional) (needs animation with a single frame)
  • Last Background X-offset: (Optional)
  • Last Background Y-offset: (Optional)
  • Entry Height: (Optional)
  • List Start Y-offset: (Optional)
  • Ammo X-offset: (Optional)
  • Link X-offset: (Optional)
  • Name X-offset: (Optional)

+Secondary Weapons:

Like the Weapons gauge but simpler. Only displays secondary weapons. Notably used by Diaspora.

• Valid Sub-Entries:
  • Position: (Optional)
  • Cockpit Target: (Optional)
  • Canvas Size: (Optional)
  • Display Offset: (Optional)
  • Display Size:
  • Color: (Optional)
  • Font: (Optional)
  • Chase View Only: (Optional)
  • Cockpit View Choice: (Optional. Valid values are "cockpitactive", "cockpitinactive", "both")
  • Slew: (Optional)
  • Header Offsets: (Optional)
  • Header Text: (Optional)
  • First Background Filename: (Optional)
  • First Background Height: (Optional)
  • First Background X-offset: (Optional)
  • Entry Background Filename: (Optional)
  • Entry Background Height: (Optional)
  • Entry Background X-offset: (Optional)
  • Last Background Filename: (Optional)
  • Last Background X-offset: (Optional)
  • Last Background Y-offset: (Optional)
  • Entry Height: (Optional)
  • List Start Y-offset: (Optional)
  • Ammo X-offset: (Optional)
  • Link X-offset: (Optional)
  • Name X-offset: (Optional)
  • Unlink X-offset: (Optional)
  • 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: +Custom:, +Training Messages:, +Support (and many others)

Scale Gauge:

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 Position:

• Syntax: Boolean scale_this_gauge

Used by: most gauges

Force Scaling Above:

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 Position:

• Syntax: (Integer width, Integer height)

Used by: most gauges

Origin:

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

Requires Offset:

Incompatible with Position:

• Syntax: Float horizontal ratio 0.0 - 1.0, Float vertical ratio 0.0 - 1.0

Used by: most gauges

Offset:

Define gauge offset from Origin: in base resolution pixels

Requires Origin:

Incompatible with 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 $Cockpit Display:.

• Syntax: String String defined in +Display Name: in $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 ($Color HUD option and $Color ship class option) for this particular gauge.

• Syntax: See $Color:

Used by: +Custom:, +Support

Font:

Optional. Overrides both previous font settings ($Font HUD option and $Font ship class option) for this particular gauge.

• Syntax: See $Font:

Used by: +Custom:, +Training Messages:, +Support

Name:

Defines the name of this custom gauge.

• Syntax: String
• Max Length: 32 characters

Used by: +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: +Custom:

X Offset:

Optional. Defines the horizontal pixel offset (from the gauge's origin as defined by Position:) that the Text will be displayed.

• Syntax: Integer
• Units: Pixels

Used by: +Custom:

Y Offset:

Optional. Defines the vertical pixel offset (from the gauge's origin defined by Position:) that the Text will be displayed.

• Syntax: Integer
• Units: Pixels

Used by: +Custom:

Gauge Type:

Defines the type of gauge this is.

• Syntax: String
• Valid Values: Any one of the possible gauge types.

Used by: +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: +Custom:, +Support

Max Lines:

Optional. Specifies the maximum number of message lines that are displayed.

• Syntax: Integer
• Default Value: 3

Used by: +Messages:

Max Width:

Optional. Determines how long each message line may be.

• Syntax: Integer
• Units: Pixels

Used by: +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: +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: +Messages:

Scroll Time:

Optional. Determines the time for the messages to scroll up one step.( See Step Size: )

• Syntax: Integer
• Units: milliseconds
• Default Value: 30

Used by: +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 Line Height:)

• Syntax: Integer
• Units: Pixels
• Default Value: 3

Used by: +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: +Custom:

Filename:

Designates the .ANI or .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: +Custom:, +Support

Top Background Filename:

Optional. Designates which file to use for the top background. (?)

• Syntax: Filename

Used by: +Damage

Bottom Background Filename:

Optional. Designates which file to use for the Bottom background (?)

• Syntax: Filename

Used by: +Damage

Left Background Filename:

Optional. Designates which file to use for the Left side of gauge.

• Syntax: Filename

Used by: +Wingman Status:

First Background Filename:

Optional. Alias for Left Background Filename:

Right Background Filename:

Optional. Designates which file to use for the Right side of the gauge.

• Syntax: Filename

Used by: +Wingman Status:

Last Background Filename:

Optional. Alias for 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: +Damage, +Wingman Status:

Primary List Top Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Primary List Middle Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Primary List Bottom Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Secondary List Top Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Secondary List Entry Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Secondary List Bottom Background Filename:

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

• Syntax: Filename
• Valid Sub-entries:
  • Alt Ballistic Filename

Used by: +Weapons:

Alt Ballistic Filename:

Optional. Designates an alternate file to be used for ballistic weapons.

• Syntax: Filename

Used by: Primary List Top Background Filename, Primary List Middle Background Filename, Primary List Bottom Background Filename, Secondary List Top Background Filename, Secondary List Entry Background Filename, Secondary List Bottom Background Filename

Dot Filename:

Optional. Designates which file to use for the wingman graphic (a.k.a. the Dot). Needs an animation with two frames, 1st is for alive wingmen, 2nd is for dead or missing wingmen

• Syntax: Filename

Used by: +Wingman Status:

Header Offsets:

Optional. Designates the offset from the gauge's upper left corner for headers of various gauges

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels
• Valid Sub-entries: Weapons:
  • Alt Ballistic Offsets:

Used by: +Support:, +Damage:, +Weapons:

Fixed Header Position:

Optional. If set, the header text will not change position when the gauge changes size.

• Syntax: Boolean

Used by: +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: +Support:

Text Offsets:

Optional. Defines the screen position offsets for the text label.

• Syntax: Integer horizontal position, Integer vertical position
• Units: Pixels

Used by: :+Countermeasures:

Value Offsets:

Optional. Defines the screen position offsets for the value label.

• Syntax: Integer horizontal position, Integer vertical position
• Units: Pixels

Used by: :+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: +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: +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: +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: +Damage:

Top Background Height:

Optional. Designates the height of the Top background (?)

• Syntax: Integer
• Units: Pixels

Used by: +Damage:

Left Background Width:

Optional. Defines the width of the Left Background.

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

Entry Width:

Optional. Defines the width of the Entry Background (?)

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

Subsystem Entry Height:

Optional. Designates the height of the Subsystem entry (?)

• Syntax: Integer
• Units: Pixels

Used by: +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: +Damage:

Subsystem Entry Value X-offset:

Optional. Designates the horizontal offset from the Subsystem List's position (?)

• Syntax: Integer
• Units: Pixels

Used by: +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: +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: +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: +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: +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. If not present the gauge will expand to the left.

• Syntax: String
• Valid Values:
  • Right
  • Down

Used by: +Wingman Status:

Use Full Wing Names:

Optional. If enabled the wingmen gauge draws the full wing name and does not alter the capitalization. Default behavior is to draw the first three letters of the wing in all lower-case.

• Syntax: Boolean
• Default Value: False

Used by: +Wingman Status:

Wingname Align Mode:

Optional. How wing names are aligned: Center, Left or Right. Anything else is an error and is ignored.

• Syntax: String

Used by: +Wingman Status:

Key Line X Offset:

Optional. How far key bindings shown in directives are moved right.

• Syntax: Integer, pixels

Used by: +Directives:

Use Expanded Colors:

Optional. If enabled the wingmen gauge status dots use red, yellow, or green color to designate wingmen health (green full to greater thon two-thirds, yellow two-thirds to greater than one-third, and red less than or equal to one-third). Default is to use red for less than half health and gauge color otherwise.

• Syntax: Boolean
• Default Value: False

Used by: +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: +Auto Speed:, +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: +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: +Auto Target:

Animation Offsets:

Optional. Defines the offsets for the animation graphics.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +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 Animation Size:.

• Syntax: Integer horizontal size, Integer vertical size
• Units: Pixels

Used by: +Talking Head:

Animation Size:

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: +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: +Directives:

Entry Height:

Optional. Defines the height of each Directive

• Syntax: Integer
• Units: Pixels

Used by: +Directives:

Alt Ballistic Offsets:

Optional. Defines the screen coordinate offsets for headers of ballistic weapons

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Weapons:

Top Primary Background X-offset:

Optional. Defines the screen coordinate offset for the Top Primary Background

• Syntax: Integer
• Units: Pixels
• Valid Sub-entries:
  • Alt Ballistic X-offset:

Used by: +Weapons:

Text X-offset:

(Optional) Defines the screen coordinate X-offset for weapon labels

• Syntax: Integer
• Units: Pixels
• Valid Sub-entries:
  • Alt Ballistic X-offset:

Used by: +Weapons:

Alt Ballistic X-offset:

Optional. Defines the screen coordinate X-offset for ballistic weapons

• Syntax: Integer
• Units: Pixels

Used by: Top Primary Background X-offset:, Text X-offset:

Top Primary Frame Height:

Used by: +Weapons:

Top Secondary Frame Height:

Used by: +Weapons:

Primary List Start Y-offset:

Used by: +Weapons:

Secondary List Start Y-offset:

Used by: +Weapons:

Primary Weapon Ammo X-offset:

Used by: +Weapons:

Primary Weapon Link X-offset:

Used by: +Weapons:

Primary Weapon Name X-offset:

Used by: +Weapons:

Secondary Weapon Ammo X-offset:

Used by: +Weapons:

Secondary Weapon Unlinked X-offset:

Used by: +Weapons:

Secondary Weapon Linked X-offset:

Used by: +Weapons:

Secondary Weapon Name X-offset:

Used by: +Weapons:

Secondary Weapon Reload X-offset:

Used by: +Weapons:

Primary Weapon Entry Height:

Used by: +Weapons:

Secondary Weapon Entry Height:

Used by: +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: +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: +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: +Mini Target Shields:

Objective Text Y-offset:

Designates the screen position offset for the Objective label

• Syntax: Integer y offset
• Units: Pixels

Used by: +Objective notify:

Objective Value Y-offset

Designates the screen position offset for the Objective value

• Syntax: Integer y offset
• Units: Pixels

Used by: +Objective notify:

Subspace Text Y-offset:

Designates the screen position offset for the Subspace label

• Syntax: Integer y offset
• Units: Pixels

Used by: +Objective notify:

Subspace Value Y-offset

Designates the screen position offset for the Subspace value (?)

• Syntax: Integer y offset
• Units: Pixels

Used by: +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: +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: +Objective notify:

Command X-offset:

• Syntax: Integer x offset
• Units: Pixels

Used by: +Squad Message:

Page Up Offsets:

• Syntax: Integer x offset, Integer y offset
• Units: Pixels

Used by: +Squad Message:

Page Down Offsets:

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

Used by: +Squad Message:

Entry Height:

Used by: +Escort View:

Entry Stagger Width:

Used by: +Escort View:

Header Text:

Used by: +Escort View:

Header Offsets:

Used by: +Escort View:

List Start Offsets:

Used by: +Escort View:

Hull X-offset:

Used by: +Escort View:

Name X-offset:

Used by: +Escort View:

Status X-offset:

Used by: +Escort View:

Ship Name Max Width:

Used by: +Escort View:

Right-Align Ship Names:

Used by: +Escort View:

Foreground Clip Height:

• Sets the height, in pixels, of the gauge.
  • For the Throttle, sets the height of the gauge that represents 0% to 100% throttle. The total height of the gauge is the sum of this value and the Afterburner Clip Height value.
• Syntax: Integer

Used by: +ETS Retail:, +ETS Weapons, +ETS Engines, +ETS Shields, +Target Monitor, +Afterburner Energy, +Weapon Energy, +Throttle

Letter Offsets:

Used by: +ETS Retail:

Top Offsets:

Used by: +ETS Retail:

Bottom Offsets:

Used by: +ETS Retail:

Gauge Offset:

• Distance between the individual weapon/shield/engine ETS gauges that comprise this gauge
• Syntax: Integer

Used by: +ETS Retail:

Monitor Filename:

Used by: +Target Monitor:

Integrity Bar Filename:

Used by: +Target Monitor:

Viewport Offsets:

Used by: +Target Monitor:

Viewport Size:

Used by: +Target Monitor:

Integrity Bar Offsets:

Used by: +Target Monitor:

Integrity Bar Foreground Clip Height:

Used by: +Target Monitor:

Status Offsets:

Used by: +Target Monitor:

Name Offsets:

Used by: +Target Monitor:

Class Offsets:

Used by: +Target Monitor:

Distance Offsets:

Used by: +Target Monitor:

Speed Offsets:

Used by: +Target Monitor:

Hull Offsets:

Used by: +Target Monitor:

Cargo Contents Offsets:

Used by: +Target Monitor:

Cargo Scan Type:

Optional. How the scan lines are drawn while scanning cargo: default, dualscanlines or discoscanlines. An unknown type logs a warning and uses default.

• Syntax: String

Used by: +Target Monitor:

Cargo Scan Start Offsets:

Used by: +Target Monitor:

Cargo Scan Size:

Used by: +Target Monitor:

Bracket Offsets:

Used by: +Extra Target Data:

Dock Offsets:

Used by: +Extra Target Data:

Dock Max Width:

Used by: +Extra Target Data:

Order Offsets:

Used by: +Extra Target Data:

Order Max Width:

Used by: +Extra Target Data:

Time Offsets:

Used by: +Extra Target Data:

Radar Center Offsets:

Defines the radar's plot origin as an offset, in pixels, from this gauge's Position coordinates

• Syntax: Integer horizontal offset, Integer vertical offset

Used by: +Radar:

Radar Size:

Size, in pixels, of the radar plot area.

Syntax: Integer horizontal size, Integer vertical size

Used by: +Radar:

Infinity Distance Offsets:

Used by: +Radar:

Offset to draw the infinity radar range symbol.

Long Distance Offsets:

Used by: +Radar:

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

Short Distance Offsets:

Used by: +Radar:

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

Size:

Used by: +Radar BSG:

XY Disc Filename:

Used by: +Radar BSG:

XZ YZ Disc Filename:

Used by: +Radar BSG:

Sweep Disc Filename:

Used by: +Radar BSG:

Default Contact Filename:

Used by: +Radar BSG:

Unknown Contact Filename:

Used by: +Radar BSG:

Loop Volume:

Used by: +Radar BSG

Minimum Beep Delay:

Used by: +Radar BSG

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: +Center Reticle

Firepoint size:

Diameter of the gunpoint circles. Must be 4 or greater in order to work properly.

• Syntax: Integer

Used by: +Center Reticle

Firepoint X coordinate multiplier:

How far the gunpoint circles are spread horizontally from the center of the reticle. Each firepoint's horizontal offset is multiplied by this value to place its circle, so a larger number spreads the circles further apart.

• Syntax: Float
• Default: 15

Fractional values are used as given. Earlier versions read this field as an integer, keeping only the whole part and logging a parse warning for the rest.

Used by: +Center Reticle

Firepoint Y coordinate multiplier:

How far the gunpoint circles are spread vertically from the center of the reticle. Each firepoint's vertical offset is multiplied by this value to place its circle, so a larger number spreads the circles further apart.

• Syntax: Float
• Default: 10

Fractional values are used as given. Earlier versions read this field as an integer, keeping only the whole part and logging a parse warning for the rest.

Used by: +Center Reticle

Autoaim Frame:

Optional. The frame of the reticle animation shown while autoaim is locked on.

• Syntax: Integer

Used by: +Center Reticle:

Flight Cursor Frame:

Optional. The frame of the reticle animation used for the flight cursor.

• Syntax: Integer

Used by: +Center Reticle:

Foreground Clip Bottom Y-offset:

Used by: +Throttle:

Foreground Clip Width:

Used by: +Throttle:

Afterburner Clip Height:

• Sets the area of the throttle gauge that represents the Afterburner segment (which is on top of the 0% to 100% area). The total height of the gauge is determined by the sum of this value and Foreground Clip Height:

Used by: +Throttle:

Show Background:

Used by: +Throttle:

Max Speed Label Offsets:

Used by: +Throttle:

Min Speed Label Offsets:

Used by: +Throttle:

Orbit Center Offsets:

Used by: +Throttle:

Orbit Radius:

Used by: +Throttle:

Arc Filename:

• Filename for the background graphic for this gauge
• Syntax: Filename

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

Used by: +Threat Indicator:

Dumbfire Filename:

• Filename for the background graphic for this gauge
• Syntax: Filename

Needs to be an 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: +Threat Indicator:

Lock Filename:

• Filename for the background graphic for this gauge
• Syntax: Filename

Needs to be an 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: +Threat Indicator:

Dumbfire Offsets:

• Filename for the background graphic for this gauge
• Syntax: Filename

Used by: +Threat Indicator:

Lock Offsets:

• Filename for the background graphic for this gauge
• Syntax: Filename

Used by: +Threat Indicator:

Lock Filename:

Used by: +Lock Indicator:

Locked Filename:

Used by: +Lock Indicator:

Lock Center Offsets:

Used by: +Lock Indicator:

Locked Center Offsets:

Used by: +Lock Indicator:

Loop Locked Animation:

Controls whether the animation should loop after locking on, like in FS1.

Used by: +Lock Indicator:

Blink Locked Animation:

Controls whether the animation should blink after locking on, like in FS2.

Used by: +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: +Hostile Triangle:

Triangle Base:

Defines the width of the Hostile Triangle's base.

• Syntax: Float
• Default value:
• Units: Pixels

Used by: +Hostile Triangle:

Triangle Height:

Defines the height of the Hostile Triangle.

• Syntax: Float Default value:
• Units: Pixels

Used by: +Hostile Triangle:

Center Offsets:

Used by: +Lead Indicator:

Single Primary Filename:

Designates the file to use for primary linking for ships with a single primary bank.

Needs to be an 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: +Weapon Linking:

Double Primary Filename:

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

Needs to be an 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: +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 ani with 2 frames; 1st is bank 1 not selected, 2nd is bank 1 selected.

Used by: +Weapon Linking:

Double Secondary Filename:

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

Needs to be an ani with 3 frames; 1st is no banks selected, 2nd is bank 1 selected, 3rd is bank 2 selected.

Used by: +Weapon Linking:

Triple Secondary Filename:

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

Needs to be an 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: +Weapon Linking:

Single Primary Offsets:

Used by: +Weapon Linking:

Double Primary Offsets:

Used by: +Weapon Linking:

Single Secondary Offsets:

Used by: +Weapon Linking:

Double Secondary Offsets:

Used by: +Weapon Linking:

Triple Secondary Offsets:

Used by: +Weapon Linking:

Hidden By Comms Menu:

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: +Messages:

Bottom Background Offset:

Defines the vertical pixel offset added to the position of the bottom background frame.

• Syntax: Integer vertical offset
• Units: Pixels Used by: +Damage:

Always Display:

Optional. Shows the damage gauge even when nothing is damaged.

• Syntax: Boolean

Used by: +Damage:

Center Text On Gauge X-Position:

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: +Fixed Messages:

Ngon Sides:

Defines the number of sides a regular polygon (N-gon) radar has. If defined, the standard radar's edge is drawn as an N-gon, instead of the standard ellipsoid. Blips that are projected outside of the N-gon are snapped to the edge: the blip's angle stays the same but the blip's radius to the center of the plot area is reduced.

• Syntax Integer
• Default Value: 0 A value of 0 means to use the standard ellipsoid radar
• Minimum value: 3 (which is a triangle) Used by: +Radar:

Ngon Offset:

Defines the angular offset to apply to the N-gon perimeter. The first vertex is at the 3 o'clock position, positive offsets spin this vertex counter-clockwise, negative offsets spin this clockwise.

• Syntax Float (radians)
• Default Value: 0 Used by: +Radar:

Cockpit View Choice:

Optional. Which views the gauge is drawn in, for ships with a cockpit model: cockpitactive (only while the cockpit is shown), cockpitinactive (only while it isn't), or both. Anything else logs a warning and both is used.

• Syntax: String
• Default: both

Used by: +Custom:, +Scripted Gauge:, +Messages:, +Training Messages:, +Support:, +Damage:, +Wingman Status:, +Auto Speed:, +Auto Target:, +Countermeasures:, +Talking Head:, +Directives:, +Weapons:, +Objective notify:, +Lag:, +Mini Target Shields:, +Player Shields:, +Target Shields:, +Escort View:, +Mission Time:, +ETS Retail:, +ETS Weapons:, +ETS Engines:, +ETS Shields:, +Target Monitor:, +Extra Target Data:, +Radar:, +Radar Orb:, +Radar BSG:, +Afterburner Energy:, +Weapon Energy:, +Text Warnings:, +Center Reticle:, +Throttle:, +Threat Indicator:, +Multiplayer Messages:, +Voice Status:, +Ping:, +Supernova:, +Lock Indicator:, +Offscreen Indicator:, +Target Brackets:, +Hostile Triangle:, +Target Triangle:, +Missile Triangles:, +Lead Indicator:, +Orientation Tee:, +Lead Sight:, +Kills:, +Weapon Linking:, +Fixed Messages:, +Warhead Count:, +Primary Weapons:, +Secondary Weapons:

Enable Rearm Timer:

Optional. Shows the countdown until rearming is done.

• Syntax: Boolean

Used by: +Support:

First Background Size:

Optional. The width of the first (left) background piece.

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

Entry Size:

Optional. The width taken by each wing's entry.

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

Right Background Offset:

Optional. The horizontal offset of the last (right) background piece. Also accepted as Last Background Offset:.

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

Last Background Offset:

Optional. Another name for Right Background Offset:.

• Syntax: Integer
• Units: Pixels

Used by: +Wingman Status:

On Text Color:

Optional. The color of the gauge's text while the setting is on (also accepted as On Text Colour:).

• Syntax: Integer red, Integer green, Integer blue, Integer alpha, 0 to 255

Used by: +Auto Speed:, +Auto Target:

Max Line Width:

Optional. The width a directive line can take before it wraps onto the next line.

• Syntax: Integer
• Units: Pixels

Used by: +Directives:

Monitor Alpha Mask Filename:

Optional. A mask bitmap that cuts the target view to the monitor's shape.

• Syntax: String, file name

Used by: +Target Monitor:

Subsystem Name Offsets:

Optional. Where the targeted subsystem's name is drawn.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Target Monitor:

Subsystem Integrity Offsets:

Optional. Where the targeted subsystem's integrity is drawn.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Target Monitor:

Disabled Status Offsets:

Optional. Where the "disabled" status of the targeted subsystem is drawn.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Target Monitor:

Desaturate:

Optional. Draws the target's model desaturated, in the HUD color.

• Syntax: Boolean

Used by: +Target Monitor:

Wireframe:

Optional. How the target's model is drawn: 0 normally, 1 as a wireframe only, 2 normally with lighting.

• Syntax: Integer

Used by: +Target Monitor:

Wireframe Color:

Optional. The color of the target's wireframe (also accepted as Wireframe Colour:).

• Syntax: Integer red, Integer green, Integer blue, 0 to 255

Used by: +Target Monitor:

Text Alignment:

Optional. How the energy text is aligned.

• Syntax: String, left or right (anything else means no alignment)

Used by: +Weapon Energy:

Always Show Text:

Optional. Always shows the energy text, instead of only when it changes or is low.

• Syntax: Boolean

Used by: +Weapon Energy:

Text Follows:

Optional. The energy text moves with the top of the energy bar.

• Syntax: Boolean

Used by: +Weapon Energy:

Show Ballistic Ammo:

Optional. Shows the ammo of ballistic primaries.

• Syntax: Boolean

Used by: +Weapon Energy:

Armed Guns List Offsets:

Optional. Shows a list of the armed primaries, at this position.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Weapon Energy:

Armed Guns List Alignment:

Optional, after Armed Guns List Offsets:. How the list is aligned.

• Syntax: String, left or right (anything else means no alignment)

Used by: +Weapon Energy:

Armed Guns List Entry Height:

Optional, after Armed Guns List Offsets:. The height of each line of the list.

• Syntax: Integer
• Units: Pixels

Used by: +Weapon Energy:

Show Max Speed Label:

Optional. Shows the maximum speed label.

• Syntax: Boolean

Used by: +Throttle:

Show Min Speed Label:

Optional. Shows the minimum speed label.

• Syntax: Boolean

Used by: +Throttle:

Current Speed Offsets:

Optional. Draws the current speed at this fixed position, instead of moving it along the throttle bar.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Throttle:

Target Speed Offsets:

Optional. Shows the target's speed, at this position.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Throttle:

Show Percentage:

Optional. Shows the target speed as a percentage.

• Syntax: Boolean

Used by: +Throttle:

Glide Status Offsets:

Optional. Where the glide status is shown.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Throttle:

Match Speed Status Offsets:

Optional. Where the match speed status is shown.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Throttle:

Enable Target Info:

Optional. Shows extra information about the target next to its brackets.

• Syntax: Boolean

Used by: +Target Brackets:

Count Offsets:

Optional. Where the warhead count is drawn.

• Syntax: Integer horizontal offset, Integer vertical offset
• Units: Pixels

Used by: +Warhead Count:

Icon Width:

Optional. The width of each warhead icon.

• Syntax: Integer
• Units: Pixels

Used by: +Warhead Count:

Icon Height:

Optional. The height of each warhead icon.

• Syntax: Integer
• Units: Pixels

Used by: +Warhead Count:

Max Icons:

Optional. The most warhead icons shown.

• Syntax: Integer

Used by: +Warhead Count:

Max Columns:

Optional. How many warhead icons are drawn in a row before starting the next row.

• Syntax: Integer

Used by: +Warhead Count:

Name Alignment:

Optional. How the weapon name is aligned.

• Syntax: String, left or right (anything else means no alignment)

Used by: +Warhead Count:

Line Width:

Optional. The thickness of the lines the hardpoints are drawn with.

• Syntax: Float

Used by: +Hardpoints:

View Direction:

Optional. The view the ship's hardpoints are shown from: Top or Front.

• Syntax: String

Used by: +Hardpoints:

Show Primary Weapons:

Optional. Shows the primary weapon hardpoints.

• Syntax: Boolean

Used by: +Hardpoints:

Show Secondary Weapons:

Optional. Shows the secondary weapon hardpoints.

• Syntax: Boolean

Used by: +Hardpoints:

First Background Height:

Optional. The height of the first (top) background piece.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

First Background X-offset:

Optional. The horizontal offset of the first (top) background piece.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Entry Background Height:

Optional. The height of the background piece repeated for each weapon.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Entry Background X-offset:

Optional. The horizontal offset of the background piece repeated for each weapon.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Last Background X-offset:

Optional. The horizontal offset of the last (bottom) background piece.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Last Background Y-offset:

Optional. The vertical offset of the last (bottom) background piece, from the end of the list.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

List Start Y-offset:

Optional. The vertical offset where the list of weapons starts.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Ammo X-offset:

Optional. The horizontal offset of the ammo count.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Link X-offset:

Optional. The horizontal offset of the "linked" indicator.

• Syntax: Integer
• Units: Pixels

Used by: +Primary Weapons:, +Secondary Weapons:

Unlink X-offset:

Optional. The horizontal offset of the "not linked" indicator.

• Syntax: Integer
• Units: Pixels

Used by: +Secondary Weapons:

Reload X-offset:

Optional. The horizontal offset of the reload indicator.

• Syntax: Integer
• Units: Pixels

Used by: +Secondary Weapons:

Off Text Color:

Optional. The color of the gauge's text while the setting is off (also accepted as Off Text Colour:).

• Syntax: Integer red, Integer green, Integer blue, Integer alpha, 0 to 255

Used by: +Auto Target:, +Auto Speed: