You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Modifies the DCS control scripts to allow merging of user configured input commands from "Saved Games/DCS/" without modifying the original source files: https://github.com/Quaggles/dcs-input-command-injector/
A mod that allows you to configure custom keybind entries inside your `Saved Games/DCS/` folder instead of inside your game folder, when DCS is run these entries are merged in with the default aircraft entries. This method avoids having to manually merge your control changes into each aircrafts default controls when DCS updates.
7
+
A mod that allows you to configure custom input commands inside your `Saved Games/DCS/` folder instead of inside your game folder, when DCS is run these commands are merged in with the default aircraft commands. This method avoids having to manually merge your command changes into each aircrafts default commands when DCS updates.
8
8
9
9
## The goal of this mod
10
10
11
-
Commonly in DCS users with unique input systems will need to create custom keybinds to allow them to use certain aircraft functions with their HOTAS. Some examples are:
11
+
Commonly in DCS users with unique input systems will need to create custom input command to allow them to use certain aircraft functions with their HOTAS. Some examples are:
12
12
13
13
* Configuring 3 way switches on a Thrustmaster Warthog HOTAS to control switches the module developer never intended to be controlled by a 3 way switch
14
14
* Configuring actions that only trigger a cockpit switch while a button is held, for example using the trigger safety on a VKB Gunfighter Pro to turn on Master Arm while it's flipped down and then turn off Master Arm when flipped up
15
-
* Adding keybinds that the developer forgot, for example the Ka-50 has no individual "Gear Up" and Gear Down" binds, only a gear toggle
15
+
* Adding control entries that the developer forgot, for example the Ka-50 has no individual "Gear Up" and Gear Down" commands, only a gear toggle
16
16
17
-
In my case, on my Saitek X-55 Throttle there is an airbrake slider switch that when engaged registers as a single button being held down, when the slider is disengaged the button is released. In DCS by default few aircraft support this type of input so a custom input is needed, in my case for the F/A-18C:
17
+
In my case, on my Saitek X-55 Throttle there is an airbrake slider switch that when engaged registers as a single button being held down, when the slider is disengaged the button is released. In DCS by default few aircraft support this type of input so a custom input command is needed, in my case for the F/A-18C:
Until now the solution was to find the control definition file `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C\joystick\default.lua` and insert your command somewhere inside of it, if you weren't using a mod manager then every time the game was updated your change would be erased and you'd need reinsert your commands into the files for every aircraft you changed.
23
+
Until now the solution was to find the control definition file `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C\joystick\default.lua` and insert your custom command somewhere inside of it, if you weren't using a mod manager then every time the game was updated your change would be erased and you'd need reinsert your commands into the files for every aircraft you changed.
24
24
25
-
If you were using a mod manager such as OVGME if you reapplied your mod after an update and the developers had changed the control binds things could break as things could conflict.
25
+
If you were using a mod manager such as OVGME if you reapplied your mod after an update and the developers had changed the input commands things could break and conflict.
26
26
27
-
With this mod you should just need to re-enable it after every update with OVGME and your custom control binds are safe with no need no change anything.
27
+
With this mod you should just need to re-enable it after every update with OVGME and your custom commands are safe with no need no change anything.
28
28
29
29
## Installation
30
30
31
-
1. Go to the [latest release](https://github.com/Quaggles/dcs-keybind-injector/releases/latest)
32
-
2. Download `DCS-Keybind-Injector-Quaggles.zip`
31
+
1. Go to the [latest release](https://github.com/Quaggles/dcs-input-command-injector/releases/latest)
@@ -38,22 +38,22 @@ With this mod you should just need to re-enable it after every update with OVGME
38
38
39
39
### Manual
40
40
3. Extract the zip
41
-
4. Find the `DCS-Keybind-Injector-Quaggles/Scripts` folder
41
+
4. Find the `DCS-Input-Command-Injector-Quaggles/Scripts` folder
42
42
5. Move it into your `DCSWorld/` folder
43
43
6. Windows Explorer will ask you if you want to replace `Data.lua`, say yes
44
44
7. Repeat this process every DCS update, if you use OVGME you can just reenable the mod and it handles this for you
45
45
46
46
## Configuration
47
47
48
-
New commands are configured in the `Saved Games\DCS\QuagglesKeybindInjector` directory, lets go through how to configure a hold action for the speedbrake on the F/A-18C Hornet.
48
+
New commands are configured in the `Saved Games\DCS\InputCommands` directory, lets go through how to configure a hold command for the speedbrake on the F/A-18C Hornet.
49
49
50
50
### Setting the folder structure
51
51
52
-
For the F/A-18C the default input files are located in `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C`, inside this directory are folders with the generic names of your input devices, these can include `joystick`, `keyboard`, `mouse`, `trackir` and `headtracker`. Each generic input folder contains `default.lua` which is the default set of keybinds the developer has configured, this is an important reference when making your own commands. It also contains many lua files for automatic binding of common hardware like the Thrustmaster Warthog HOTAS but these can be ignored.
52
+
For the F/A-18C the default input files are located in `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C`, inside this directory are folders with the generic names of your input devices, these can include `joystick`, `keyboard`, `mouse`, `trackir` and `headtracker`. Each generic input folder contains `default.lua` which is the default set of commands the developer has configured, this is an important reference when making your own commands. It also contains many lua files for automatic binding of common hardware like the Thrustmaster Warthog HOTAS but these can be ignored (`*.diff.lua`).
53
53
54
-
The DCS input folder structure needs be duplicated so that the folders relative to `DCSWorld\Mods\aircraft` are placed in `Saved Games\DCS\QuagglesKeybindInjector`. The folder structure needs to match <b>EXACTLY</b> for each generic input device you want to add commands to. In my F/A-18C Speedbrake Hold example that means I will create the structure `Saved Games\DCS\QuagglesKeybindInjector\FA-18C\Input\FA-18C\joystick\`, for an F-14B in the RIO seat I would create `Saved Games\DCS\QuagglesKeybindInjector\F14\Input\F-14B-RIO\joystick`.
54
+
The DCS input folder structure needs be duplicated so that the folders relative to `DCSWorld\Mods\aircraft` are placed in `Saved Games\DCS\InputCommands`. The folder structure needs to match <b>EXACTLY</b> for each generic input device you want to add commands to. In my F/A-18C Speedbrake Hold example that means I will create the structure `Saved Games\DCS\InputCommands\FA-18C\Input\FA-18C\joystick\`, for an F-14B in the RIO seat I would create `Saved Games\DCS\InputCommands\F14\Input\F-14B-RIO\joystick`.
55
55
56
-
<b>IMPORTANT:</b> For some aircraft the 1st and 3rd folders have different names, for example `F14\Input\F-14B-Pilot` make sure this structure is followed correctly or your inputs won't be found
56
+
<b>IMPORTANT:</b> For some aircraft the 1st and 3rd folders have different names, for example `F14\Input\F-14B-Pilot` make sure this structure is followed correctly or your inputs won't be found.
57
57
58
58
An example of the folder structure for some aircraft I have configured:
59
59
@@ -63,7 +63,7 @@ An example of the folder structure for some aircraft I have configured:
Inside the generic input folder `Saved Games\DCS\QuagglesKeybindInjector\FA-18C\Input\FA-18C\joystick\` etc we will create a lua script called `default.lua`, paste in the following text, it contains the Speedbrake Hold example and some commented out templates for the general structure of commands
66
+
Inside the generic input folder `Saved Games\DCS\InputCommands\FA-18C\Input\FA-18C\joystick\` we will create a lua script called `default.lua`, paste in the following text, it contains the Speedbrake Hold example and some commented out templates for the general structure of commands
67
67
68
68
```lua
69
69
return {
@@ -80,19 +80,19 @@ return {
80
80
}
81
81
```
82
82
83
-
To work out what to put in these templates reference the developer provided default keybinds file, for the F/A-18C that is in `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C\joystick\default.lua`
83
+
To work out what to put in these templates reference the developer provided default input command file, for the F/A-18C that is in `DCSWorld\Mods\aircraft\FA-18C\Input\FA-18C\joystick\default.lua`
84
84
85
85
I'd recommend setting a unique category name for your custom commands so that they are easy to find in the menu.
86
86
87
-
## Extras
88
87
### Hardlinking
89
-
If you want to have a set of commands bindable to both your HOTAS and your keyboard consider [hardlinking](https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html) your `default.lua` from your `joystick` folder to your `keyboard` folder.
88
+
If you want to have a set of custom commands for both your HOTAS and your keyboard consider [hardlinking](https://schinagl.priv.at/nt/hardlinkshellext/linkshellextension.html) your `default.lua` from your `joystick` folder to your `keyboard` folder.
90
89
91
-
By hardlinking both files look like they are in different directories to Windows and DCS but they actually refer to the same file on the disk meaning if you modify one you automatically modify the other
90
+
By hardlinking both files look like they are in different directories to Windows and DCS but they actually refer to the same file on the disk meaning if you modify one you automatically modify the other.
91
+
92
+
## Examples
92
93
93
94
### Request AWACS Nearest Bandit
94
95
Allows binding request bogey dope to your HOTAS, not every aircraft has this by default in DCS
@@ -120,13 +120,13 @@ Note: May get broken by Heatblur at any time and could be considered unscrupulou
120
120
```
121
121
122
122
# FAQ
123
-
## My new control bindings aren't showing up ingame
123
+
## My new input commands aren't showing up ingame
124
124
First look at `Saved Games\DCS\Logs\dcs.log` at the bottom is likely an error telling you what went wrong in your code, for finding syntax errors in lua I would recommend Visual Studio Code with the vscode-lua extension, it should highlight them all in red for you making it easy to find that missing comma 😄
125
125
126
-
If you have no errors open the mod version of `Scripts\Input\Data.lua` and find the line `local quagglesLoggingEnabled = false` and set it to `true` you will get outputs in the `Saved Games\DCS\Logs\dcs.log` file as the script tries to handle every lua control file, it will tell you the path to the file it is trying to find in your Saved Games folder so you can ensure your folder structure is correct. Remember `../` in a path means get the parent directory.
126
+
If you have no errors open the mod version of `Scripts\Input\Data.lua` and find the line `local quagglesLoggingEnabled = false` and set it to `true` you will get outputs in the `Saved Games\DCS\Logs\dcs.log` file as the script tries to handle every lua control file, it will tell you the path to the files it is trying to find in your Saved Games folder so you can ensure your folder structure is correct. Remember `../` in a path means get the parent directory.
127
127
128
128
## HELP MY CONTROLS MENU IS BLANK/MISSING
129
-
Don't worry, this doesn't mean you've lost all your keybinds, it means there was an error somewhere in the code loading the keybinds, usually my injector catches any errors in the `default.lua` and reports them `Saved Games\DCS\Logs\dcs.log`. If you see nothing there it could mean that DCS has been updated and changed the format of the `Scripts/Input/Data.lua` file the mod changes, simple uninstall the mod and the game should work as normal, then wait for an updated version of the mod.
129
+
Don't worry, this doesn't mean you've lost all your binds, it means there was an error somewhere in the code loading the commands, usually my injector catches any errors in the `default.lua` and reports them `Saved Games\DCS\Logs\dcs.log`. If you see nothing there it could mean that DCS has been updated and changed the format of the `Scripts/Input/Data.lua` file the mod changes, simple uninstall the mod and the game should work as normal, then wait for an updated version of the mod.
130
130
131
131
## Disclaimer
132
-
I am not responsible for any corrupted keybinds when you use this mod, I've personally never had an issue with this method but I recommend <b>always</b> keeping backups of your keybinds (`Saved Games\DCS\Config\Input`) if you value them.
132
+
I am not responsible for any corrupted binds when you use this mod, I've personally never had an issue with this method but I recommend <b>always</b> keeping backups of your binds (`Saved Games\DCS\Config\Input`) if you value them.
0 commit comments