Difference between revisions of "CombatMFD"

From Elite Wiki
m (Description: edited out typos and grammatical infelicities)
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=== Description ===
+
[[File:CombatMFD1.7.png|thumb|right|600px|The Combat MFD is the top left. The top 4 lines are your status, the next 5 lines are the targets, the 10th line a second target. The top right MFD is from [[Telescope]], showing the closest targets - the bracketed one is the current target]]
 +
== Overview ==
  
If you buy Combat MFD (Multi-Function Display) equipment then your Multi-Function Displays will display much information about your ship:
+
The Combat MFD (Multi-Function Display) displays information about your ship and your enemies.
 +
 
 +
====Information about your ship====
 
*energy and [[#SEE_indicator|SEE indicator]] in the first line,
 
*energy and [[#SEE_indicator|SEE indicator]] in the first line,
 
*forward and aft shields (including [[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]]) then [[#Equipment_indicator|Equipment]] and [[#One-Shot_indicators|One-shot]] indicators,
 
*forward and aft shields (including [[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]]) then [[#Equipment_indicator|Equipment]] and [[#One-Shot_indicators|One-shot]] indicators,
Line 7: Line 10:
 
*the name of the last damaged piece of equipment - and the number of others damaged,
 
*the name of the last damaged piece of equipment - and the number of others damaged,
  
 
+
====Information about your target====
followed by information about your target:
 
 
*name,
 
*name,
*distance and speed,
+
*distance, mass and speed,
 
*shield radius, then Front/Aft orientation display and Damaged!/Weak!/Derelict flag,
 
*shield radius, then Front/Aft orientation display and Damaged!/Weak!/Derelict flag,
 
*laser weapon type and range (after a shot),
 
*laser weapon type and range (after a shot),
Line 16: Line 18:
 
*fired missiles counter with "Hard" flag.
 
*fired missiles counter with "Hard" flag.
  
[[Telescope]] can display the newly detected target in the last line.
+
====More information====
 +
[[Telescope]] can display the most recently detected target in the last line.
  
 +
====Usage & Purchase====
 
Use the ";" and ":" keys to select an MFD and enjoy the view. ;)
 
Use the ";" and ":" keys to select an MFD and enjoy the view. ;)
  
[[File:CombatMFD1.7.png|800px]]
+
*Costs 1,000₢ and is available from TL5 and higher.
 +
 
 +
*See [[MFD]] for more detail on managing MFDs & [[Priming Equipment]] for more details on priming oxp's such as CombatMFD.
  
 +
=== Detail ===
  
 
Compatible with [[Telescope]] OXP (if locking distant targets) and [[Shield_Equalizer_%26_Capacitors_OXP|ShieldEqualizer+Capacitors]] OXP: if shields are over 100% then either [[Shield_Boosters|Shield Boosters]] are installed or Shield Capacitors are also filled.
 
Compatible with [[Telescope]] OXP (if locking distant targets) and [[Shield_Equalizer_%26_Capacitors_OXP|ShieldEqualizer+Capacitors]] OXP: if shields are over 100% then either [[Shield_Boosters|Shield Boosters]] are installed or Shield Capacitors are also filled.
  
The "Damaged!" flag is shown when the target's exhaust plumes are blinking (below 40% energy) and "Weak!" is shown when blinking strongly and sparking too with [http://aegidian.org/bb/viewtopic.php?f=4&t=12507 CustomShields] OXP (below 20%).
+
The "Damaged!" flag is shown when the target's exhaust plumes are blinking (below 40% energy) and "Weak!" is shown when blinking strongly and sparking too with [https://bb.oolite.space/viewtopic.php?f=4&t=12507 CustomShields] OXP (below 20%).
  
 
If your HUD has support for this (like [[Numeric_Style_HUDs|NumericHUDv3.25]]) then you will see these words near your crosshairs too. Such support means the following lines will appear in the legends section of your hud.plist:
 
If your HUD has support for this (like [[Numeric_Style_HUDs|NumericHUDv3.25]]) then you will see these words near your crosshairs too. Such support means the following lines will appear in the legends section of your hud.plist:
Line 34: Line 41:
 
=== SEE indicator ===
 
=== SEE indicator ===
  
The top right corner show letters about how many shields, armour and energy remaining.
+
The top right corner shows letters indicating how many shields, and how much armour and energy are remaining.
Each letter represents 2 energy banks in strength and ordered by from outside to inside.
+
Each letter represents 2 energy banks in strength and is ordered from the outside to the inside.
Small letters mean one side is up only.
+
Small letters indicate that only one side is up.
 
*C: [[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]] (+50%),  
 
*C: [[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]] (+50%),  
 
*M: [[Military_Shield_Enhancement|Military shields]] (300%),
 
*M: [[Military_Shield_Enhancement|Military shields]] (300%),
 
*B: [[Shield_Boosters|Shield Boosters]](200%),
 
*B: [[Shield_Boosters|Shield Boosters]](200%),
 
*S: Shields (100%),
 
*S: Shields (100%),
*A: Armours in [[HardShips]] OXP (front and aft only),
+
*A: Armour in [[HardShips]] OXP (front and aft only),
 
*H: [[IronHide_OXP|IronHide Armour]],
 
*H: [[IronHide_OXP|IronHide Armour]],
 
*E: Energy (EE=4 banks).
 
*E: Energy (EE=4 banks).
  
  
"SEE" mean you have basic Shields (2 banks=128 points) and 2*2 Energy banks filled (4 banks=256 points), as a Cobra Mark III at start.
+
"SEE" indicates that you have basic Shields (2 banks=128 points) and 2*2 Energy banks filled (4 banks=256 points): as a starting Cobra Mark III at Lave.
  
The total length is relative with your ship's defensive strength. The strongest [[Andromeda]] has CCCCCCCCMBSAAAAAAAAHHHEEEEEEEE. :)
+
The total length is relative to your ship's defensive strength. The strongest [[Andromeda]] has CCCCCCCCMBSAAAAAAAAHHHEEEEEEEE. :)
  
A letter will be changed to "-" if drops below the half of the banks represented by this letter so "-E" mean less than 3 banks filled and more than one.
+
A letter will be changed to "-" on dropping below the half of the banks represented by this letter. "-E" indicates that less than three and more than one bank is filled.
  
Underscore "_" mean equipment damage which prevent regeneration, you should fix it in a dock. Checked damages:
+
Underscore "_" indicates equipment damage preventing regeneration: you should fix it when docked. Checked damages:
*[[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]] (includung [[HardShips#Big_Shield_Capacitors|big ones]] in [[HardShips]] OXP),
+
*[[Shield_Equalizer_%26_Capacitors_OXP|Shield Capacitors]] (including [[HardShips#Big_Shield_Capacitors|big ones]] in [[HardShips]] OXP),
 
*[[Military_Shield_Enhancement|Military Shield Enhancement]],
 
*[[Military_Shield_Enhancement|Military Shield Enhancement]],
 
*[[Shield_Boosters|Shield Boosters]],
 
*[[Shield_Boosters|Shield Boosters]],
Line 60: Line 67:
  
  
The number in the corner show the total value in banks (64 points).
+
The number in the corner show the total value in your energy banks (64 points).
 
 
If you see "LAST BANK!" here instead of letters then ... well, you know. (Flee! ;))
 
  
 +
If you see "LAST BANK!" here instead of letters then ... well, ... you know! (Flee! ;))
  
 
=== Equipment indicator ===
 
=== Equipment indicator ===
  
Next to the shield values there are letters which show if the following equipments are installed and turned on:
+
Next to the shield values there are letters which show if the following equipment is installed and primed:
*"ECM" mean [http://aegidian.org/bb/viewtopic.php?f=4&t=9765 Auto ECM] is active,
+
*"ECM" means that [https://bb.oolite.space/viewtopic.php?f=4&t=9765 Auto ECM] is active,
*"Turret" mean [http://bb.aegidian.org/viewtopic.php?f=4&t=13112 Turret Toggler] allow your turrets to fire.
+
*"Turret" means that [https://bb.oolite.space/viewtopic.php?f=4&t=13112 Turret Toggler] allows your turrets to fire.
 
 
  
 
=== One-shot indicator ===
 
=== One-shot indicator ===
  
The space rightwards from shield percentages show letters to indicate one-shot equipments, in order:
+
The space to the right from your shield percentages shows letters to indicate one-shot equipment. In order:
 
*B: [[Energy_Bomb|Energy Bomb]],
 
*B: [[Energy_Bomb|Energy Bomb]],
*C: [[HardShips#Additional_Core_Hull_Equipment|Additional Core Hull]] (this and next from [[HardShips]] OXP),
+
*C: [[HardShips#Additional_Core_Hull_Equipment|Additional Core Hull]] (this and the next from [[HardShips]] OXP),
 
*E: [[HardShips#Emergency_Energy_Generator|Emergency Energy Generator]] ((will be damaged at the second usage if [[HardShips#High-Tech_Catalyst|High-Tech Catalyst]] is installed also),
 
*E: [[HardShips#Emergency_Energy_Generator|Emergency Energy Generator]] ((will be damaged at the second usage if [[HardShips#High-Tech_Catalyst|High-Tech Catalyst]] is installed also),
 
*G: [[Galactic_Hyperdrive|Galactic Hyperdrive]],
 
*G: [[Galactic_Hyperdrive|Galactic Hyperdrive]],
*H: [[HardShips#High-Tech_Catalyst|High-Tech Catalyst]] (from [[HardShips]] OXP, will be damaged at the first usage of Emergency Energy Generator),
+
*H: [[HardShips#High-Tech_Catalyst|High-Tech Catalyst]] (from [[HardShips]] OXP, will be damaged at the first usage of the Emergency Energy Generator),
 
*P: [[Escape_Pod|Escape Pod]],
 
*P: [[Escape_Pod|Escape Pod]],
 
*R: [[HardShips#Renewable_Energy_Generator|Renewable Energy Generator]] (from [[HardShips]] OXP),
 
*R: [[HardShips#Renewable_Energy_Generator|Renewable Energy Generator]] (from [[HardShips]] OXP),
 
*U: [[Energy_Equipment|Emergency Energy Unit]] (from [[Energy_Equipment|Energy Equipment]] OXP),
 
*U: [[Energy_Equipment|Emergency Energy Unit]] (from [[Energy_Equipment|Energy Equipment]] OXP),
  
 +
----
 +
== Custom HUD dials ==
 +
*For a more comprehensible introduction to this, see Phkb's post [https://bb.oolite.space/viewtopic.php?p=289907#p289907 here].
  
 +
*The only HUD which currently (July 2023) uses these custom dials is the [[Vimana HUD]]
  
=== Custom HUD dials ===
+
Oolite v1.81 provides [http://wiki.alioth.net/index.php/Hud.plist#data_source drawCustomText:] a HUD dial displaying information without an MFD.
 
 
Oolite v1.81 provide [http://wiki.alioth.net/index.php/Hud.plist#data_source drawCustomText:] HUD dial which can display informations without MFD.
 
  
You still must buy the CombatMFD equipment for the followings but you must not show up the MFD if your HUD has support for these (like the Large and Small HUDs in [[HUDSelector]]).
+
You still must buy the CombatMFD equipment for the following but you need not display the MFD if your HUD has support for these (such as the Large and Small HUDs which come with [[HUDSelector]]).
  
CombatMFD fill up the following dials with values, so HUD designers can use these:
+
CombatMFD fills up the following dials with values, so HUD designers can use these:
  
  data_source  description
+
  '''Alphabetic order'''                                                                    '''Thematic order''' (target information, then player ship)
  combatAftSh aft shield numeric value, including capacitors
+
'''data_source  description'''                                                        '''data_source  description'''
  combatAftShP aft shield percent value, over 100% if upgraded
+
  combatAftSh aft shield numeric value, including capacitors                     combatSCTDist distance of ''space compass'' target
  combatAlt altitude over the nearest planet, moon or sun in km
+
  combatAftShP aft shield percent value, over 100% if upgraded                     combatNewTelT name of the ''newest target detected by Telescope''
  combatAltR altitude over a planet, moon or sun in radius
+
  combatAlt altitude over the nearest planet, moon or sun in km                 combatTName full name of the current target
  combatCredits credits of player
+
  combatAltR altitude over a planet, moon or sun in radius                       combatTDist distance of the current target
  combatCTemp cabin temp
+
  combatCredits credits of player                                                   combatTSpeed speed of the current target
  combatDmgEq name of the lastly damaged equipment
+
  combatCTemp cabin temperature                                                  combatTRadius shield radius of the current target
  combatDEqNum number of the damaged equipments
+
  combatDmgEq name of the last damaged piece of equipment                         combatTEnergy energy of the current target, use for debug only
  combatEnergy energy of player ship in numeric form
+
  combatDEqNum number of damaged pieces of equipment                              combatTDmg damaged/weak/derelict status of the current target
  combatEnergyP energy of player ship in percent
+
  combatEnergy energy of player ship in numeric form                               combatTLaser laser weapon of the current target
  combatFwSh forward shield numeric value, including capacitors
+
  combatEnergyP energy of player ship in percent                                   combatTLRange range of the target's laser weapon
  combatFwShP forward shield percent value, over 100% if upgraded
+
  combatFwSh forward shield numeric value, including capacitors                 combatTMissNum number of missiles fired by the target so far
  combatFuel remaining fuel in the main tank in ly, min. 0.0, max. 7.0
+
  combatFwShP forward shield percent value, over 100% if upgraded                 combatTMissile missile type fired by the target: Normal/Hard/Unknown
  combatFuelReq required fuel of a declared hyperjump
+
  combatFuel remaining fuel in the main tank in ly (min. 0.0, max. 7.0)        combatTLegal legal status of the current target (or Towbar status)
  combatFuelRes reserve fuel in extra tanks (integer)
+
  combatFuelReq required fuel of a declared hyperjump                               combatAlt altitude over the nearest planet, moon or sun in km
  combatLegal legal status of player, Clean/Offender/Fugitive
+
  combatFuelRes reserve fuel in extra tanks (integer)                               combatAltR altitude over a planet, moon or sun in radius
  combatLegalNum legal status of player, bounty
+
  combatLegal legal status of player (Clean/Offender/Fugitive)                    combatFwSh forward shield numeric value, including capacitors
  combatNewTelT name of the newest target detected by Telescope
+
  combatLegalNum legal status of player, bounty                                     combatFwShP forward shield percent value, over 100% if upgraded
  combatOneShot letters of One-shot indicator (BCEGHPRU)
+
  combatNewTelT name of the newest target detected by Telescope                     combatAftSh aft shield numeric value, including capacitors
  combatSCTDist distance of space compass target
+
  combatOneShot letters of one-shot equipment indicator (BCEGHPRU as above)         combatAftShP aft shield percent value, over 100% if upgraded
  combatSEE letters of SEE indicator about the player ship (CMBSAHE)
+
  combatSCTDist distance of space compass target                                   combatEnergy energy of player ship in numeric form
  combatSEEMax maximum number of ship durability: max of shield+armour+energy
+
  combatSEE letters of SEE indicator about the player ship (CMBSAHE)           combatEnergyP energy of player ship in percent
  combatSEENum number of ship durability: shield+armour+energy
+
  combatSEEMax maximum number of ship durability: max of shield+armour+energy     combatSEEMax maximum # of ship durability (shield+armour+energy)
  combatSpeed actual speed of player ship in m/s
+
  combatSEENum number of ship durability: shield+armour+energy                     combatSEENum # of ship durability (shield+armour+energy)
  combatTDist distance of the current target
+
  combatSpeed actual speed of player ship in m/s                                 combatSEE letters of SEE indicator for player ship (CMBSAHE)
  combatTDmg damaged/weak/derelict status of the current target
+
  combatTDist distance of the current target                                     combatDmgEq name of the last damaged piece of equipment
  combatTEnergy energy of the current target, use for debug only
+
  combatTDmg damaged/weak/derelict status of the current target                 combatDEqNum number of damaged pieces of equipment
  combatTLaser laser weapon of the current target
+
  combatTEnergy energy of the current target, use for debug only                   combatOneShot letters of one-shot equipment indicator (BCEGHPRU)
  combatTLegal legal status of the current target, if derelict then Towbar status
+
  combatTLaser laser weapon of the current target                                 combatFuel remaining fuel in main tank (ly: min. 0.0, max. 7.0)
  combatTLRange range of the target's laser weapon
+
  combatTLegal legal status of the current target, if derelict then Towbar status combatFuelRes reserve fuel in extra tanks (integer)
  combatTMissile missile type fired by the target, Normal/Hard/Unknown
+
  combatTLRange range of the target's laser weapon                                 combatFuelReq required fuel of a declared hyperjump
  combatTMissNum number of missiles fired by the target so far
+
  combatTMissile missile type fired by the target, Normal/Hard/Unknown               combatSpeed actual speed of player ship in m/s
  combatTName full name of the current target
+
  combatTMissNum number of missiles fired by the target so far                       combatCTemp cabin temperature
  combatTRadius shield radius of the current target
+
  combatTName full name of the current target                                     combatCredits credits of player
  combatTSpeed speed of the current target
+
  combatTRadius shield radius of the current target                                 combatLegal legal status of player (Clean/Offender/Fugitive)
 +
  combatTSpeed speed of the current target                                         combatLegalNum legal status of player, bounty
 +
 +
The '''current target''' is that which has been targeted on the [[View Screen]] (visible if [[STE]] is installed), the '''space compass target''' is that of the [[Compass]] (or the [[ASC]]), the Telescope "targets" are those listed on the [[Telescope]] MFD
  
Numeric values are centered in a 28 character wide field by default, texts are left aligned (you can align to right in hud plist with [http://wiki.alioth.net/index.php/Hud.plist#align align=1]).
+
Numeric values are centered in a 28 character wide field by default, texts are left aligned (you can align to right in a hud plist with [http://wiki.alioth.net/index.php/Hud.plist#align align=1]).
  
 
The default width of centered fields is adjustable in the worldScripts.combat_MFD.$DW variable.
 
The default width of centered fields is adjustable in the worldScripts.combat_MFD.$DW variable.
  
If $DW is 0 then all field will be left aligned.
+
If $DW is 0, then all fields will be left aligned.
  
If $DW negative then right aligned in the given width.
+
If $DW is negative, then right aligned in the given width.
  
  
Line 149: Line 159:
 
  combatSLBar service level bar of player ship
 
  combatSLBar service level bar of player ship
  
See [http://aegidian.org/bb/viewtopic.php?f=6&t=17776&start=30#p242909 this example] how to add a service level bar into your HUD.
+
See [https://bb.oolite.space/viewtopic.php?f=6&t=17776&start=30#p242909 this example] to add a service level bar to your HUD (the yellow "hull" bar below in the left middle of the HUD) - see [[Maintenance]].
  
  
Line 156: Line 166:
  
  
For example the speed value need the following code in the dials section in the plist of HUD:
+
For example the speed value needs the following code in the dials section in the plist of your HUD:
 
  {
 
  {
 
  data_source = "combatSpeed";
 
  data_source = "combatSpeed";
Line 170: Line 180:
  
  
OXP developers can reach all data in worldScripts.combat_MFD.$Data object using the same data_soucre key names, so for speed use $Data.combatSpeed .
+
OXP developers can reach all data in worldScripts.combat_MFD.$Data object using the same data_source key names, so for speed use $Data.combatSpeed .
  
 
The access of worldScript name is slow, so you should get a pointer once in startUp:
 
The access of worldScript name is slow, so you should get a pointer once in startUp:
Line 199: Line 209:
 
  }
 
  }
  
=== Dependencies ===
+
----
 +
 
 +
== Dependencies ==
  
 
Oolite 1.79 or later.
 
Oolite 1.79 or later.
  
=== Instructions ===
+
== Instructions ==
  
 
Do not unzip the .oxz file, just move into the AddOns folder of your Oolite installation.
 
Do not unzip the .oxz file, just move into the AddOns folder of your Oolite installation.
  
=== License ===
+
== License ==
  
 
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 4.0.
 
This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 4.0.
 
If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite@gmail.com.
 
If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite@gmail.com.
  
=== Downloads ===
+
== Downloads ==
 
+
*[[Media:CombatMFD-1.19.oxz|Combat MFD v1.19]]
[[Media:CombatMFD_1.12.oxz|Combat MFD v1.12]] (downloaded {{#downloads:CombatMFD_1.12.oxz}} times).
+
*[[Media:CombatMFD-1.18.oxz|Combat MFD v1.18]]
 
+
*[[Media:CombatMFD-1.17.oxz|Combat MFD v1.17]]
[[Media:CombatMFD_1.11.oxz|Combat MFD v1.11]] (downloaded {{#downloads:CombatMFD_1.11.oxz}} times).
+
*[[Media:CombatMFD-1.16.oxz|Combat MFD v1.16]]
 
+
*[[Media:CombatMFD-1.15.oxz|Combat MFD v1.15]]
[[Media:CombatMFD_1.10.oxz|Combat MFD v1.10]] (downloaded {{#downloads:CombatMFD_1.10.oxz}} times).
+
*[[Media:CombatMFD-1.14.oxz|Combat MFD v1.14]]
 
+
*[[Media:CombatMFD-1.13.oxz|Combat MFD v1.13]]
[[Media:CombatMFD_1.9.oxz|Combat MFD v1.9]] (downloaded {{#downloads:CombatMFD_1.9.oxz}} times).
+
*[[Media:CombatMFD_1.12.oxz|Combat MFD v1.12]] (downloaded {{#downloads:CombatMFD_1.12.oxz}} times).
 
+
*[[Media:CombatMFD_1.11.oxz|Combat MFD v1.11]] (downloaded {{#downloads:CombatMFD_1.11.oxz}} times).
[[Media:CombatMFD_1.8.oxz|Combat MFD v1.8]] (downloaded {{#downloads:CombatMFD_1.8.oxz}} times).
+
*[[Media:CombatMFD_1.10.oxz|Combat MFD v1.10]] (downloaded {{#downloads:CombatMFD_1.10.oxz}} times).
 
+
*[[Media:CombatMFD_1.9.oxz|Combat MFD v1.9]] (downloaded {{#downloads:CombatMFD_1.9.oxz}} times).
[[Media:CombatMFD_1.7.oxz|Combat MFD v1.7]] (downloaded {{#downloads:CombatMFD_1.7.oxz}} times).
+
*[[Media:CombatMFD_1.8.oxz|Combat MFD v1.8]] (downloaded {{#downloads:CombatMFD_1.8.oxz}} times).
 
+
*[[Media:CombatMFD_1.7.oxz|Combat MFD v1.7]] (downloaded {{#downloads:CombatMFD_1.7.oxz}} times).
[[Media:CombatMFD_1.6.oxz|Combat MFD v1.6]] (downloaded {{#downloads:CombatMFD_1.6.oxz}} times).
+
*[[Media:CombatMFD_1.6.oxz|Combat MFD v1.6]] (downloaded {{#downloads:CombatMFD_1.6.oxz}} times).
 
+
*[[Media:CombatMFD_1.5.oxz|Combat MFD v1.5]] (downloaded {{#downloads:CombatMFD_1.5.oxz}} times).
[[Media:CombatMFD_1.5.oxz|Combat MFD v1.5]] (downloaded {{#downloads:CombatMFD_1.5.oxz}} times).
+
*[[Media:CombatMFD_1.4.oxz|Combat MFD v1.4]] (downloaded {{#downloads:CombatMFD_1.4.oxz}} times).
 
+
*[[Media:CombatMFD_1.3.oxz|Combat MFD v1.3]] (downloaded {{#downloads:CombatMFD_1.3.oxz}} times).
[[Media:CombatMFD_1.4.oxz|Combat MFD v1.4]] (downloaded {{#downloads:CombatMFD_1.4.oxz}} times).
+
*[[Media:CombatMFD_1.2.oxz|Combat MFD v1.2]] (downloaded {{#downloads:CombatMFD_1.2.oxz}} times).
 
+
*[[Media:CombatMFD_1.1.oxz|Combat MFD v1.1]] (downloaded {{#downloads:CombatMFD_1.1.oxz}} times).
[[Media:CombatMFD_1.3.oxz|Combat MFD v1.3]] (downloaded {{#downloads:CombatMFD_1.3.oxz}} times).
+
*[[Media:CombatMFD_1.0.oxz|Combat MFD v1.0]] (downloaded {{#downloads:CombatMFD_1.0.oxz}} times).
 
 
[[Media:CombatMFD_1.2.oxz|Combat MFD v1.2]] (downloaded {{#downloads:CombatMFD_1.2.oxz}} times).
 
 
 
[[Media:CombatMFD_1.1.oxz|Combat MFD v1.1]] (downloaded {{#downloads:CombatMFD_1.1.oxz}} times).
 
 
 
[[Media:CombatMFD_1.0.oxz|Combat MFD v1.0]] (downloaded {{#downloads:CombatMFD_1.0.oxz}} times).
 
  
=== Forum ===
+
== Forum ==
  
Make your comments in [http://aegidian.org/bb/viewtopic.php?f=4&t=16617 this topic].
+
Make your comments in [https://bb.oolite.space/viewtopic.php?f=4&t=16617 this topic].
  
  
=== Changelog ===
+
== Changelog ==
 +
2024.04.18. v1.19 Added closure in $showCombatInfo function.
 +
                  Limited altimeter value to 3 decimal places when less than 1km.
 +
2024.02.24. v1.18 Small code tweaks.
 +
2023.10.24. v1.17 Better handling of Shield Cycler (previous version).
 +
                  Correct player speed value display when FICC in use.
 +
2023.10.22. v1.16 Hide compass distance for Manual Witchspace Alignment jump target.
 +
2023.10.15. v1.15 Speed values are taken directly from entity speed property when below the maxspeed value.
 +
2020.11.23. v1.14 Adds target's mass to MFD.
 +
2020.11.18. v1.13 Shows Shield Cycler mode (Equal, Forward, Aft or Disabled).
 
  2015.10.03. v1.12 Show Auto ECM and Turret Toggler active status if installed.
 
  2015.10.03. v1.12 Show Auto ECM and Turret Toggler active status if installed.
 
                   Do not display 0 as bounty and damaged equipments if none.
 
                   Do not display 0 as bounty and damaged equipments if none.
                   Fixed a bug if both HardShips and IronHide Armour is installed.
+
                   Fixed a bug if both HardShips and IronHide Armour are installed.
 
  2015.05.18. v1.11 Speed formula updated for time forwarding in [[TorusToSun]] v1.5.
 
  2015.05.18. v1.11 Speed formula updated for time forwarding in [[TorusToSun]] v1.5.
 
  2015.01.08. v1.10 Small fix of a harmless message in Oolite 1.80, thanks to phkb.
 
  2015.01.08. v1.10 Small fix of a harmless message in Oolite 1.80, thanks to phkb.
 
  2014.10.20. v1.9  Custom dials of player always calculated, dials of target need the equipment.
 
  2014.10.20. v1.9  Custom dials of player always calculated, dials of target need the equipment.
 
                   Altitude custom dial in km added.
 
                   Altitude custom dial in km added.
  2014.10.16. v1.8  HUD dials added, need Oolite 1.81 and support in HUD plist.
+
  2014.10.16. v1.8  HUD dials added, needing Oolite 1.81 and support in HUD plist.
  2014.10.11. v1.7  [[Telescope]] display the newest detected target in the last line.
+
  2014.10.11. v1.7  [[Telescope]] displays the newest detected target in the last line.
 
                   Fuel display counts additional FuelTank, DuplexFuelTank, ExtraFuelTanks and
 
                   Fuel display counts additional FuelTank, DuplexFuelTank, ExtraFuelTanks and
                   the reserve fuel of [[Andromeda]] also.
+
                   the reserve fuel of [[Andromeda]] as well.
 
                   Better energy feedback for ships with a single energy bank.
 
                   Better energy feedback for ships with a single energy bank.
 
  2014.08.11. v1.6  Damaged, Weak and Derelict display on HUDs with support for this feature.
 
  2014.08.11. v1.6  Damaged, Weak and Derelict display on HUDs with support for this feature.
 
                   Show FW instead of 8x when TorusToSun use time forwarding at max. speed.
 
                   Show FW instead of 8x when TorusToSun use time forwarding at max. speed.
  2014.07.24. v1.5  Equipment cost raised to 1000cr due to the [http://aegidian.org/bb/viewtopic.php?f=2&t=16702 MFD pricing thread].
+
  2014.07.24. v1.5  Equipment cost raised to 1000cr due to the [https://bb.oolite.space/viewtopic.php?f=2&t=16702 MFD pricing thread].
 
                   Show Torus multiplier after player speed if Torus To Sun is installed.
 
                   Show Torus multiplier after player speed if Torus To Sun is installed.
 
                   Line length fine tune with hair spaces, thanks to spara.
 
                   Line length fine tune with hair spaces, thanks to spara.
Line 268: Line 283:
 
                   Energy and Shields percents are rounded to 10 for better readability.
 
                   Energy and Shields percents are rounded to 10 for better readability.
 
                   Target Front/Aft orientation display.
 
                   Target Front/Aft orientation display.
                   Speed display use velocity for Q-Charger.
+
                   Speed display uses velocity for Q-Charger.
 
                   A fix against garbage-collected timer in log.
 
                   A fix against garbage-collected timer in log.
  2014.07.07. v1.3  Informations added in top right and bottom right corners.
+
  2014.07.07. v1.3  Information added in top and bottom right hand corners.
                   Speed labels removed to prevent twithcing.
+
                   Speed labels removed to prevent twitching.
                   A small fix about Telescope far targets.
+
                   A small fix about Telescope's distant targets.
  2014.07.06. v1.2  Show the name of the lastly damaged equipment.
+
  2014.07.06. v1.2  Show the name of the most recent damaged piece of equipment.
 
                   Show the target's laser type and range after a shot.
 
                   Show the target's laser type and range after a shot.
                   Energy and Shields are displayed in percents only.
+
                   Energy and Shields are displayed in percentages only.
  2014.07.05. v1.1  Must buy Combat MFD as an equipment.
+
  2014.07.05. v1.1  Must buy Combat MFD as equipment.
                   Legal status display need Scanner Targeting Enhancement.
+
                   Legal status display now needs Scanner Targeting Enhancement.
                   Show Telescope far target names without km.
+
                   Show Telescope distant target names without km.
 
                   Can show Empty, Mined and Usable ship status with Towbar.
 
                   Can show Empty, Mined and Usable ship status with Towbar.
 
                   Wormhole target supported with Wormhole Scanner equipment.
 
                   Wormhole target supported with Wormhole Scanner equipment.
  2014.07.02. v1.0  More info displayed by Norby.
+
  2014.07.02. v1.0  Some more information displayed by Norby.
  2014.06.30. v0.1  Some info displayed by Zireael.
+
  2014.06.30. v0.1  Some information displayed by Zireael.
 
 
  
 
==Quick Facts==
 
==Quick Facts==
 
{{OXPLevel|0}}{{Infobox OXPb| title = Combat MFD
 
{{OXPLevel|0}}{{Infobox OXPb| title = Combat MFD
|version = 1.12
+
|version = 1.19
|release = 2015-10-03
+
|release = 2024-04-19
 
|features = Data about your ship and your target
 
|features = Data about your ship and your target
 
|license = CC BY-NC-SA 4
 
|license = CC BY-NC-SA 4
 
|category = HUDs OXPs
 
|category = HUDs OXPs
 
|author = [[User:Norby|Norby]]
 
|author = [[User:Norby|Norby]]
|feedback = [http://bb.aegidian.org/viewtopic.php?f=4&t=16617 BB-Link]
+
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=16617 BB-Link]
 
}}
 
}}
 +
 +
 +
== Gameplay and Balance Indicator ==
 +
[[File:Tag-colour-blue.png|right]]
 +
Vital information about your target's shields, lasers, missiles fired ''etc''.

Latest revision as of 03:18, 19 April 2024

The Combat MFD is the top left. The top 4 lines are your status, the next 5 lines are the targets, the 10th line a second target. The top right MFD is from Telescope, showing the closest targets - the bracketed one is the current target

Overview

The Combat MFD (Multi-Function Display) displays information about your ship and your enemies.

Information about your ship

Information about your target

  • name,
  • distance, mass and speed,
  • shield radius, then Front/Aft orientation display and Damaged!/Weak!/Derelict flag,
  • laser weapon type and range (after a shot),
  • status: Clean/Offender/Fugitive, if derelict then Trap or Treasure/Empty/Mined/Usable (see Towbar OXP).
  • fired missiles counter with "Hard" flag.

More information

Telescope can display the most recently detected target in the last line.

Usage & Purchase

Use the ";" and ":" keys to select an MFD and enjoy the view. ;)

  • Costs 1,000₢ and is available from TL5 and higher.
  • See MFD for more detail on managing MFDs & Priming Equipment for more details on priming oxp's such as CombatMFD.

Detail

Compatible with Telescope OXP (if locking distant targets) and ShieldEqualizer+Capacitors OXP: if shields are over 100% then either Shield Boosters are installed or Shield Capacitors are also filled.

The "Damaged!" flag is shown when the target's exhaust plumes are blinking (below 40% energy) and "Weak!" is shown when blinking strongly and sparking too with CustomShields OXP (below 20%).

If your HUD has support for this (like NumericHUDv3.25) then you will see these words near your crosshairs too. Such support means the following lines will appear in the legends section of your hud.plist:

{ equipment_required="EQ_DTADAM"; x=30; y=40; y_origin=0; height=20; width=16; text="Damaged"; alpha=0.5; },
{ equipment_required="EQ_DTAWEA"; x=30; y=40; y_origin=0; height=20; width=16; text="Weak"; alpha=0.5; },
{ equipment_required="EQ_DTADER"; x=30; y=40; y_origin=0; height=20; width=16; text="Derelict"; },

SEE indicator

The top right corner shows letters indicating how many shields, and how much armour and energy are remaining. Each letter represents 2 energy banks in strength and is ordered from the outside to the inside. Small letters indicate that only one side is up.


"SEE" indicates that you have basic Shields (2 banks=128 points) and 2*2 Energy banks filled (4 banks=256 points): as a starting Cobra Mark III at Lave.

The total length is relative to your ship's defensive strength. The strongest Andromeda has CCCCCCCCMBSAAAAAAAAHHHEEEEEEEE. :)

A letter will be changed to "-" on dropping below the half of the banks represented by this letter. "-E" indicates that less than three and more than one bank is filled.

Underscore "_" indicates equipment damage preventing regeneration: you should fix it when docked. Checked damages:


The number in the corner show the total value in your energy banks (64 points).

If you see "LAST BANK!" here instead of letters then ... well, ... you know! (Flee! ;))

Equipment indicator

Next to the shield values there are letters which show if the following equipment is installed and primed:

One-shot indicator

The space to the right from your shield percentages shows letters to indicate one-shot equipment. In order:


Custom HUD dials

  • For a more comprehensible introduction to this, see Phkb's post here.
  • The only HUD which currently (July 2023) uses these custom dials is the Vimana HUD

Oolite v1.81 provides drawCustomText: a HUD dial displaying information without an MFD.

You still must buy the CombatMFD equipment for the following but you need not display the MFD if your HUD has support for these (such as the Large and Small HUDs which come with HUDSelector).

CombatMFD fills up the following dials with values, so HUD designers can use these:

Alphabetic order                                                                    Thematic order	(target information, then player ship)
data_source   	description                                                         data_source   	description
combatAftSh	aft shield numeric value, including capacitors                      combatSCTDist	distance of space compass target
combatAftShP	aft shield percent value, over 100% if upgraded                     combatNewTelT	name of the newest target detected by Telescope
combatAlt	altitude over the nearest planet, moon or sun in km                 combatTName		full name of the current target
combatAltR	altitude over a planet, moon or sun in radius                       combatTDist 	distance of the current target
combatCredits	credits of player                                                   combatTSpeed	speed of the current target
combatCTemp	cabin temperature                                                   combatTRadius 	shield radius of the current target
combatDmgEq	name of the last damaged piece of equipment                         combatTEnergy 	energy of the current target, use for debug only
combatDEqNum	number of damaged pieces of equipment                               combatTDmg 		damaged/weak/derelict status of the current target
combatEnergy	energy of player ship in numeric form                               combatTLaser	laser weapon of the current target
combatEnergyP	energy of player ship in percent                                    combatTLRange	range of the target's laser weapon
combatFwSh	forward shield numeric value, including capacitors                  combatTMissNum	number of missiles fired by the target so far
combatFwShP 	forward shield percent value, over 100% if upgraded                 combatTMissile	missile type fired by the target: Normal/Hard/Unknown
combatFuel 	remaining fuel in the main tank in ly  (min. 0.0, max. 7.0)         combatTLegal	legal status of the current target (or Towbar status)
combatFuelReq	required fuel of a declared hyperjump                               combatAlt		altitude over the nearest planet, moon or sun in km
combatFuelRes 	reserve fuel in extra tanks (integer)                               combatAltR		altitude over a planet, moon or sun in radius
combatLegal	legal status of player (Clean/Offender/Fugitive)                    combatFwSh		forward shield numeric value, including capacitors
combatLegalNum	legal status of player, bounty                                      combatFwShP 	forward shield percent value, over 100% if upgraded
combatNewTelT	name of the newest target detected by Telescope                     combatAftSh		aft shield numeric value, including capacitors
combatOneShot	letters of one-shot equipment indicator (BCEGHPRU as above)         combatAftShP	aft shield percent value, over 100% if upgraded
combatSCTDist	distance of space compass target                                    combatEnergy	energy of player ship in numeric form
combatSEE	letters of SEE indicator about the player ship (CMBSAHE)            combatEnergyP	energy of player ship in percent
combatSEEMax	maximum number of ship durability: max of shield+armour+energy      combatSEEMax	maximum # of ship durability (shield+armour+energy)
combatSEENum	number of ship durability: shield+armour+energy                     combatSEENum	# of ship durability (shield+armour+energy)
combatSpeed	actual speed of player ship in m/s                                  combatSEE		letters of SEE indicator for player ship (CMBSAHE)
combatTDist 	distance of the current target                                      combatDmgEq		name of the last damaged piece of equipment
combatTDmg 	damaged/weak/derelict status of the current target                  combatDEqNum	number of damaged pieces of equipment
combatTEnergy 	energy of the current target, use for debug only                    combatOneShot	letters of one-shot equipment indicator (BCEGHPRU)
combatTLaser	laser weapon of the current target                                  combatFuel 		remaining fuel in main tank (ly: min. 0.0, max. 7.0)
combatTLegal	legal status of the current target, if derelict then Towbar status  combatFuelRes 	reserve fuel in extra tanks (integer)
combatTLRange	range of the target's laser weapon                                  combatFuelReq	required fuel of a declared hyperjump
combatTMissile	missile type fired by the target, Normal/Hard/Unknown               combatSpeed		actual speed of player ship in m/s
combatTMissNum	number of missiles fired by the target so far                       combatCTemp		cabin temperature
combatTName	full name of the current target                                     combatCredits	credits of player
combatTRadius 	shield radius of the current target                                 combatLegal		legal status of player (Clean/Offender/Fugitive)
combatTSpeed	speed of the current target                                         combatLegalNum	legal status of player, bounty

The current target is that which has been targeted on the View Screen (visible if STE is installed), the space compass target is that of the Compass (or the ASC), the Telescope "targets" are those listed on the Telescope MFD

Numeric values are centered in a 28 character wide field by default, texts are left aligned (you can align to right in a hud plist with align=1).

The default width of centered fields is adjustable in the worldScripts.combat_MFD.$DW variable.

If $DW is 0, then all fields will be left aligned.

If $DW is negative, then right aligned in the given width.


Using the drawCustomBar: selector HUDs can give graphical feedback about the following values:

data_source   	description
combatAftShBar	aft shield bar including capacitors
combatCargoBar	how filled the cargo bay of player ship
combatFwShBar	forward shield bar including capacitors
combatSEEBar	total durability bar of player ship based on the SEE indicator
combatSLBar	service level bar of player ship

See this example to add a service level bar to your HUD (the yellow "hull" bar below in the left middle of the HUD) - see Maintenance.


Original and Large HUDs use many custom dials (available in HUDSelector): CombatMFD1.9.png


For example the speed value needs the following code in the dials section in the plist of your HUD:

{
	data_source = "combatSpeed";
	selector = "drawCustomText:";
//	alert_conditions = 2; //uncomment if you want to see in green alert only
	alpha = 1.0;
	height = 13;
	width = 15;
	x = 151;
	y = 87;
	y_origin = -1;
},


OXP developers can reach all data in worldScripts.combat_MFD.$Data object using the same data_source key names, so for speed use $Data.combatSpeed .

The access of worldScript name is slow, so you should get a pointer once in startUp:

this.startUp = function() {
	this.$combatWS = worldScripts.combat_MFD; //slow access for the pointer, one time only
}
this.$displaySpeed = function() {
	if( this.$combatWS ) //must check CombatMFD existence to prevent an error
		player.consoleMessage( this.$combatWS.$Data.combatSpeed ); //fast access
	else log(this.name, "Can not display speed value, CombatMFD OXP is missing");
}


The $DataArray contain all available data_source keys.

this.$combatKeyIsExists = function( key ) {
	if( this.$combatWS && this.$combatWS.$DataArray.indexOf( key ) > -1 )
		return true;
	else return false;
}


The $DataShow can disable the display of any data in the HUD:

this.$disableKey = function(combatKey) {
	if( this.$combatWS ) this.$combatWS.$DataShow[combatKey] = false;
}

Dependencies

Oolite 1.79 or later.

Instructions

Do not unzip the .oxz file, just move into the AddOns folder of your Oolite installation.

License

This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 4.0. If you are re-using any piece of this OXP, please let me know by sending an e-mail to norbylite@gmail.com.

Downloads

Forum

Make your comments in this topic.


Changelog

2024.04.18. v1.19 Added closure in $showCombatInfo function.
                  Limited altimeter value to 3 decimal places when less than 1km.
2024.02.24. v1.18 Small code tweaks.
2023.10.24. v1.17 Better handling of Shield Cycler (previous version). 
                  Correct player speed value display when FICC in use.
2023.10.22. v1.16 Hide compass distance for Manual Witchspace Alignment jump target.
2023.10.15. v1.15 Speed values are taken directly from entity speed property when below the maxspeed value.
2020.11.23. v1.14 Adds target's mass to MFD.
2020.11.18. v1.13 Shows Shield Cycler mode (Equal, Forward, Aft or Disabled).
2015.10.03. v1.12 Show Auto ECM and Turret Toggler active status if installed.
                  Do not display 0 as bounty and damaged equipments if none.
                  Fixed a bug if both HardShips and IronHide Armour are installed.
2015.05.18. v1.11 Speed formula updated for time forwarding in TorusToSun v1.5.
2015.01.08. v1.10 Small fix of a harmless message in Oolite 1.80, thanks to phkb.
2014.10.20. v1.9  Custom dials of player always calculated, dials of target need the equipment.
                  Altitude custom dial in km added.
2014.10.16. v1.8  HUD dials added, needing Oolite 1.81 and support in HUD plist.
2014.10.11. v1.7  Telescope displays the newest detected target in the last line.
                  Fuel display counts additional FuelTank, DuplexFuelTank, ExtraFuelTanks and
                  the reserve fuel of Andromeda as well.
                  Better energy feedback for ships with a single energy bank.
2014.08.11. v1.6  Damaged, Weak and Derelict display on HUDs with support for this feature.
                  Show FW instead of 8x when TorusToSun use time forwarding at max. speed.
2014.07.24. v1.5  Equipment cost raised to 1000cr due to the MFD pricing thread.
                  Show Torus multiplier after player speed if Torus To Sun is installed.
                  Line length fine tune with hair spaces, thanks to spara.
2014.07.09. v1.4  SEE and One shot indicators added.
                  Player legal status added.
                  Missile counter with "Hard" flag added.
                  Energy and Shields percents are rounded to 10 for better readability.
                  Target Front/Aft orientation display.
                  Speed display uses velocity for Q-Charger.
                  A fix against garbage-collected timer in log.
2014.07.07. v1.3  Information added in top and bottom right hand corners.
                  Speed labels removed to prevent twitching.
                  A small fix about Telescope's distant targets.
2014.07.06. v1.2  Show the name of the most recent damaged piece of equipment.
                  Show the target's laser type and range after a shot.
                  Energy and Shields are displayed in percentages only.
2014.07.05. v1.1  Must buy Combat MFD as equipment.
                  Legal status display now needs Scanner Targeting Enhancement.
                  Show Telescope distant target names without km.
                  Can show Empty, Mined and Usable ship status with Towbar.
                  Wormhole target supported with Wormhole Scanner equipment.
2014.07.02. v1.0  Some more information displayed by Norby.
2014.06.30. v0.1  Some information displayed by Zireael.

Quick Facts

Levelindicator0.png
0-{{{2}}}
Version Released License Features Category Author(s) Feedback
1.19 2024-04-19 CC BY-NC-SA 4 Data about your ship and your target HUDs OXPs Norby BB-Link


Gameplay and Balance Indicator

Tag-colour-blue.png

Vital information about your target's shields, lasers, missiles fired etc.