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
- 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.
- Close X-Plane 12. Installing while the simulator is running will not update the scenery already loaded.
- 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.
- Extract the archive completely. Do not place the ZIP, 7z or other compressed file directly in
Custom Scenery. - Find the actual library folder. Open the extracted files and locate the folder that has
library.txtdirectly inside it. This is the folder X-Plane needs; a download wrapper around it should not be installed. - 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. - 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,AircraftorGlobal 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.
| Symptom | Likely cause | Fix |
|---|---|---|
| The airport reports missing objects | ZDP Library is absent, outdated or installed inside an extra folder | Confirm that library.txt is directly inside the installed library folder and replace an old copy rather than merging files |
| The warning remains after installation | The library was copied into a different X-Plane installation | Check the path of the executable you launch and install the library in that copy's Custom Scenery folder |
| Files still appear as an archive | The download was copied without extraction | Extract it first, then install only the folder containing library.txt |
| Two ZDP folders are present | An older or renamed duplicate is also being scanned | Keep one complete version and move the duplicate outside Custom Scenery |
Other library names appear in Log.txt | The airport has several separate dependencies | Install 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.