Skip to content
X-Plane 4 min read

How do I download and install ZDP Library in X-Plane 12?

Adam McEnroe
In short

Learn how to download and install ZDP Library in X-Plane 12, use the correct Custom Scenery folder, and fix nested-folder or missing-object errors.

Download the ZDP Library from the official source named in the scenery package that requires it, extract the archive, and copy the single folder containing library.txt into X-Plane 12/Custom Scenery. Start X-Plane 12 once, then check Log.txt if the airport still reports missing objects.

ZDP Library download and installation steps

  1. Find the approved archive. Use the ZDP Library download supplied or referenced by the airport's documentation. X-Plane 12 cannot fetch missing scenery libraries automatically. If the library is bundled with the airport download, use that copy rather than obtaining an unrelated repack.
  2. Close X-Plane 12. Installing while the simulator is running will not update the scenery already loaded.
  3. Locate the simulator directory. If you have multiple installations, use our guidance for identifying the correct X-Plane 12 folder. Each separate installation needs access to its own scenery libraries.
  4. Extract the archive completely. Do not place the ZIP, 7z or other compressed file directly in Custom Scenery.
  5. Find the actual library folder. Open the extracted files and locate the folder that has library.txt directly inside it. This is the folder X-Plane needs; a download wrapper around it should not be installed.
  6. Copy the folder into Custom Scenery. The finished path should resemble X-Plane 12/Custom Scenery/[ZDP library folder]/library.txt. Our scenery-library installation checklist explains the same package-root rule in more detail.
  7. Launch X-Plane and load the affected airport. If no missing-resource warning appears and the expected buildings and objects are present, the library is working.

How should the ZDP Library folder look?

The correct installation has library.txt one level below Custom Scenery, alongside the library's asset folders.

  • Correct: X-Plane 12/Custom Scenery/[ZDP library folder]/library.txt
  • Usually wrong: X-Plane 12/Custom Scenery/[download wrapper]/[ZDP library folder]/library.txt
  • Wrong: X-Plane 12/Custom Scenery/[ZDP archive].zip
  • Wrong: placing the library in Resources/plugins, Aircraft or Global Scenery

A nested wrapper folder is the mistake we see most often. Preserve the supplied internal structure and do not move individual object or texture folders around. When updating an older copy, remove or back up the old library and install the replacement as a complete folder instead of merging the two versions.

Does ZDP Library need a special scenery_packs.ini position?

A normal ZDP Library installation generally does not need the airport, overlay and mesh ordering applied to ordinary scenery packages. Do not move it to the top as the first response to missing objects; the folder structure and installed version are more likely causes.

If X-Plane adds the library to scenery_packs.ini, leave the generated entry in place unless the supplied documentation says otherwise. If the entire airport is missing, flattened or covered by another package, follow our steps for checking downloaded scenery placement and pack order.

Why does X-Plane still say ZDP Library is missing?

A continuing missing-library warning usually means X-Plane found the airport but could not resolve one or more ZDP asset paths. Close the simulator and inspect Log.txt in the main X-Plane 12 folder after reproducing the problem.

SymptomLikely causeFix
The airport reports missing objectsZDP Library is absent, outdated or installed inside an extra folderConfirm that library.txt is directly inside the installed library folder and replace an old copy rather than merging files
The warning remains after installationThe library was copied into a different X-Plane installationCheck the path of the executable you launch and install the library in that copy's Custom Scenery folder
Files still appear as an archiveThe download was copied without extractionExtract it first, then install only the folder containing library.txt
Two ZDP folders are presentAn older or renamed duplicate is also being scannedKeep one complete version and move the duplicate outside Custom Scenery
Other library names appear in Log.txtThe airport has several separate dependenciesInstall each specifically named library; ZDP Library cannot replace R2, OpenSceneryX or another dependency

Search Log.txt for the missing resource path, the ZDP folder name and phrases such as Failed to find resource. The first missing asset is usually more useful than the final generic warning because it identifies which dependency or folder X-Plane could not resolve.

AI Assistant New

Still stuck? Ask Fly Away

Ask Fly Away is our AI flight-sim assistant. Ask your exact question and get a direct, step-by-step answer in seconds — free to try.

Ask Fly Away Free preview · unlimited for PRO members