File Format Specifications

Current File Formats

General

Title Date Description
Flightplan files - v11 .fms file format 27 Sep 2017 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 5 May 2017 X-Plane .snd files integrate custom FMOD sound into an aircraft.
Joystick Configuration (.joy) Files 8 Dec 2016 This article describes how to create joystick configuration (.joy) files.

Airport & NAVAID Data

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

Scenery

Title Date Description
Autogen String (.ags) File Format Specification 30 Nov 2015 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 30 Nov 2015 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 23 Jun 2013 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 23 Jun 2013 Describes X-Plane's vector network definition (.net) file format, which is used to render road networks.
Draped Polygon (.pol) File Format Specification 23 Jun 2013 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 23 Jun 2013 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 23 Jun 2013 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 23 Jun 2013 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 9 May 2013 This document describes the syntax of the X-Plane 10 autogen art asset file formats.
X-Plane 10 Facade (.fac) File Format Specification 8 May 2013 This document describes the complete X-Plane 10 facade file format.
Standard Shading Options for X-Plane 10 Scenery 6 May 2013 This document describes the syntax and options for shading in most X-Plane scenery file formats.
Forest (.for) File Format Specification 21 Mar 2012 A detailed file format explanation for X-Plane 10 forest files.
OBJ8 File Format Specification 21 Mar 2012 A complete file format specification for X-Plane 10 object (.obj) files, including all new v10 features.
DSF Usage In X-Plane 19 Feb 2012 This articles explains how X-Plane interprets raw DSF data to render scenery.
DSF File Format Specification 19 Feb 2012 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 7 Feb 2017 This defines the legacy apt.dat format for X-Plane version 10.50-10.52.
Airport Data (apt.dat) 850 Version 18 Jan 2017 This defines the legacy apt.dat format for X-Plane version 8.50.
Airport Data (apt.dat) 10.00 Version 18 Jan 2017 This document defines core airport data for X-Plane 10.00.
Airport data (apt.dat) 715 version 19 Nov 2015 This defines the legacy apt.dat format for X-Plane version 7.15 – 8.06.
X-Plane nav-aid data file definition (740 version) 19 Nov 2015 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 12 Nov 2015 This explains the legacy nav.dat file format for X-Plane version 8.10 – 10.52.
Fix Intersection (fix.dat) File Format Specification 12 Nov 2015 This explains the legacy earth_fix.dat file format for X-Plane version 7.40 – 10.52.
Airway Data (awy.dat) File Format Specification 12 Nov 2015 This explains the legacy earth_awy.dat file format for X-Plane version 7.40 – 10.52.