Howto:Implement aerial refueling capability: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
m (Robot: Cosmetic changes)
(Small cleanup)
Line 2: Line 2:


== Receiver aircraft ==
== Receiver aircraft ==
Add the following blocks of code to your aircraft's -set.xml file (all after the </sim> tag). Make sure to check for pre-existing blocks/structures and leave them intact. The radar is needed to check if you are close enough from the tanker, the refuel part tell wich type of refueling you are capable of, and if your refuel system is ok to receive (use the serviceable property if you have a switch to open the refuel trap for exemple). The aar.nas check if you're close enough , if you have the same type,and if yes refuel your tanks.
Add the following blocks of code to your aircraft's -set.xml file (all after the </sim> tag). Make sure to check for pre-existing blocks/structures and leave them intact.  


* Radar is needed to check if you are close enough from the tanker
* Refuel defines what type of refueling you are capable of, and if your refuel system is ok to receive (use the serviceable property if you have a switch to open the refuel trap for example).
* aar.nas is the actual system that checks the two above mentioned criteria and if both are true, refuels your tanks.
<syntaxhighlight lang="xml">
  <instrumentation>
  <instrumentation>
   <radar>
   <radar>
Line 23: Line 28:
   </aar>
   </aar>
  </nasal>
  </nasal>
</syntaxhighlight>


The aircraft can receive fuel from the KA6 with the above code. To receive fuel from the [[KC-135]], replace 'probe' with 'boom'.
The aircraft can receive fuel from the KA6 with the above code. To receive fuel from the [[KC-135]], replace 'probe' with 'boom'.


== Tanker aircraft ==
== Tanker aircraft ==
To allow your plane to be used as a tanker by others players, you only need to add the following blocks of code to your aircraft's model .xml file (usually located in <tt>Aircraft/.../Models/</tt>):
To allow your plane to be used as a tanker by others players, you only need to add the following blocks of code to your aircraft's model .xml file (usually located in <tt>Aircraft/.../Models/</tt>):


<syntaxhighlight lang="xml">
  <multiplay>
  <multiplay>
   <refuel>
   <refuel>
Line 35: Line 41:
   </refuel>
   </refuel>
  </multiplay>
  </multiplay>
</syntaxhighlight>


Replace 'probe' with 'boom' in the files for a boom-equipped tanker, This influences what aircraft can receive fuel! Or give the two lines if the tanker get both a boom and probes (like recent kc135) in this case you will be able to refuel both type of aircraft.
Replace 'probe' with 'boom' in the files for a boom-equipped tanker. This influences what aircraft can receive fuel! Or give the two lines if the tanker get both a boom and probes (like recent kc135) in this case you will be able to refuel both type of aircraft.  
You can add the refueling capability to your tanker too, with the lines above for receiver aircraft.
For the moment, flyable tankers are: KC135, victor and KC130 (in c130 folder) if you need an exemple.


== Tankers with git version after the 1 september 2010 ==
For the moment, flyable tankers are: KC135, victor and KC130 (in <tt>Aircraft/c130</tt>) if you need an example.


with the FG 2.0 version and before, the refueling is possible only if the tanker use a "MOBIL" callsign. The current git FG change this, allowing any callsign to be a tanker, and the tanker property is now transmitted by mp, permitting for exemple to prevent refueling if the refueling probe is not operational.
=== Serviceable option ===
With FlightGear 2.0.0 and older, refueling is possible only if the tanker uses a "MOBIL" callsign (eg. MOBIL3). Later releases of FlightGear (and Git), allow any callsign to be a tanker. Besides that, the tanker property is now transmitted over multiplayer, permitting for example to prevent refueling if the refueling probe is not operational.


for this to work, add the following code in your aircraft's -set file (be sure not to be in another block):
For this to work, add the following code in your aircraft's -set file (be sure not to be in another block):


  <tanker type="bool">false</tanker>
  <tanker type="bool">false</tanker>


and now switch this property true or false to allow following aircraft to refuel or not.
Switch this property true or false to allow following aircraft to refuel or not.


[[Category:Aircraft enhancement|Implement aerial refueling capability]]
[[Category:Aircraft enhancement|Implement aerial refueling capability]]
[[Category:Howto|Implement aerial refueling capability]]
[[Category:Howto|Implement aerial refueling capability]]

Revision as of 11:19, 13 June 2011

This hotwo teaches you how to implement aerial refueling capability to both tanker and/or receiver aircraft.

Receiver aircraft

Add the following blocks of code to your aircraft's -set.xml file (all after the </sim> tag). Make sure to check for pre-existing blocks/structures and leave them intact.

  • Radar is needed to check if you are close enough from the tanker
  • Refuel defines what type of refueling you are capable of, and if your refuel system is ok to receive (use the serviceable property if you have a switch to open the refuel trap for example).
  • aar.nas is the actual system that checks the two above mentioned criteria and if both are true, refuels your tanks.
 <instrumentation>
  <radar>
   <range type="int" archive="y">20</range>
   <minimized type="bool" archive="y">false</minimized>
  </radar>
 </instrumentation>

 <systems>
  <refuel>
   <type>probe</type>
   <serviceable type="bool">true</serviceable>
  </refuel>
 </systems>

 <nasal>
  <aar>
   <file>Aircraft/Generic/aar.nas</file>
  </aar>
 </nasal>

The aircraft can receive fuel from the KA6 with the above code. To receive fuel from the KC-135, replace 'probe' with 'boom'.

Tanker aircraft

To allow your plane to be used as a tanker by others players, you only need to add the following blocks of code to your aircraft's model .xml file (usually located in Aircraft/.../Models/):

 <multiplay>
  <refuel>
   <type>probe</type>
  </refuel>
 </multiplay>

Replace 'probe' with 'boom' in the files for a boom-equipped tanker. This influences what aircraft can receive fuel! Or give the two lines if the tanker get both a boom and probes (like recent kc135) in this case you will be able to refuel both type of aircraft.

For the moment, flyable tankers are: KC135, victor and KC130 (in Aircraft/c130) if you need an example.

Serviceable option

With FlightGear 2.0.0 and older, refueling is possible only if the tanker uses a "MOBIL" callsign (eg. MOBIL3). Later releases of FlightGear (and Git), allow any callsign to be a tanker. Besides that, the tanker property is now transmitted over multiplayer, permitting for example to prevent refueling if the refueling probe is not operational.

For this to work, add the following code in your aircraft's -set file (be sure not to be in another block):

<tanker type="bool">false</tanker>

Switch this property true or false to allow following aircraft to refuel or not.