Install and configure HeadShake in X-Plane 12, fix missing-plugin errors, tune camera motion, and prevent conflicts with head tracking or X-Camera.
To install HeadShake in X-Plane 12, extract the download and place the single HeadShake plugin folder in X-Plane 12/Resources/plugins. Restart X-Plane, confirm HeadShake appears in the Plugins menu, then open its settings, enable only the desired effects, and begin with low intensities to prevent exaggerated camera movement.
How to install HeadShake in X-Plane 12
- Check the package: Use a HeadShake release intended to work with X-Plane 12 and your operating system. An old X-Plane 11 build may be incompatible even if its folder name looks correct.
- Close X-Plane: Do not replace plugin files while the simulator is running.
- Find the active simulator folder: Open the X-Plane installation that you actually launch, not an obsolete copy or an installer folder. Our guide to identifying the active X-Plane 12 folder covers the usual locations and shortcuts.
- Extract the archive: Unzip the download before copying anything. X-Plane cannot load a plugin directly from a ZIP file.
- Inspect the folder level: The resulting layout should resemble
X-Plane 12/Resources/plugins/HeadShake/, with the plugin's files and subfolders immediately inside it. A doubled path such asResources/plugins/HeadShake/HeadShake/is a common reason the plugin is not detected. - Copy it into the global plugins folder: HeadShake belongs in
Resources/plugins, not inside an individual aircraft,Custom SceneryorOutput/preferences. - Restart and verify: Load a flight, open the Plugins menu and look for HeadShake. Also check Plugin Admin to confirm that it is loaded and enabled.
When updating HeadShake, remove the previous plugin folder before installing the replacement unless its documentation explicitly says to merge them. Mixing old binaries with new support files can produce failures that look like a compatibility problem.
How should I configure HeadShake?
Configure HeadShake by adding one motion effect at a time and keeping its strength low enough that the instruments remain readable. The exact control names vary between builds, but the practical method is the same.
- Use a 3D cockpit view: Start with a familiar aircraft in daylight and disable other camera effects temporarily.
- Open the HeadShake settings: Select its settings or configuration entry from X-Plane's Plugins menu.
- Begin with minimal movement: Reduce the master intensity and individual ground-roll, engine, touchdown or G-force controls where those options are present.
- Test one effect at a time: Taxi over a normal surface, accelerate, make a few turns and perform a circuit. This reveals which component is causing unwanted motion.
- Restart X-Plane once: Confirm that the chosen settings persist and that HeadShake loads correctly with your normal aircraft and camera setup.
| Symptom | Adjustment to try first |
|---|---|
| Horizon swings excessively during turns | Reduce rotational or G-force movement |
| Taxiing produces continuous violent shaking | Reduce the ground-roll effect |
| The cockpit trembles too much at idle | Reduce engine vibration |
| Every landing creates a severe camera jolt | Reduce touchdown movement |
| Displays are difficult to read throughout the flight | Lower the overall intensity, then reduce translation |
Airliners usually benefit from restrained movement because their mass and suspension filter much of the vibration reaching the flight deck. Piston aircraft can tolerate more engine and ground feedback, but continuous shaking is still a sign that the values are too high.
Can HeadShake work with head tracking or X-Camera?
HeadShake can be combined with head tracking or X-Camera, but only one system should control each type of camera movement. Otherwise, two plugins may add the same motion or repeatedly overwrite the viewpoint.
Set up TrackIR, OpenTrack or another tracker by itself first, then add subtle HeadShake effects. If movement doubles, oscillates or recentres unexpectedly, use our head-tracking conflict and calibration guidance to separate deliberate head movement from simulated vibration.
When X-Camera owns the view, HeadShake may need to be permitted for the selected camera, depending on the installed X-Camera version. If HeadShake works with X-Camera disabled but stops when it is enabled, review the X-Camera setup and plugin-conflict checks rather than increasing HeadShake's intensity.
Why does HeadShake not appear in X-Plane 12?
A missing HeadShake menu entry normally means X-Plane has not loaded the plugin at all. Check these causes in order:
- Wrong folder nesting: Make sure the plugin files are not buried inside two identically named folders.
- Wrong X-Plane installation: Confirm that the folder you edited belongs to the copy of X-Plane 12 now running.
- Incompatible build: The plugin must support your operating system, processor architecture and X-Plane 12 launch mode.
- Operating-system security: macOS may block or quarantine downloaded plugin components. Check its privacy and security warning before changing files or permissions.
- Plugin disabled: Open Plugin Admin and enable HeadShake if it loaded but was switched off.
- Loader error: Open
Log.txtin the X-Plane 12 root folder and search forHeadShake. Messages about an unsupported architecture, missing library or failure to load identify an installation problem rather than a settings problem.
Our guide to plugin folder layout, Plugin Admin and Log.txt troubleshooting covers the loader checks in more detail. A full simulator restart is preferable after replacing plugin binaries.
Why is HeadShake loaded but not moving the view?
If HeadShake is loaded but has no visible effect, test it in an internal 3D cockpit with the plugin enabled and its intensity above zero. A parked aircraft with the engine off will not demonstrate ground-roll, acceleration or engine effects.
Disable other camera and motion plugins for one test. If HeadShake then starts working, another system was taking control of the viewpoint each frame. Also check that the X-Plane folder is writable if HeadShake works during one session but loses its settings after a restart.
Should I use HeadShake in VR?
In VR, begin with HeadShake disabled because the headset already controls the pilot's head position. Synthetic camera movement may be ignored, conflict with the tracked view or cause discomfort, depending on the plugin build. Enable it only if that build explicitly supports VR, and use much lower movement than for a monitor-based cockpit.