Skip to content
X-Plane 5 min read

How do I fix shadows in X-Plane 12?

Adam McEnroe
In short

Fix missing, jagged, flickering or overly dark shadows in X-Plane 12 using graphics settings, cache resets, driver fixes and add-on checks.

To fix shadows in X-Plane 12, restore stock graphics and driver settings, then raise Shadow Quality while running at native rendering resolution. Test a default aircraft at a stock airport. If the fault remains, disable lighting or shader modifications, clear X-Plane's shader cache, update the graphics driver, and rebuild preferences.

Which X-Plane 12 shadow problem are you seeing?

The correct fix depends on whether shadows are pixelated, flickering, missing, excessively dark or simply reducing frame rate.

SymptomLikely causeFirst adjustment
Blocky or stair-stepped edgesLow shadow-map resolutionRaise Shadow Quality by one step
Shimmering while the camera movesLow rendering resolution, upscaling or insufficient anti-aliasingUse native rendering resolution and moderate anti-aliasing
No aircraft or scenery shadowsLow shadow setting, overcast lighting, modified resources or an object that does not cast shadowsTest clear midday weather with a default aircraft
Dirty or extremely dark cockpit cornersAmbient occlusion, exposure, an aircraft material issue or a lighting modificationLower Ambient Occlusion Quality and test the stock aircraft
Large FPS lossThe GPU cannot render the selected shadow quality efficientlyReduce Shadow Quality before reducing texture quality

How do I repair broken shadows step by step?

A clean stock test will separate a graphics-setting problem from an aircraft, scenery or plug-in fault.

  1. Test a controlled scene. Load a default X-Plane 12 aircraft at a stock airport, select clear weather and place the sun well above the horizon. Check both the cockpit and an external view. Long shadows near sunrise or sunset naturally expose more shadow-map artefacts.
  2. Back up your preferences. Close X-Plane and copy Output/preferences somewhere safe before resetting anything. This protects controller profiles and lets you reverse the test.
  3. Remove external overrides. Restore the graphics driver's X-Plane profile to its application-controlled defaults. Forced anti-aliasing, sharpening or scaling may be ineffective under Vulkan or Metal and can make diagnosis harder. NVIDIA users should compare their profile against our recommended NVIDIA settings and override checks.
  4. Establish sensible graphics settings. Set Rendering Resolution to native or full scale, begin with Shadow Quality in the middle of its range, and use moderate anti-aliasing. Temporarily set Ambient Occlusion Quality low or off. Increase only one option at a time so you know which change worked.
  5. Disable modifications. Temporarily remove third-party lighting, shader and private-dataref scripts. Disable third-party plug-ins and test without custom scenery. If core simulator files were replaced, restore them with X-Plane's updater or your installation platform's file-verification function.
  6. Rebuild the shader cache. With X-Plane closed, rename Output/shadercache if that folder is present. X-Plane will create a new cache on the next launch, which can take longer and may produce temporary compilation stutters during the first run.
  7. Reset the main preferences file. If every aircraft still has broken shadows, rename Output/preferences/X-Plane.prf and restart the simulator. This resets numerous simulator and graphics choices, so keep the backup until your controls and display configuration are confirmed.
  8. Update the rendering stack. Install a stable graphics driver and update X-Plane 12. On macOS, Metal driver fixes arrive through operating-system updates; on Windows and Linux, use the appropriate driver for the installed GPU.

Why are cockpit shadows jagged or shimmering?

Jagged cockpit shadows usually come from limited shadow-map resolution rather than low texture quality. X-Plane divides the visible area into shadow regions, giving nearby surfaces more detail than distant ones. As the aircraft or camera moves, transitions between those regions can produce visible crawling or a moving resolution boundary.

Raise Shadow Quality first. Native rendering resolution and anti-aliasing can smooth the final image, but anti-aliasing cannot turn a coarse shadow map into a perfectly sharp one. Texture Quality and anisotropic filtering have little effect on the edge of a cast shadow.

If aircraft outlines, buildings and runway markings also shimmer, the problem is broader than shadows; use our X-Plane 12 jagged-edge troubleshooting to check rendering resolution, anti-aliasing and scaling.

Why are shadows missing or the cockpit too dark?

Missing shadows are not always a rendering failure. Heavy cloud removes direct sunlight, distant objects can fall outside the detailed shadow range, and not every artificial light casts dynamic shadows. An individual scenery object or aircraft component may also be configured not to cast one.

If shadows disappear only in one add-on aircraft or at one airport, leave the global graphics settings alone and test equivalent stock content. A simulator-wide problem points instead to settings, preferences, drivers or modified resources.

An overly dark cockpit is often exposure or ambient occlusion rather than a defective shadow. Reduce Ambient Occlusion Quality for comparison, remove lighting modifications, and check the aircraft's panel and instrument lighting. Our separate guide explains how to diagnose an excessively dark X-Plane 12 cockpit without sacrificing every exterior shadow.

How can I keep shadows without losing too much FPS?

Use the highest Shadow Quality that leaves consistent GPU headroom, not automatically the maximum setting. Cockpit shadow definition may justify a higher setting for close-up flying, while VR, high resolutions and complex airports often require a lower level.

Display X-Plane's CPU and GPU frame times in the simulator. If GPU time is the larger figure, reduce Shadow Quality by one step and retest the same view; clouds, anti-aliasing and rendering resolution are the next likely targets. If CPU time dominates, lowering shadows may produce a smaller improvement.

Do not clear the shader cache after every flight. Rebuilding it repeatedly can cause fresh compilation stutters without improving normal shadow quality. For a wider performance diagnosis, follow our X-Plane 12 FPS tuning process for Mac and PC.

When is the shadow artefact an add-on problem?

A fault confined to one aircraft, livery, scenery object or airport is usually an add-on implementation issue. Transparent surfaces, animated components, glass, propellers and overlapping geometry can all create unusual shadows that global graphics changes cannot repair.

Repeat the scene with stock aircraft and scenery, then inspect Log.txt in the main X-Plane folder for plug-in or resource errors. If the artefact vanishes during the stock test, restore add-ons one at a time; the last restored component identifies the conflict without forcing an unnecessary simulator reinstall.

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