File Format Specifications

Current File Formats


Title Date Description
Flightplan files - v11 .fms file format 2017-09-27 16:55:00 The new v11 .fms flightplan format allows saving and loading flightplans with coded instrument flight procedures. These files are understood by the X-Plane 11 GPS (GNS430W/530W), G1000 and FMS.
Sound (.snd) File Format Specification 2017-05-05 19:15:04 X-Plane .snd files integrate custom FMOD sound into an aircraft.
Joystick Configuration (.joy) Files 2016-12-08 16:05:10 This article describes how to create joystick configuration (.joy) files.

Airport & NAVAID Data

Title Date Description
Navdata in X-Plane 11 2016-10-09 13:03:18 This document explains the new Nav data format for X-Plane 11.
Airport Data (apt.dat) 11.00 File Format Specification 2015-11-18 13:15:02 This document defines core airport data for current version of X-Plane (11.00 and onwards).
Astronomical data (astro.dat) File Format Specification 2015-11-12 11:04:21 This document describes the file format and codes used in X-Plane's astro.dat file, usable with X-Plane version 7.40 onwards.


Title Date Description
Autogen String (.ags) File Format Specification 2015-11-30 11:58:49 Describes X-Plane's autogen string (.ags) file format, which is used to place a large number of tile-based scenery buildings around a polygonal shape.
Autogen Block (.agb) File Format Specification 2015-11-30 11:58:07 Describes X-Plane's autogen block (.agb) file format, which is used to tightly fill and pack rectangular scenery areas.
Painted Line (.lin) File Format Specification 2013-06-23 20:38:12 Describes X-Plane's painted line (.lin) file format, which defines taxiway markings that can be draped over DSFs in scenery.
Vector Network (.net) File Format Specification 2013-06-23 20:35:58 Describes X-Plane's vector network definition (.net) file format, which is used to render road networks.
Draped Polygon (.pol) File Format Specification 2013-06-23 20:33:08 Describes X-Plane's draped polygon (.pol) format, which defines how a DSF polygon should be draped over the existing terrain mesh.
Object String (.str) File Format Specification 2013-06-23 20:31:42 Describes X-Plane's object string (.str) files, which place objects (such as taxiway lights) along a bezier curve.
Terrain Type (.ter) File Format Specification 2013-06-23 20:25:40 Describes X-Plane Terrain (.ter) files, which tell X-Plane how to paint terrain patches. Discusses the contents of TER files and how DSF files are combined with a TER file to create a mesh.
Library (library.txt) File Format Specification 2013-06-23 20:18:05 Describes X-Plane's library.txt format, which tells X-Plane how to use the objects & other graphic resources located in other parts of the simulator.
X-Plane 10 Autogen Scenery File Format 2013-05-09 21:22:15 This document describes the syntax of the X-Plane 10 autogen art asset file formats.
X-Plane 10 Facade (.fac) File Format Specification 2013-05-08 12:12:05 This document describes the complete X-Plane 10 facade file format.
Standard Shading Options for X-Plane 10 Scenery 2013-05-06 21:17:51 This document describes the syntax and options for shading in most X-Plane scenery file formats.
Forest (.for) File Format Specification 2012-03-21 21:33:07 A detailed file format explanation for X-Plane 10 forest files.
OBJ8 File Format Specification 2012-03-21 21:29:58 A complete file format specification for X-Plane 10 object (.obj) files, including all new v10 features.
DSF Usage In X-Plane 2012-02-19 12:57:02 This articles explains how X-Plane interprets raw DSF data to render scenery.
DSF File Format Specification 2012-02-19 12:53:07 A low-level specification of X-Plane's binary DSF scenery file format.

Legacy File Formats

Title Date Description
Airport Data (apt.dat) 1050 File Format Specification 2017-02-07 17:24:23 This defines the legacy apt.dat format for X-Plane version 10.50-10.52.
Airport Data (apt.dat) 850 Version 2017-01-18 13:47:14 This defines the legacy apt.dat format for X-Plane version 8.50.
Airport Data (apt.dat) 10.00 Version 2017-01-18 13:29:37 This document defines core airport data for X-Plane 10.00.
Airport data (apt.dat) 715 version 2015-11-19 15:40:25 This defines the legacy apt.dat format for X-Plane version 7.15 – 8.06.
X-Plane nav-aid data file definition (740 version) 2015-11-19 15:30:01 This explains the legacy nav.dat file format for X-Plane version 7.40 – 8.09.
Navigation Data (nav.dat & earth_nav.dat) File Format Specification 2015-11-12 13:43:14 This explains the legacy nav.dat file format for X-Plane version 8.10 – 10.52.
Fix Intersection (fix.dat) File Format Specification 2015-11-12 13:37:02 This explains the legacy earth_fix.dat file format for X-Plane version 7.40 – 10.52.
Airway Data (awy.dat) File Format Specification 2015-11-12 13:16:32 This explains the legacy earth_awy.dat file format for X-Plane version 7.40 – 10.52.