To install an add-on aircraft in X-Plane 12, extract the download and place the aircraft’s complete folder inside your main X-Plane 12 aircraft directory, then select it from the aircraft menu in the sim. The most common mistake is leaving the aircraft one folder too deep after extraction, so X-Plane never sees the .acf file.
Where do X-Plane 12 aircraft go?
In most cases, add-on aircraft belong inside your main X-Plane 12 installation folder, in the area used for aircraft. We strongly recommend keeping third-party aircraft separate from the default Laminar Research aircraft so updates and troubleshooting stay simple.
A tidy layout usually looks like this:
X-Plane 12 > Aircraft > Your Add-On Aircraft Folder
Some users also keep them in a separate add-on aircraft folder within the X-Plane directory. The exact folder name matters less than the structure: X-Plane must be able to find the aircraft’s main .acf file inside that aircraft’s own folder.
How to install add-on aircraft in X-Plane 12
- Download the aircraft package
Most add-on aircraft arrive as a ZIP, RAR or 7z archive. Save it somewhere easy to find before you start moving files around.
- Extract the archive fully
Do not drag the compressed file straight into X-Plane. Use your archive tool to extract everything first so you can inspect the folder structure.
- Find the actual aircraft folder
Open the extracted files and look for the folder that contains the aircraft itself. Inside that folder, you should usually see an
.acffile, plus items such asobjects,cockpit,plugins,liveriesor documentation. - Move that complete folder into X-Plane 12
Copy or move the whole aircraft folder into your X-Plane 12 aircraft area. Do not copy only individual files, and do not scatter folders into different places unless the developer’s instructions specifically tell you to.
- Keep it out of the default aircraft folders
Avoid dropping add-ons into the Laminar Research aircraft folders. It is cleaner to keep third-party aircraft in their own place, which makes updates, removals and fault-finding much easier.
- Start X-Plane 12 and load the aircraft
Launch the simulator, open the aircraft selection menu, and look for the aircraft by its developer or model name. If it appears, select it and let X-Plane load it fully before judging whether the install worked.
What should the folder structure look like?
The correct structure is the bit that catches most people out. X-Plane needs the aircraft’s main files to sit inside one proper aircraft folder, not inside several nested layers created during extraction.
A working example looks like this:
X-Plane 12/Aircraft/Add-On Aircraft/My Aircraft/My Aircraft.acf
A common broken example looks like this:
X-Plane 12/Aircraft/Add-On Aircraft/My Aircraft/My Aircraft v1.0/My Aircraft/My Aircraft.acf
In the broken version, the real aircraft folder is buried too deeply. X-Plane may not list it at all, or it may show a confusing folder name without loading correctly.
Why is my X-Plane 12 aircraft not showing up?
If the aircraft does not appear in the selection list, one of these is usually the reason.
| Problem | What it means | Fix |
|---|---|---|
| Extra folder layer | The .acf file is buried too deep after extraction | Move the real aircraft folder up one level |
| Still zipped | You copied the archive instead of the extracted folder | Extract it fully, then copy the folder |
| Wrong install location | The aircraft was placed outside the X-Plane install | Move it into the aircraft area inside X-Plane 12 |
| XP11 aircraft in XP12 | The aircraft may be incompatible or partially compatible | Check the documentation and expect missing systems or warnings |
| Missing plugin approval | The aircraft relies on plugins that the operating system blocked | Allow or re-enable the plugin, then reload |
X-Plane 11 aircraft in X-Plane 12: will they work?
Some will. Some will not. A lot of X-Plane 11 aircraft can load in X-Plane 12, but that does not mean they are fully compatible.
What usually breaks first is not the basic model. It is systems, avionics, lighting, flight model tuning, sounds or custom plugins. If the aircraft was not updated for X-Plane 12, it may load with warnings, odd handling or missing cockpit functions.
If the package says it supports X-Plane 12, install it normally. If it only mentions an older X-Plane version, treat it as a compatibility gamble rather than a guaranteed install problem.
Do payware and freeware aircraft install differently?
The basic file placement is usually the same. The difference is that some aircraft include copy protection, activation steps, serial entry, custom installers or extra plugins.
If the package includes a dedicated installer, use that instead of manually dragging folders unless the documentation says manual installation is supported. If it is a simple archive download, manual installation is usually fine.
Mac, Windows and Linux gotchas
Windows
Windows is usually straightforward: extract the aircraft, copy the folder, and check that security software has not quarantined any plugin files.
macOS
macOS can block unsigned plugins used by complex aircraft. If the aircraft appears but key systems do not work, the issue may be operating-system security rather than the install location.
Also watch for accidental duplicate folders created when macOS extraction tools unpack an archive into a similarly named parent folder.
Linux
On Linux, plugin permissions can matter. If the aircraft loads but custom systems do not, check whether the included plugin files have the correct permissions for your system.
How do we know the aircraft installed correctly?
There are three quick checks:
- The aircraft appears in X-Plane’s aircraft selection menu.
- The aircraft folder contains the main
.acffile near the top level of that folder. - When loaded, X-Plane does not immediately throw a missing file or plugin error.
If it shows in the menu but fails while loading, the installation location is probably fine and the issue is more likely to be compatibility, a missing dependency, a blocked plugin or a damaged download.
Best practice for managing add-on aircraft
We recommend keeping your X-Plane 12 aircraft organised from the start. It saves a lot of time later.
- Create a clearly named folder for third-party aircraft.
- Leave default aircraft in their original folders.
- Keep the original download archive until the aircraft has been tested.
- Read any included manual or install note before moving files.
- Install one aircraft at a time so any problem is easy to trace.
If the aircraft still will not load
If the install path looks right and the aircraft still does not appear or function properly, check the package documentation first. Many complex aircraft include very specific requirements, especially around plugins, sound packs, activation or supported X-Plane versions.
It is also worth re-downloading the package if you suspect a bad archive. Corrupt extractions do happen, and they can look like installation mistakes when the real issue is simply a broken file.
If you are looking for aircraft files and related content for the simulator, we keep our own library at Fly Away Simulation downloads.