File Format Specifications

Current File Formats

General

TitleDateDescription
Joystick Configuration (.joy) Files2016-12-08 16:05:10This article describes how to create joystick configuration (.joy) files.

Airport & NAVAID Data

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

Scenery

TitleDateDescription
Autogen String (.ags) File Format Specification2015-11-30 11:58:49Describes 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 Specification2015-11-30 11:58:07Describes X-Plane's autogen block (.agb) file format, which is used to tightly fill and pack rectangular scenery areas.
Painted Line (.lin) File Format Specification2013-06-23 20:38:12Describes 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 Specification2013-06-23 20:35:58Describes X-Plane's vector network definition (.net) file format, which is used to render road networks.
Draped Polygon (.pol) File Format Specification2013-06-23 20:33:08Describes 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 Specification2013-06-23 20:31:42Describes X-Plane's object string (.str) files, which place objects (such as taxiway lights) along a bezier curve.
Terrain Type (.ter) File Format Specification2013-06-23 20:25:40Describes 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 Specification2013-06-23 20:18:05Describes 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 Format2013-05-09 21:22:15This document describes the syntax of the X-Plane 10 autogen art asset file formats.
X-Plane 10 Facade (.fac) File Format Specification2013-05-08 12:12:05This document describes the complete X-Plane 10 facade file format.
Standard Shading Options for X-Plane 10 Scenery2013-05-06 21:17:51This document describes the syntax and options for shading in most X-Plane scenery file formats.
Forest (.for) File Format Specification2012-03-21 21:33:07A detailed file format explanation for X-Plane 10 forest files.
OBJ8 File Format Specification2012-03-21 21:29:58A complete file format specification for X-Plane 10 object (.obj) files, including all new v10 features.
DSF Usage In X-Plane2012-02-19 12:57:02This articles explains how X-Plane interprets raw DSF data to render scenery.
DSF File Format Specification2012-02-19 12:53:07A low-level specification of X-Plane's binary DSF scenery file format.

Legacy File Formats

TitleDateDescription
Airport Data (apt.dat) 1050 File Format Specification2017-02-07 17:24:23This defines the legacy apt.dat format for X-Plane version 10.50-10.52.
Airport Data (apt.dat) 850 Version2017-01-18 13:47:14This defines the legacy apt.dat format for X-Plane version 8.50.
Airport Data (apt.dat) 10.00 Version2017-01-18 13:29:37This document defines core airport data for X-Plane 10.00.
Airport data (apt.dat) 715 version2015-11-19 15:40:25This 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:01This explains the legacy nav.dat file format for X-Plane version 7.40 – 8.09.
Navigation Data (nav.dat & earth_nav.dat) File Format Specification2015-11-12 13:43:14This explains the legacy nav.dat file format for X-Plane version 8.10 – 10.52.
Fix Intersection (fix.dat) File Format Specification2015-11-12 13:37:02This explains the legacy earth_fix.dat file format for X-Plane version 7.40 – 10.52.
Airway Data (awy.dat) File Format Specification2015-11-12 13:16:32This explains the legacy earth_awy.dat file format for X-Plane version 7.40 – 10.52.