diff --git a/example.txt b/example.txt index 1dc23ac..5957729 100644 --- a/example.txt +++ b/example.txt @@ -4,7 +4,8 @@ # On android, place the txt file in /Android/data/com.dirgtrats.endlessatc/files/. # Copy, edit and use and share airport files at your own risk! -# This example file has lots of comments (#), to use it as a guide. Uncomment the 'code = ' item in the [airport1] section below to make the airport appear in-game. +# This example file has lots of comments (#), to use it as a guide +# Uncomment the 'code = ' item in the [airport1] section below to make the airport appear in-game. # This file has several [sections] (but most are optional), namely: # [airspace]: various general properties @@ -20,11 +21,11 @@ # Each section can have multiple items, each item with one or more properties. The format/order of properties are explained after a double hashtag (##) in this file. # Properties are comma separated. Multi-line properties (lists) MUST start with a tab or space at the beginning of each line. # Properties in this file that are explained between are optional properties (do not include the brackets themselves). -# If the game fails to load a property, or you omit, #comment or zero an (optional) property, a default value may be automatically used instead. +# If the game fails to load a property, or you omit, #comment or zero a property, the game may automatically use a default value instead. # Positions must be given either in x, y coordinates (in nautical miles, NM), with 0, 0 being the center of the screen, and 20.1, 12.82 being somewhere at the top left, # or, in latitude, longitude coordinates, which must always start with a N/W/S/E prefix, for example N40.7128, W74.0060 or S049.43.45.000, E002.09.51.000 (DMS notation). # Lat/long coordinates (and true headings) are rotated automatically when a magnetic variance is defined; this is to align the radar display with the magnetic north, -# to make a heading of 360 degreees a vertical line on the radar screen. +# to make a heading of 360 degrees appear as a vertical line on the radar screen. # X, y coordinates are simple screen coordinates; they are not rotated. # Either way, all positions consist of two values, seperated by a comma. Whether you want to use x,y or latlong coordinates is up to you. # For real world data it is probably easier to search the internet for the actual latlong coordinates. @@ -35,21 +36,22 @@ [airspace] ############################################################## -radius = 30 ; airspace radius in NM -zoom = 7.0 ; default zoom level, increase to zoom in -elevation = 13 ; ground altitude in feet -floor = 1500 ; minimum selectable altitude -descendaltitude = 7000 ; minimum initial altitude for arrivals -ceiling = 9000 ; maximum selectable altitude -above = 12000 ; maximum departure altitude when SID is enabled (must be above ceiling) -transitionaltitude = 18000 ; highest altitude displayed in feet instead of flight level -speedrestriction = 15, 220 ; radius in NM, and speed in knots -localizerspeed = 30, 200 ; distance to touchdown in NM, speed restriction in knots on localizers -usa = true ; American-style callsign pronunciation and runway names -metric = false ; display altitudes in metres instead of feet -separation = 3 ; minimum allowed distance between aircraft in NM -center = N50.1234, E2.0060 ; lat/long location of center of radar display (required when using lat/long coordinates elsewhere in this file) -magneticvar = 2.0 ; magnetic variance; east = positive (used to rotate lat/long coordinates if used elsewhere in this file) +radius = 30 ; airspace radius in NM +zoom = 7.0 ; default zoom level, increase to zoom in +elevation = 13 ; ground altitude in feet +floor = 1500 ; minimum selectable altitude +descendaltitude = 7000 ; minimum initial altitude for arrivals +ceiling = 9000 ; maximum selectable altitude +above = 12000 ; maximum departure altitude when SID is enabled (must be above ceiling) +transitionaltitude = 18000 ; highest altitude displayed in feet instead of flight level +speedrestriction = 15, 220, 10000, 250 ; radius in NM, speed in knots within radius, +localizerspeed = 30, 200 ; distance to touchdown in NM, speed restriction in knots on localizers +usa = true ; American-style callsign pronunciation and runway names +metric = false ; display altitudes in metres instead of feet +separation = 3 ; minimum allowed distance between aircraft in NM +name = approach, departure ; atc callsign pronunciation for arrivals, atc callsign pronunciation for departures +center = N50.1234, E2.0060 ; lat/long location of center of radar display (required when using lat/long coordinates elsewhere in this file) +magneticvar = 2.0 ; magnetic variance; east = positive (used to rotate lat/long coordinates if used elsewhere in this file) beacons = @@ -60,7 +62,7 @@ beacons = # the first given beacon will be the default beacon for arrivals inbound the main airport # when holdingheading is 0 or omitted, planes will hold there using the plane's current heading # when a holdingheading is given, planes will fly that heading (or magnetic course) on the inbound leg when flying the holding -# when holdingheading is negative, planes will make left-hand turns instead of right-hand +# when holdingheading is negative, planes will make left-hand turns instead of right-hand turns boundary = -25, -22 @@ -71,6 +73,13 @@ boundary = # pointlist of optional airspace boundary polygon; this will override the default (circular) airspace radius. # last point is automatically connected to first point +handoff = + 090, Radar East, radar east, 123.5 + 270, Radar West, radar west, 122.275 +## heading, atc callsign, callsign pronunciation, +# optional handoff readbacks for departures; only used when sound mode 3 is enabled +# heading determines which atc station will be selected by a plane: the closest to the heading from the center of the screen to the plane's (last) SID point + line1 = 10, 10 10, 40 @@ -87,18 +96,20 @@ line2 = -15, -14 -15, 0 +# all items in this section are optional unless stated otherwise + ############################################################## [airport1] ############################################################## -name = Example Airport ; name of the main airport, +name = Example Airport, example ; name of the main airport, #code = EXAM ; four letter code, displayed in airport menu (required; remove the #) runways = - rwy1, 36, -4.3, 3.23, 360.0, 11400, 0, 0, 100, 3, 360.0, 3, 180.0, YY, 8.0, ZZ, 8.5 -## identifier, name, position, true_heading, , , , , , , , , , -# where identifier is a unique name used to define a runway usage configuration later in this file + rwy1, 36, -4.3, 3.23, 360.0, 11400, 0, 0, 100, 3, 360.0, 3, 180.0, YY, 8.0, ZZ, 8.5, 119.23 +## identifier, name, position, true_heading, , , , , , , , , , , +# identifier is a unique name used to define a runway usage configuration later in this file # name is one or two digits, optionally suffixed with an L, R or C character # position is the location of the beginning of the runway (including displaced threshold) # length is in feet @@ -106,8 +117,9 @@ runways = # elevation is in feet, and must be within 1000 feet difference from the airspace ground elevation defined above # glideslope is the angle in degrees; the default value is 3.0 # localizer is the true heading in degrees of the ILS until touchdown; by default it's the same as runway true heading, but a small offset is allowed -# beacon is a point on the localizer at a certain distance (NM) from the (displaced) threshold +# beacon is an optional point on the localizer at a certain distance (NM) from the (displaced) threshold # second beacon is a point on the localizer when runway is used in opposite direction (rev) +# tower frequency is used for handoff readbacks climbaltitude = 5000 ; maximum initial climb altitude in feet for departures @@ -149,8 +161,8 @@ name = Secondary Airport, secondary airport ; name of secondary airport, , , , , , , , , , + rwy2, 06, 6.7, -3.5, 60.0, 11423, 0, 0, 100, 3,0,3,0, WL, 8.0, 0, 0, 118.105 +## identifier, name, position, true_heading, , , , , , , , , , , # identifier must be unique to all other runways defined in this file traffic = 5 ; average time between airplanes per active runway, in minutes (but this decreases at higher skill values) @@ -273,10 +285,10 @@ route1 = 1, 18, 4000 -3, 18, 0, 180 10.5, 3000, 200 -# first item of the route is the bearing from the plane towards the beacon; if there are multiple routes defined for this beacon, the closest bearing defines which route is selected; but if only one route is given then the bearing can just be a random number +# first item of the route is the bearing from the plane towards the beacon; if there are multiple routes defined for this beacon, the closest bearing defines which route is selected; but if only one route is defined then the bearing can just be a random number # next lines are optional waypoints: ## position, , # last line is the interception point on the ILS: ## distance (NM) from the (displaced) threshold, , -# alternatively the last time can be used to end the route before it reaches the ILS (and requiring vectors), using the word end: ## end, +# alternatively the last line can be used to end the route before it reaches the ILS (requiring vectors), using the word end: ## end, route2 = 310 @@ -292,7 +304,7 @@ route3 = 10.5, 3000, 200 # the optional [approach] section adds route(s) to a specific runway -# multiple [approach] sections can be used for the same runway, to allow for multiple beacons +# multiple [approach] sections can be used for the same runway, to allow for multiple app beacons # for easier creation of routes, use left Ctrl key to display current mouse coordinates, and left click while holding down Ctrl places temporary visual markers # Longpress the airport name button in the menu to display all routes at once # [approach] routes are not used in the built-in airports as the game is focussed on vectors for simplicity @@ -307,9 +319,10 @@ types = ## type, category, minspeed, maxspeed, minturnrate, maxturnrate, mindescendrate, maxdescendrate, minfinalapproachspeed, maxfinalapproachspeed, minaccelrate, maxaccelrate, # custom [planetypes] are only needed when using unknown custom types in the airlinelists above (game will show warnings on startup for missing types), or to override default type properties # category is the weight category: 1 to 6, meaning superheavy=1, upperheavy, lowerheavy, uppermedium, lowermedium, light=6 +# speeds in knots # turnrate is in degrees per second # descendrate is in feet per minute -# approachspeeds in knots +# approachspeeds in knots, may be below minspeed # accelrate is in knots per second # manufacturer name is optional, and only used for private callsign pronunciation in usa mode # example of default values for b737, 4, 160, 250, 2.6, 3.0, 1440, 1560, 131, 144, 1.2, 1.3 @@ -353,4 +366,4 @@ events = ## cloud: position ; add cloud with radius of 1 NM (preferably just outside the airspace boundary, to avoid incidents, unless time is 0) ## config: entry ; change to different runway config, as specified in the rwy configurations section ## text: message ; display yellow text at the top of screen -# the [scenario] can be enabled in the traffic menu +# the [scenario] can be enabled in the traffic menu \ No newline at end of file diff --git a/raw/example.txt b/raw/example.txt index 7419da5..5957729 100644 --- a/raw/example.txt +++ b/raw/example.txt @@ -1,10 +1,11 @@ -# Custom airport file (experimental!) +# Custom airport file # Save a copy of example.txt before editing it, to keep this file as a guide. # On Windows, place the txt file in the /locations/ folder of the game. -# On android (4.4+), place the txt file in /Android/data/com.dirgtrats.endlessatc/files/. +# On android, place the txt file in /Android/data/com.dirgtrats.endlessatc/files/. # Copy, edit and use and share airport files at your own risk! -# This example file has lots of comments (#), to use it as a guide. Uncomment the 'code = ' item in the [airport1] section below to make the airport appear in-game. +# This example file has lots of comments (#), to use it as a guide +# Uncomment the 'code = ' item in the [airport1] section below to make the airport appear in-game. # This file has several [sections] (but most are optional), namely: # [airspace]: various general properties @@ -18,13 +19,13 @@ # [scenario]: optional nonrandom traffic # Each section can have multiple items, each item with one or more properties. The format/order of properties are explained after a double hashtag (##) in this file. -# Properties are comma separated. Multi-line properties (lists) must start with a tab or space at the beginning of each line. +# Properties are comma separated. Multi-line properties (lists) MUST start with a tab or space at the beginning of each line. # Properties in this file that are explained between are optional properties (do not include the brackets themselves). -# If the game fails to load a property, or you omit or #comment or zero an (optional) property, a default value may be automatically used instead. +# If the game fails to load a property, or you omit, #comment or zero a property, the game may automatically use a default value instead. # Positions must be given either in x, y coordinates (in nautical miles, NM), with 0, 0 being the center of the screen, and 20.1, 12.82 being somewhere at the top left, # or, in latitude, longitude coordinates, which must always start with a N/W/S/E prefix, for example N40.7128, W74.0060 or S049.43.45.000, E002.09.51.000 (DMS notation). # Lat/long coordinates (and true headings) are rotated automatically when a magnetic variance is defined; this is to align the radar display with the magnetic north, -# to make a heading of 360 degreees a vertical line on the radar screen. +# to make a heading of 360 degrees appear as a vertical line on the radar screen. # X, y coordinates are simple screen coordinates; they are not rotated. # Either way, all positions consist of two values, seperated by a comma. Whether you want to use x,y or latlong coordinates is up to you. # For real world data it is probably easier to search the internet for the actual latlong coordinates. @@ -35,20 +36,22 @@ [airspace] ############################################################## -radius = 30 ; airspace radius in NM -zoom = 7.0 ; default zoom level, increase to zoom in -elevation = 13 ; ground altitude in feet -floor = 1500 ; minimum selectable altitude -descendaltitude = 7000 ; minimum initial altitude for arrivals -ceiling = 9000 ; maximum selectable altitude -above = 12000 ; maximum departure altitude when SID is enabled (must be above ceiling) -transitionaltitude = 18000 ; highest altitude displayed in feet instead of flight level -speedrestriction = 15, 220 ; radius in NM, and speed in knots -usa = true ; American-style callsign pronunciation and runway names -metric = false ; display altitudes in metres instead of feet -separation = 3 ; minimum allowed distance between aircraft in NM -center = N50.1234, E2.0060 ; lat/long location of center of radar display (required when using lat/long coordinates elsewhere in this file) -magneticvar = 2.0 ; magnetic variance; east = positive (used to rotate lat/long coordinates if defined below) +radius = 30 ; airspace radius in NM +zoom = 7.0 ; default zoom level, increase to zoom in +elevation = 13 ; ground altitude in feet +floor = 1500 ; minimum selectable altitude +descendaltitude = 7000 ; minimum initial altitude for arrivals +ceiling = 9000 ; maximum selectable altitude +above = 12000 ; maximum departure altitude when SID is enabled (must be above ceiling) +transitionaltitude = 18000 ; highest altitude displayed in feet instead of flight level +speedrestriction = 15, 220, 10000, 250 ; radius in NM, speed in knots within radius, +localizerspeed = 30, 200 ; distance to touchdown in NM, speed restriction in knots on localizers +usa = true ; American-style callsign pronunciation and runway names +metric = false ; display altitudes in metres instead of feet +separation = 3 ; minimum allowed distance between aircraft in NM +name = approach, departure ; atc callsign pronunciation for arrivals, atc callsign pronunciation for departures +center = N50.1234, E2.0060 ; lat/long location of center of radar display (required when using lat/long coordinates elsewhere in this file) +magneticvar = 2.0 ; magnetic variance; east = positive (used to rotate lat/long coordinates if used elsewhere in this file) beacons = @@ -59,7 +62,7 @@ beacons = # the first given beacon will be the default beacon for arrivals inbound the main airport # when holdingheading is 0 or omitted, planes will hold there using the plane's current heading # when a holdingheading is given, planes will fly that heading (or magnetic course) on the inbound leg when flying the holding -# when holdingheading is negative, planes will make left-hand turns instead of right-hand +# when holdingheading is negative, planes will make left-hand turns instead of right-hand turns boundary = -25, -22 @@ -70,6 +73,13 @@ boundary = # pointlist of optional airspace boundary polygon; this will override the default (circular) airspace radius. # last point is automatically connected to first point +handoff = + 090, Radar East, radar east, 123.5 + 270, Radar West, radar west, 122.275 +## heading, atc callsign, callsign pronunciation, +# optional handoff readbacks for departures; only used when sound mode 3 is enabled +# heading determines which atc station will be selected by a plane: the closest to the heading from the center of the screen to the plane's (last) SID point + line1 = 10, 10 10, 40 @@ -86,18 +96,20 @@ line2 = -15, -14 -15, 0 +# all items in this section are optional unless stated otherwise + ############################################################## [airport1] ############################################################## -name = Example Airport ; name of the main airport -#code = EXAM ; four letter code, displayed in airport menu (required!) +name = Example Airport, example ; name of the main airport, +#code = EXAM ; four letter code, displayed in airport menu (required; remove the #) runways = - rwy1, 36, -4.3, 3.23, 360.0, 11400, 0, 0, 100, 3, 360.0, 3, 180.0, YY, 8.0, ZZ, 8.5 -## identifier, name, position, true_heading, , , , , , , , , , -# where identifier is a unique name used to define a runway usage configuration later in this file + rwy1, 36, -4.3, 3.23, 360.0, 11400, 0, 0, 100, 3, 360.0, 3, 180.0, YY, 8.0, ZZ, 8.5, 119.23 +## identifier, name, position, true_heading, , , , , , , , , , , +# identifier is a unique name used to define a runway usage configuration later in this file # name is one or two digits, optionally suffixed with an L, R or C character # position is the location of the beginning of the runway (including displaced threshold) # length is in feet @@ -105,8 +117,9 @@ runways = # elevation is in feet, and must be within 1000 feet difference from the airspace ground elevation defined above # glideslope is the angle in degrees; the default value is 3.0 # localizer is the true heading in degrees of the ILS until touchdown; by default it's the same as runway true heading, but a small offset is allowed -# beacon is a point on the localizer at a certain distance (NM) from the (displaced) threshold +# beacon is an optional point on the localizer at a certain distance (NM) from the (displaced) threshold # second beacon is a point on the localizer when runway is used in opposite direction (rev) +# tower frequency is used for handoff readbacks climbaltitude = 5000 ; maximum initial climb altitude in feet for departures @@ -138,17 +151,18 @@ airlines = # direction lets the plane arrive/depart in (roughly) a preferred direction: # give the direction as a string containing one or more of the letters nwse, for north west south east, # but make sure there are actually entrypoints defined at those directions (approximately); w needs an entrypoint near 270 +# note that you can add the same airline multiple times, for example with different planetypes, in order to get different likelihoods per planetype ############################################################## [airport2] ############################################################## -name = Secondary Airport ; name of secondary airport -code = SC ; two letter code, which will be added to the runways and plane tags +name = Secondary Airport, secondary airport ; name of secondary airport, +code = SC ; two letter code, which will be added to the runways and plane tags runways = - rwy2, 06, 6.7, -3.5, 60.0, 1.88, 0, 0, 100, 3,0,3,0, WL, 8.0 -## identifier, name, position, true_heading, , , , , , , , , , + rwy2, 06, 6.7, -3.5, 60.0, 11423, 0, 0, 100, 3,0,3,0, WL, 8.0, 0, 0, 118.105 +## identifier, name, position, true_heading, , , , , , , , , , , # identifier must be unique to all other runways defined in this file traffic = 5 ; average time between airplanes per active runway, in minutes (but this decreases at higher skill values) @@ -252,7 +266,7 @@ route2 = # the optional [departure] section adds routes to a specific runway direction # this overrides the default (single waypoint) SIDs with more detailed routes, and applies the routes to the specified runway only # departing planes from that runway will then follow the one of the routes, unless the user deactivates SID mode -# re-enabling SID mode will select just the last point of the route +# re-enabling SID mode (or longpressing SID) will select just the last point of the route # defining one or more departure routes disables all the default SID points for that runway; planes will use the given routes only # use one [departure] section per runway direction, each with one or more routes # [departure] routes are not used in the built-in airports, for simplicity @@ -271,9 +285,10 @@ route1 = 1, 18, 4000 -3, 18, 0, 180 10.5, 3000, 200 -# first item of the route is the bearing from the plane towards the beacon; if there are multiple routes defined for this beacon, the closest bearing defines which route is selected +# first item of the route is the bearing from the plane towards the beacon; if there are multiple routes defined for this beacon, the closest bearing defines which route is selected; but if only one route is defined then the bearing can just be a random number # next lines are optional waypoints: ## position, , # last line is the interception point on the ILS: ## distance (NM) from the (displaced) threshold, , +# alternatively the last line can be used to end the route before it reaches the ILS (requiring vectors), using the word end: ## end, route2 = 310 @@ -288,7 +303,8 @@ route3 = -3, 18, 0, 180 10.5, 3000, 200 -# multiple [approach] sections can be used for the same runway, to allow for multiple beacons +# the optional [approach] section adds route(s) to a specific runway +# multiple [approach] sections can be used for the same runway, to allow for multiple app beacons # for easier creation of routes, use left Ctrl key to display current mouse coordinates, and left click while holding down Ctrl places temporary visual markers # Longpress the airport name button in the menu to display all routes at once # [approach] routes are not used in the built-in airports as the game is focussed on vectors for simplicity @@ -301,10 +317,12 @@ types = f200, 5, 140, 230, 2.9, 3.2, 1400, 1600, 115, 125, 1.1, 1.2, big jet c271, 6, 90, 120, 2.9, 3.2, 1400, 1600, 90, 105, 1.1, 1.2, singleprop ## type, category, minspeed, maxspeed, minturnrate, maxturnrate, mindescendrate, maxdescendrate, minfinalapproachspeed, maxfinalapproachspeed, minaccelrate, maxaccelrate, -# custom [planetypes] are only needed when using unknown custom types in the airlinelists above (game will show warning on startup), or to override default type properties +# custom [planetypes] are only needed when using unknown custom types in the airlinelists above (game will show warnings on startup for missing types), or to override default type properties # category is the weight category: 1 to 6, meaning superheavy=1, upperheavy, lowerheavy, uppermedium, lowermedium, light=6 +# speeds in knots # turnrate is in degrees per second # descendrate is in feet per minute +# approachspeeds in knots, may be below minspeed # accelrate is in knots per second # manufacturer name is optional, and only used for private callsign pronunciation in usa mode # example of default values for b737, 4, 160, 250, 2.6, 3.0, 1440, 1560, 131, 144, 1.2, 1.3