UltraStik360 controller map plugin

[maabus]

I searched around and could not find a way to easily map my UltraStik360 based per game. Hopefully this will help others who use the UltraStick360

This plugin was tested with LaunchBox 13.19, but should work with any version that has the controllers added to the metadata. 

Plugin info:

This will read the controllers located in a game's metadata, and will load your UltraMap map for that controller on game startup.
Controller names can be renamed. You can also add a second controller, and it will load the second controller instead of the first. 
For example, Q-Bert has a controller listed as 4-Way Joystick by LaunchBox Metadata. Normally this would load the standard 4-way map, like pac-man, but Q-Bert is a diagonal setup. You could rename the 4-way joystick name in the metadata for Q-bert, or add a second controller called 4-way diagonal or whatever you want. The plugin will read the second controller and load it instead of the standard 4-way controller. I left the preloaded controller in just incase LaunchBox ever updates the controllers for whatever reason. 
You can have as many or as few maps as you want. If the plugin can't find the controller in the config.ini it will load the default map. For example, if for Pac-Man I did not have 4-way joystick in my config, it will load load my 8-way default map. This maps all UltraStik360 controllers. I'm not sure how to map them individually.

You can have it load your default map when exiting a game, or keep the last loaded map by changing the setting in the .ini file. 
 

Example of multiple controllers for Q-Bert. My 4-way diagonal joystick will be mapped instead of the regular 4-way joystick. You could also just remove the regular 4-way joystick if you want You can name your joystick whatever you want, just make sure it matches in the UltraStik360.ini. I could have named my 4-way diagonal controller something like "4-way diagonal for Q-bert games".

 

Installation:
Extract UltraMap360 to LaunchBox plugins folder. You need the UltraStik360.dll, and UltraStick360.ini.
Make sure you have UltraMap installed. It does not need to be installed in the default location. Update the .ini file with
the installation location.
Make sure your .ugc map files are in the UltraMap folder.
Add the controller name from the metadata to the config. You can rename the controller names to whatever you want, just make
sure the config file matches the metadata.
You can add a second controller to the metadata, and the second controller will be mapped instead of the first controller

Config file:
settings section:
UltraMapExe = Path to your UltraMap.exe 
DefaultMap = Default map if controller is not listed or to load when exiting game if restore default is true
RestoreDefault = set to true to load default map on exit. Set to false to keep current map loaded when exiting game

Maps section:
Controller name in metadata = UltraMap .ugc file name located in UltraMap path
Make sure controller name matches the name in metadata. The .ugc file name can contain spaces
Here are the controller names for joysticks in LaunchBox metadata, or you can add your own controller to the metadata
8-Way Joystick
4-Way Joystick
Horizontal Joystick
Double 4-Way Joysticks
Double Vertical Joysticks
Half 8-Way Joystick
Triple Horizontal Joystick
Double 8-Way Joysticks
16-Way Joystick
Double Horizontal Joysticks
Triple 16-Way Joysticks
Generic Flight Stick
Vertical Joystick
Half 4-Way Joystick
Double Half 8-Way Joysticks

Config Example:
[Settings]
UltraMapExe=C:\Program Files (x86)\UltraMap
DefaultMap=8-way.ugc
RestoreDefault=true

[Maps]
8-Way Joystick=8-way.ugc
4-Way Joystick=4-way.ugc
4-Way Diagonal Joystick=4-Way, Diagonals Only.ugc
Horizontal Joystick=2-Way, Mostly Left & Right.ugc

Thanks:
Dinomight - Thanks for sharing your source code for your servostik plugin. I was finally able to figure out how to create a plugin
for LaunchBox after seeing your code.

 

Disclaimer:

This is my firt plugin, and i think i have all bugs issues fixed, but please let me know if you come across any issues. It will alert you if your UltraMap path is incorrect but I think any other error will just not do anything. UltraMap will alert you if your map file name is incorrect. If you need to change the ini file, it is usually best to restart Launchbox. I have not tested with BigBox, but I think it should work. 

UltraStik360.zip

Edited Wednesday at 10:53 PM by maabus

[maabus]

found an error when no controller is in metadata. updated plugin.

UltraStik360 plugin.zip