Simulation Object Configuration Files
.jpg)
Simulation Object Configuration Files
Overview
Simulation objects include all the physical objects that can be added to ESP, except fixed wing aircraft and helicopters. The list includes blimps, animals, ground vehicles, boats, and a range of miscellaneous objects such as flour bombs and food pallets. The presence of many particular objects is because they appear in one or more of the missions.
See Also
Table of Contents
Sections of the Configuration File
- cameradefinition
- contact_points
- designspecs
- effects
- fltsim
- general
- geometry
- hoistpoint
- lights
- mass properties
- radios
- stability coefficients
- views
Sections of the Configuration File
[fltsim.n]
| title | The title of the object. | HumpbackWhale( title=HumpbackWhale ) cargoA( title=cargoA ) cargoA_hoop( title=cargoA_hoop ) cargoB( title=cargoB ) CaspianSeaMonster( title=CaspianSeaMonster ) |
| model | Specifies which model folder to reference. | HumpbackWhale( model= ) Tower Controller( model=NoCab ) |
| texture | Specifies which texture folder to reference. | HumpbackWhale( texture= ) Goodyear Blimp( texture=eagle ) |
| sim | Specifies which .air (flight model) file to use. | Goodyear Blimp( sim= ) |
| panel | Specifies which panel folder to reference. | Goodyear Blimp( panel= ) |
| sound | Specifies which sound folder to reference. | Goodyear Blimp( sound= ) |
| kb_checklists | Specifies which _check.txt file to use on the Checklists tab of the kneeboard. | Goodyear Blimp( kb_checklists= ) |
| kb_reference | Specifies which _ref.txt file to use on the Reference tab of the kneeboard. | Goodyear Blimp( kb_reference= ) |
| atc_id_color | Specifies, in RGB hexadecimal, the color of the tail number. The first two characters following the 0x specify the red value in hex, the second two characters the green, and the third set the blue. The final two characters are unused. Each value can be between 0 ff hex, which is 0 to 255 decimal. (Note: custom tail numbers burned into textures will not be modified by this). | Goodyear Blimp( atc_id_color= ) |
| atc_id | The tail number displayed on the exterior of the aircraft. This parameter can also be edited from the Select Aircraft dialog (if the atc_id_enable parameter is set to 1). Note that custom tail numbers burned into textures will not be modified by this. | Goodyear Blimp( atc_id=N68PW ) Bucket( atc_id= ) |
| ui_manufacturer | This value identifies the manufacturer sub-category. | Goodyear Blimp( ui_manufacturer="Goodyear" ) Bucket( ui_manufacturer="TestContainer" ) Tower Controller( ui_manufacturer="ATC Controller" ) Water Drop( ui_manufacturer="Liquid" ) |
| ui_type | This value identifies the type sub-category. | Goodyear Blimp( ui_type="Blimp" ) Bucket( ui_type="Buckets" ) Tower Controller( ui_type="Tower Controller" ) Water Drop( ui_type="Water Drop" ) |
| ui_variation | This value identifies the variation sub-category used to group aircraft in the Select Aircraft dialog. | Goodyear Blimp( ui_variation=Eagle ) Bucket( ui_variation=Variation A ) Tower Controller( ui_variation=Variation1 ) |
| description | The object description can be modified to say whatever you like about the object. | Goodyear Blimp( description="Blimp" ) Bucket( description="Test Container" ) Tower Controller( description="Tower Controller with Virtual Cockpit Cab Model" ) Water Drop( description="Test Water Drop" ) |
[general]
| category | The basic category of the object. | HumpbackWhale( category=Boat ) GEN_flour_bomb( category=SimpleObject ) Automobile( category = GroundVehicle ) VEH_air_bagcart1( category=GroundVehicle ) Goodyear Blimp( Category = Blimp ) Bucket( category = Container ) |
| atc_type | This is the specific aircraft type that the ATC system recognizes for this type of aircraft. | Goodyear Blimp( atc_type= ) |
| atc_model | This is the specific aircraft model that the ATC system recognizes for this type of aircraft. | Goodyear Blimp( atc_model= ) |
| editable | Legacy. Does not do anything. | |
| performance | The performance description for the aircraft can be edited. The \t is a tab character, and the \n is a new-line character. As the flight model for all variations is the same, the performance of each variation should also be identical. | Goodyear Blimp( performance= ) |
[contact_points]
| static_compression | Static compression of ground reaction spring. | AC_Unit_sm( static_compression = 0.5 ) |
| damping_ratio | Damping ratio of ground reaction. | AC_Unit_sm( damping_ratio = 0.8 ) |
| destroy_on_impact_threshold | Velocty (feet/sec) above which the object will destroy on impact. | Bucket( destroy_on_impact_threshold = 15 ) |
| static_pitch | The static pitch of the object when at rest on the ground (degrees). The program uses this value to position the object at startup, in slew, and at any other time when the simulation is not actively running. | HumpbackWhale( static_pitch=0.0 ) CaspianSeaMonster( static_pitch=1.0 ) |
| static_cg_height | The static height of the object when at rest on the ground (feet). The program uses this value to position the object at startup, in slew, and at any other time when the simulation is not actively running. | HumpbackWhale( static_cg_height=0.0 ) CaspianSeaMonster( static_cg_height=12.0 ) cruise_linerA_sm( static_cg_height=40.0 ) cruise_linerB_sm( static_cg_height=20.0 ) ferry2( static_cg_height=10.0 ) Flour_bomb_floating_dock( static_cg_height=3.0 ) |
| wheel_radius | The radius of the wheels in feet when used to calculate the rpm for graphics purposes. Need not exactly match the true radius. | Automobile( wheel_radius=3.0 ) VEH_jetTruck( wheel_radius=4.0 ) |
| destroy_on_impact | Set to 1 if the objet is to be removed after an impact. | Flour_bomb( destroy_on_impact=1 ) |
[designspecs]
| max_speed_mph | The maximum speed of the object. | HumpbackWhale( max_speed_mph = 30 ) CaspianSeaMonster( max_speed_mph = 350 ) Flour_bomb_floating_dock( max_speed_mph = 0 ) VEH_water_sailboat1_sm( max_speed_mph = 10 ) Automobile( max_speed_mph = 115 ) |
| acceleration_constants | Time constant (effects responsiveness), and max acceleration (Gs). | HumpbackWhale( acceleration_constants = 0.5, 0.4 ) CaspianSeaMonster( acceleration_constants = 2.5, 1.4 ) Automobile( acceleration_constants = 0.3, 0.4 ) VEH_flatbed( acceleration_constants = 0.4, 0.2 ) VEH_jetTruck( acceleration_constants = 7.0, 1.9 ) VEH_safari_truck( acceleration_constants = 0.6, 0.4 ) |
| deceleration_constants | Time constant (effects responsiveness), and max acceleration (Gs). | HumpbackWhale( deceleration_constants = 2.0, 0.5 ) CaspianSeaMonster( deceleration_constants = 4.0, 1.5 ) Automobile( deceleration_constants = 0.2, 0.4 ) VEH_flatbed( deceleration_constants = 2.0, 1.0 ) VEH_jetTruck( deceleration_constants = 5.0, 3.0 ) VEH_safari_truck( deceleration_constants = 2.0, 1.5 ) |
| sternposition | The distance in feet relative to the datum reference position, where a wake effect should start. | HumpbackWhale ( SternPosition = 0 ) cargoA (SternPosition = 50) cargoB ( SternPosition = 42) |
| wdeceleration_constants | Time constant (effects responsiveness), and max acceleration (Gs). | PBoat_57ft_Goldhull_sm( wdeceleration_constants = 2.0, 0.5 ) |
[views]
| eyepoint | (feet) longitudinal, lateral, vertical distance from reference datum. | Tower Controller( eyepoint= 0.0, 0.0, 0.0 ) |
[effects]
| wake | The wake effect name, followed by an optional 1 if the effect is to be run for a single iteration. Set this number to zero or leave blank (the default), for the effect to continue as long as the respective action is active. This optional 1 applies to all effects in this table. | HumpbackWhale( wake = fx_wake_ss ) cargoA( wake = fx_wake_l ) CaspianSeaMonster( wake=fx_wakeCSM ) cruise_linerA_sm( wake = fx_wake_xl ) PBoat_57ft_Bluehull_sm( wake = fx_wake_s ) |
| impactland | The effect to display if the object impacts with land. | Flour_bomb( ImpactLand = fx_FlourBombLand ) |
| impactwater | The effect to display if the object impacts with water. | Flour_bomb( ImpactWater = fx_FlourBombWater ) |
| impactdestroyland | An additional effect to display if the object is destroyed on impact with land. For example, after being dropped at too great a height or speed from a sling or hoist. | Bucket( ImpactDestroyLand = fx_dirtcrash ) |
| impactdestroywater | An additional effect to display if the object is destroyed on impact with water. | Bucket( ImpactDestroyWater = fx_spray ) |
[lights]
Each light that requires a special effect should be entered in this section. The following table gives the codes for the switches that will turn on the lights.
| Code | Switch |
| 1 | Beacon |
| 2 | Strobe |
| 3 | Navigation or Position |
| 4 | Cockpit |
| 5 | Landing |
| 6 | Taxi |
| 7 | Recognition |
| 8 | Wing |
| 9 | Logo |
| 10 | Cabin |
| light.0 to light.n |
The first entry of the line defines which circuit, or switch, the light is connected to (see the code table above). Multiple lights may be connected to a single switch. The next three entries are the longitudinal, lateral, and vertical positions of the light in feet. The final entry is the special effect file name that is triggered (for example, fx_navred). These files have .fx extensions and should be placed in the ESP/effects folder. | Automobile( light.0 = 1, 9.5, 3.1, 3.0, fx_navred ) VEH_air_FuelTruck100LL( light.0 = 1 ) Tower Controller( light.0 = 1, 0.00, 0.00, 10.00, fx_vclight ) Automobile( light.1 = 1, 9.5, -3.1, 3.0, fx_navred ) VEH_air_FuelTruck100LL( light.1 = 1 ) Automobile( light.2 = 2, -9.3, 3.2, 3.2, fx_navred ) VEH_air_FuelTruck100LL( light.2 = 2 ) |
[radios]
| audio.1 | Set to 1 if there is an audio 1 panel. | Tower Controller( Audio.1 = 1 ) |
| audio.2 | Set to 1 if there is an audio 2 panel. There cannot be audio 2 without audio 1 | Tower Controller( Audio.2 = 1 ) |
| com.1 | Set to 1 if there is a Com 1 radio, and a second 1 if it supports a standby frequency. | Tower Controller( Com.1 = 1, 0 ) |
| com.2 | Set to 1 if there is a Com 2 radio, and a second 1 if it supports a standby frequency. There cannot be Com 2 without Com 1. | Tower Controller( Com.2 = 1, 0 ) |
| nav.1 | Set to 1 if there is a Nav 1 receiver, a second 1 if it supports a standby frequency, and a third 1 if it supports a glideslope indication. | Tower Controller( Nav.1 = 0, 0, 0 ) |
| adf.1 | Set to 1 if there is an ADF panel. | Tower Controller( Adf.1 = 0 ) |
| transponder.1 | Set to 1 if there is a transponder. | Tower Controller( Transponder.1 = 0 ) |
| marker.1 | Set to 1 if there is a marker beacon receiver. | Tower Controller( Marker.1 = 0 ) |
[cameradefinition.n]
This section shows the camera properties used by the Tower Controller. A simulation object can have multiple cameradefinition sections, which should be numbered from 0 to n. For a full definition of all the properties that can be set for a camera definition, refer to the Camera Configuration document. All of the properties described in that document can be used in a camera definition in a simulation object configuration file.
| title | Tower Controller( Title = Station 1 ) |
| guid | Tower Controller( Guid = {13605371-4065-417d-8DB8-3FC66A3DBE7B} ) |
| description | Tower Controller( Description = Tower Cab Position 1 ) |
| origin | Tower Controller( Origin = Virtual Cockpit ) |
| snappbhadjust | Tower Controller( SnapPbhAdjust = Swivel ) |
| snappbhreturn | Tower Controller( SnapPbhReturn = FALSE ) |
| panpbhadjust | Tower Controller( PanPbhAdjust = Swivel ) |
| panpbhreturn | Tower Controller( PanPbhReturn = FALSE ) |
| track | Tower Controller( Track = None ) |
| showaxis | Tower Controller( ShowAxis = FALSE ) |
| allowzoom | Tower Controller( AllowZoom = TRUE ) |
| initialzoom | Tower Controller( InitialZoom = 1.0 ) |
| showweather | Tower Controller( ShowWeather = Yes ) |
| initialxyz | Tower Controller( InitialXyz = 0.0, 0.0, 0.0 ) |
| initialpbh | Tower Controller( InitialPbh = 0.0, 0.0, 0.0 ) |
| xyzadjust | Tower Controller( XyzAdjust = TRUE ) |
| category | Tower Controller( Category=VC ) |
| zoompanscalar | Tower Controller( ZoomPanScalar = 1.0 ) |
| showlensflare | Tower Controller( ShowLensFlare=FALSE ) |
[geometry]
| length | The length, width and height of a simple object that can be used to estimate moments of inertia, along with the [mass properties] settings. In particular this applies to objects being carried by a sling or hoist. Units are in feet. | AC_Unit_sm( Length = 8 ) Bucket( Length = 2 ) CableCar_Wheel_sm( Length = 5 ) Climber_sm( Length = 6 ) Fisherman_sm( Length = 1 ) Generator_sm( Length = 12 ) Humvee_sm( Length = 10 ) shipping_container_sm( Length = 20 ) |
| width | In feet. | AC_Unit_sm( Width = 6 ) Bucket( Width = 2 ) CableCar_Wheel_sm( Width = 5 ) Generator_sm( Width = 4 ) Humvee_sm( Width = 7 ) pallet_of_Boxes_sm( Width = 10 ) Propane_Tank_sm( Width = 3 ) shipping_container_sm( Width = 8 ) |
| height | In feet. | AC_Unit_sm( Height = 6 ) Bucket( Height = 3 ) CableCar_Wheel_sm( Height = 2 ) Climber_sm( Height = 1 ) Generator_sm( Height = 5 ) pallet_of_Boxes_sm( Height = 4 ) shipping_container_sm( Height = 10 ) |
[HoistPoint]
If a HoistPoint entry is not present in the configuration file, a default connection position of just above the center of the object will be used.
| position | Offset in feet of the connection position for a sling or hoist, from the datum reference point. The default datum reference point of an object that is not an aircraft is its center point on all three axes. | Bucket( position = 0, 0, 1.0 ) |
[mass properties]
| empty weight | In lbs, used with the [geometry] settings to estimate moments of inertia. | AC_Unit_sm( Empty Weight = 4500 ) Bucket( Empty Weight = 300 ) CableCar_Wheel_sm( Empty Weight = 500 ) Climber_sm( Empty Weight = 200 ) Generator_sm( Empty Weight = 2000 ) Humvee_sm( Empty Weight = 1500 ) pallet_of_Boxes_sm( Empty Weight = 800 ) Propane_Tank_sm( Empty Weight = 1800 ) |
[stability coefficients]
| ground translational damping | Damping and stability co-efficients are used to estimate the behavior of an object when it is being transported on a sling or hoist. | AC_Unit_sm( ground translational damping = -4.0, -4.0, -0.2 ) |
| ground rotational damping | AC_Unit_sm( ground rotational damping = -200.0, -200.0, -200.0 ) | |
| ground rotational stability | AC_Unit_sm( ground rotational stability = -150.0, -40.0, -0.0 ) | |
| air translational damping | AC_Unit_sm( air translational damping = -0.2, -0.2, -0.1 ) | |
| air rotational damping | AC_Unit_sm( air rotational damping = -100.0, -100.0, -100.0 ) | |
| air rotational stability | AC_Unit_sm( air rotational stability = -75.0, -20.0, -0.0 ) |
.jpg)