3.5 KiB
bindED
This VoiceAttack plugin reads keybindings in Elite:Dangerous and stores them as VoiceAttack variables. It has originally been written by Gary (the developer of VoiceAttack) and published on the VoiceAttack forums.
You can find the original README here.
I have taken the original source code and added automatic detection of the correct bindings file and support for non-US keyboard layouts (see below for details).
Migrating from the Old Plugin
If you use this as a drop-in replacement for the initial version all commands invoking the plugin will throw an error message. Gary has asked me to change the plugin’s GUID, and the plugin with the old one will no longer be found.
That is irrelevant in basically all cases and can safely be ignored. Binds will be read automatically when VoiceAttack starts, and when they change.
Usage
You don’t have to do anything! When VoiceAttack loads, bindED will automatically detect your bindings. It will also keep a watchful eye on Elite’s bindings folder and reload them when there is a change!
If something goes awry, you can still manually call the loadbinds plugin
context to force a refresh.
If you are not using a US QWERTY keyboard layout, see below.
Support for non-US Keyboard Layouts
If you are using any non-US layout you might have noticed that some binds don’t work. Elite internally uses keycode values (a number assigned to each key on the keyboard) for its bindings but for some reason both displays and saves them as keysyms (the label on the key), according to the UK QWERTY keyboard layout. That means VoiceAttack can’t just send the keysym it reads from a binding, it has to translate it into the corresponding keycode.
The original plugin contained a EDMap.txt file that contains infomration on
that conversion for the US keyboard layout. If you are using any other layout
that information will be incorrect for any symbols that are on a different key
than they are on the US layout.
I have added the option to use maps for other keyboard layouts. In order to do
so you will have to set a text variable in VoiceAttack called bindED.layout#
to the layout you want to use. BindED will be notified of the variable changing
and reload your bindings with the appropriate key map. If the variable is not
set it will defaut to “en-us”, leaving the original behaviour intact.
I have included a map file for Neo2
(EDMap-de-neo2.txt) which is the layout that I am using personally. If you are
on a different layout, you will have to create a corresponding map file yourself
or prod me to add it. E.g. for the french AZERTY it would be EDMap-fr-fr.text
and set bindED.layout# to “fr-fr”. For US Dvorak, EDmap-en-us-dvorak and
“en-us-dvorak”. You can see where this is going.
For more information on creating new supported keyboard layouts see the Wiki.
Troubleshooting
If you run into any kinds of trouble with missing bindings the first step should
be to import and load the included bindED-reports profile. It will generate
both a list of bind names used by Elite and a report of binds that do not have a
keyboard shortcut assigned, and put them on your Desktop.
Need help beyond that? Please file an issue or hop into Discord.