Configuration File for X-Plane Professional

X-Plane Professional enables advances customisation via a JSON settings file. This file can be effortlessly deployed across multiple installations, ensuring consistent simulation behavior.

Location and name of the settings file:

<X-Plane 12> / Output / preferences / pro_settings.json

File Structure

{
	// general settings
	"general": {
		// name of the background image
		"background": "pro_background.png",
		// controls how the loading screen should be displayed
		//   black        == show a black screen
		//   progress_bar == show the X-Plane background image 
		                     with a progress bar
		"loading_screen": "progress_bar",
		// defines what should happen after the FPS check fails
		//   warn == show a warning message
		//   quit == show a message and quit the current flight
		"fps_check_fail": "quit",
		// filter the aircraft manager to hide specific aircraft,
		   e.g. "Aircraft/Laminar Research"
		"aircraft_filters": ["Aircraft/Laminar Research", "testing"]
	},
	// settings related to the main menu
	"main_menu": {
		// controls the display of the buttons on the main menu screen
		//   visible == show the button and its image
		//   black   == show the button without the image
		//   hidden  == hide the button from the main menu
		"resume_flight": "visible",
		"new_flight": "visible",
		"save_flight": "black",
		"load_flight": "black",
		"flight_school": "hidden",
		"settings": "visible"	
	},
	// settings related to the menu bar on top of the screen in
	// order to hide the entire menu bar or individual items
	"menubar": {
		// hide entire menubar
		//   true  == show the menubar
		//   false == hide the menubar
		"visible": true,
		// hide menu items
		//   visible == show the item
		//   hidden  == hide the item
		"menu_items": {
			"file": "visible",
			"file::save_flight": "hidden",
			"file::load_flight": "hidden",
			"file::take_screenshot": "visible",
			"file::toggle_video_recording": "hidden",
			"file::configure_video_recording": "hidden",
			"file::open_logbook": "visible",
			"file::open_checklist": "visible",
			"file::open_text_file": "visible",
			"flight": "visible",
			"flight::flight_configuration": "visible",
			"flight::edit_weight_balance": "visible",
			"flight::edit_failures": "visible",
			"flight::toggle_replay_mode": "visible",
			"flight::toggle_sectional_map": "visible",
			"flight::toggle_global_map": "visible",
			"flight::toggle_instructor_operating_station": "visible",
			"flight::ai_flies_your_aircraft": "visible",
			"flight::ai_controls_your_views": "visible",
			"flight::toggle_keyboard_shortcuts": "visible",
			"flight::manage_keyboard_joystick_profiles": "visible",
			"flight::prep_electrical_systems": "visible",
			"flight::start_engines_to_running": "visible",
			"flight::toggle_yoke_visibility": "visible",
			"flight::toggle_ground_handling_window": "visible",
			"view": "visible",
			"view::move": "visible",
			"view::move::left": "visible",
			"view::move::right": "visible",
			"view::move::up": "visible",
			"view::move::down": "visible",
			"view::move::forward": "visible",
			"view::move::backward": "visible",
			"view::move::rotate_up": "visible",
			"view::move::rotate_down": "visible",
			"view::move::rotate_left": "visible",
			"view::move::rotate_right": "visible",
			"view::move::zoom_in": "visible",
			"view::move::zoom_out": "visible",
			"view::change_internal": "visible",
			"view::change_internal::default_view": "visible",
			"view::change_internal::forward_3d_panel": "visible",
			"view::change_internal::forward_2d_panel": "visible",
			"view::change_internal::forward_hud": "visible",
			"view::change_internal::forward_no_display": "visible",
			"view::change_external": "visible",
			"view::change_external::linear_spot": "visible",
			"view::change_external::still_spot": "visible",
			"view::change_external::runway": "visible",
			"view::change_external::circle": "visible",
			"view::change_external::tower": "hidden",
			"view::change_external::ride_along": "visible",
			"view::change_external::track_weapon": "visible",
			"view::change_external::chase": "visible",
			"view::change_external::wingman": "visible",
			"view::change_external::free_camera": "visible",
			"view::show_instrument_click_regions": "visible",
			"view::show_instrument_descriptions": "visible",
			"view::show_3d_flight_model": "visible",
			"view::cycle_3d_flight_path": "visible",
			"view::reset_3d_flight_path": "visible",
			"view::lock_geographically": "visible",
			"view::g_loaded_camera": "visible",
			"view::hand_held_camera": "visible",
			"view::sunglasses": "visible",
			"view::night_vision_goggles": "visible",
			"view::oxygen_mask": "visible",
			"view::aviation_flashlight": "visible",
			"view::toggle_screenshot_tool": "visible",
			"developer": "visible",
			"developer::reload_current_aircraft_art": "visible",
			"developer::reload_current_aircraft": "visible",
			"developer::reload_reload_scenery": "visible",
			"developer::show_autopilot_constants": "visible",
			"developer::output_one_flight_model_cycle": "visible",
			"developer::toggle_cockpit_data_output": "visible",
			"developer::toggle_data_output_graph": "visible",
			"developer::toggle_real_weather_map": "visible",
			"developer::toggle_ground_traffic_paths": "visible",
			"developer::toggle_air_traffic_paths": "visible",
			"developer::toggle_network_synchronization": "visible",
			"developer::dump_to_log": "visible",
			"developer::dump_to_log::dump_atc_state": "visible",
			"developer::dump_to_log::dump_networking_state": "visible",
			"developer::dump_to_log::dump_weather_state": "visible",
			"developer::dump_to_log::dump_scenery_debugging_info": "visible",
			"developer::service_current_aircraft": "visible",
			"developer::toggle_projection_parameters": "visible",
			"developer::toggle_particle_system_browser": "visible",
			"developer::toggle_texture_browser": "visible",
			"developer::toggle_microprofiler": "visible",
			"developer::toggle_vram_profiler": "visible",
			"developer::toggle_rain_inspector": "visible",
			"developer::show_fps_test_recorder": "visible",
			"developer::toggle_dev_console": "visible",
			"developer::regenerate_icons": "visible"
		},
		// settings related to the toggle buttons on the right hand side of the menu bar
		//   visible == show the item
		//   hidden  == hide the item
		"toggle_pause": "visible",
		"toggle_flight": "hidden",
		"toggle_atc": "hidden",
		"toggle_map": "hidden",
		"toggle_settings": "visible",
		"toggle_help": "hidden"
	},
	// set datarefs and art controls to a specific value when a flight starts
	"datarefs": {
		"sim/private/controls/new_clouds/density": 25.0,
		"sim/private/controls/new_clouds/ambient": 1.000000
	} 
}

Back to Knowledge Base