About This File
You would like to support my X-Plane projects? Buy me some pizza 
Please ask questions and have a discussion in the related thread!
X-Assign v.3 © barbarossa 2011..2015
1 SHORT DESCRIPTION
This is a plugin for X-Plane which enables you to save (most of) your controller settings PER AIRCRAFT and seamlessly restore them!
Features - most recent first:
- Save individual settings for 32 and 64 Bit X-Plane for any aircraft! (Existing settings will still load!)
- GLOBAL settings are shared between all aircraft and 32 and 64 Bit
- Save your augmentation, centring, linearity and null-zone with your axes assignments per aircraft!
- Save your axis and button and even field of view assignments per aircraft.
- Have as much as 3 sets of settings per aircraft if you wish and access each with just one button or key press.
2 DESCRIPTION
2.1 Introduction
I found myself reassigning buttons and axes once too often, so here is a solution:
- You can save and load 3 sets of assignments (buttons and axes and field of view) PER aircraft.
- You can bind keys or buttons to barbarossa/xassign/... to avoid the menu when you save or load the sets.
- If a set is not existent and you try to load it, it gets created instead and you can load it from now on.
IMPORTANT NOTE
Some aircraft (and maybe other add-ons as well) do not work out of the box with X-Assign. These aircraft define their own custom commands via plugins which makes them difficult to handle for X-Assign. The symptom is that some buttons constantly get miss-assigned. I might have discovered a
When you assign custom commands to BUTTONS make sure you assign them in the KEYS page as well. Even if you assign them to <NONE>.
This will help X-Plane and X-Assign to stay consistent with the button assignments.
Make sure you assign the custom commands in the same order as they appear in the menu.
2.2 USAGE
2.2.1 Preparation (once per aircraft)
- Configure your controls for your current aircraft
- Save the current settings with [Plugins/X-Assign/Save/Save AIRCRAFT set 1]
- Switch to an other aircraft where you would like to have different control settings
- Configure your controls for this aircraft
-
Save the current settings with [Plugins/X-Assign/Save/Save AIRCRAFT set 1]
(Yes, always save to “AIRCRAFT set 1” what you would like to be the default settings for the CURRENT aircraft! Every aircraft has its own set # 1, set # 2 and set # 3!) - Continue with step 3., if you like to configure even more aircraft at this point.
- Load an aircraft that has an “AIRCRAFT set 1” previously saved.
- DONE (as the “AIRCRAFT set 1” gets loaded automatically)
Use “AIRCRAFT set 1”, “AIRCRAFT set 2” and “AIRCRAFT set 3” to switch between configurations for the CURRENT aircraft.
Use the “GLOBAL sets” as templates for different aircraft types or to transfer settings from one aircraft to an other.
Assign buttons or keys to load and save the sets without mousing the menu.
3 SYSTEM REQUIREMENTS
OS: Linux, Mac, Windows, all 32+64 Bit
X-Plane: should work with 9 + 10, currently not compatible with X-Plane 11
4 INSTALLATION
Unzip the folder "xassign" into "X-Plane/Resources/plugins/".
There should be a structure like "X-Plane/Resources/plugins/xassign/*" now.
5 FILES
Files coming with this plugin:
xassign/mac.xpl
xassign/32/[lin|win].xpl
xassign/64/[lin|win].xpl
xassign/X-Assign_README.txt
xassign/X-Assign_README.pdf
Files created by this plugin:
Output/preferences/Set X-Plane.prf.[1-3].axes (old global sets)
plugins/xassign/X-Assign-Global-Set.[1-3].axes (new global sets)
Path/to/your/aircraft/aircraft_name.[32|64].[1-3].axes (individual aircraft sets)
6 FAQ
Q: Why if I update the X-Plane program ( i.e. from 10.32 to 10.35 ) I loose all the X-Assign settings?
A: X-Assign can identify buttons only by their numbers, those numbers can change during X-Plane updates. There is not much we can do about this.
Q: Why do some aircraft permanently change some button assignment?
A: X-Assign can identify buttons only by their numbers, those numbers can be changed by your aircraft. See the WORKAROUND (2↑) in the DESCRIPTION section.
Q: Which is the correct sequence to store the commands and view setting with X-Assign, inside of X-Plane?
A: a. Configure your aircraft in the Joystick&Equipment menu
b. Save your settings with X-Assign/Save/Save AIRCRAFT set 1. Only set 1 will load automatically with the aircraft. All other sets are optional and load only manually.
c. continue with an other aircraft
b. Save your settings with X-Assign/Save/Save AIRCRAFT set 1. Only set 1 will load automatically with the aircraft. All other sets are optional and load only manually.
c. continue with an other aircraft
Q: What are those GLOBAL sets for?
A: The GLOBAL sets are meant to be temporary storage places available to all aircraft.
Q: How do I bind buttons or keys in X-Plane?
Q: How do I configure anything in X-Plane?
A: RTFM: X-Plane/Instructions/
7 TODO
- save key assignments (if possible at all)
- fix issue with custom commands (number can change at run time, see WORKAROUND)
8 CHANGES
3.0b7 universal by Bill again!
- Bugfix for Linux (CTD when loading a set)
3.0b6 universal by Bill again!
- bug fixed, accessing the sub-menu could have crashed X-Plane
3.0b5 universal by Bill (sparker)
- menu option Vocal output added, on by default
- menu option DEBUG added, on by default in beta builds, else will be off by default
- global sets moved to the plugins folder
this will prevent your global sets from being deleted with the preferences folder and assure you get rid of the files if you delete X-Assign completely. If there is no file in the new place, I will try to load the old file from the old path. This should mean a seamless transition to the new path.
this will prevent your global sets from being deleted with the preferences folder and assure you get rid of the files if you delete X-Assign completely. If there is no file in the new place, I will try to load the old file from the old path. This should mean a seamless transition to the new path.
- finally fixed the file name and path for the global sets
3.0b4 win32
- auto load now via the OneShotFlightLoop only. this prevents us from loading anything until we really should.
3.0b3 universal by sparker
- bug fix, b1 did not save correctly
3.0b1
- Saving of plugin enabled/disabled states has been removed from this plugin entirely. This feature is now available as an extra plugin.
2.2b3
- Auto-save plugin enable/disable states on exit is back.
2.2b2
- Bug-fix: fallback path was not composed right
2.2b1
- saving individual settings for 32 and 64 Bit versions of X-Plane
- version-independent savings get loaded if no other is present
2.1b1
- adding key/button commands for all Sets saving/loading.
2.0rc3 (never released?)
- win32, trying to fix issue with custom commands by checking the numbers on every load/save
2.0rc2
- bug-fixes:
- running in X-Plane 9.70 again
- no longer saving a non-existing set #1 when loading an aircraft
- universal build by Bill (sparker).
2.0rc1 universal build by sparker. THANKS AGAIN!
2.0b3 still win32 only
- Bug-fix for the initial loading when X-Plane just starts.
2.0b1 still win32 only
- saving and restoring "plugin enabled" status for all installed plugins with any individual aircraft
1.1b3 still win32 only
- fixed a bug preventing us from restoring advanced axis settings
1.1b1 win32 only for now (BETA!)
- saving augmentation, centering, null-zone and sensitivity for any individual aircraft as well
010
- 64 Bit support added, credits go to Bill (sparker)!
- Menu again redone on user request
009
- Menu redone on user request
008
- 3 global sets added. also loadable via button command.
- not auto saving set number one on acf load if it does not exist. still auto saving if you hit a load button and the set does not yet exist.
004
- saving FOV
- 3 sets of settings for all platforms now
- new naming of the saved files: there will now always be an index corresponding to the setting number from the interface. IF YOU CARE about your previously saved settings, go to that aircraft folder, rename the file aircraft.acf.axes to aircraft.acf.1.axes. If there already is a set number 1. rename that to 2 and so on. you get it.
003
- saving, if no set exists
- mac version thanks to dr.coolgood again for building!
- 3 sets of settings (MAC and LIN only)
- README.txt
- FAT structure
002
- saving button and axis assignments
- bindable commands to load set 1 and set 2
- barbarossa/xassign/load_1
- barbarossa/xassign/load_2
001
- axes only
What's New in Version 3.0b7 universal See changelog
Released
- 3.0b7 universal by Bill
- - Bugfix for Linux (CTD when loading a set)
