First things first, here's the software. A detailed description with usage and configuration instructions follows.
Download Current Version (1.2.2)
Last updated: 03.05.2013
* Fixed an issue that sometimes caused the player to stop moving after attacking.
XInput Mapper (for lack of a better name), is an application written solely for the purpose of enabling Xbox 360 support for Torchlight II. I may extend this to support other games in the future, hence the generic name.
The original purpose and motivation behind this was to allow my 7 year old son to play the game with me, as he's much more comfortable using a gamepad than a keyboard and mouse. I looked into using existing third party apps, such as xpadder and a few others, but they either did not do everything I wanted them to or they were too complex to set up. I decided it would be easier to start from scratch and roll my own.
This is a stand-alone tool written exclusively for Torchlight II, which means I'm able to tweak more than you normally could using more generic controller mapping software. I've also provided a default (and customizable) configuration out of the box. Just launch the app (it sits in the system tray - no UI) and your Xbox360 controller is ready to use.
There is nothing magic or dangerous about this application, it simply intercepts gamepad events and forwards them to the Torchlight II window as input events.
Simply unzip to a directory of your choice and run XInputMapper. Connect your Xbox controller and that's all there is to it.
The zip contains the following files:
- XInputMapper.exe - the application
- t2.mappings - controller mapping configuration
- t2mappings.jpg - an image of the default mapping configuration
- changelog.txt - revision history
The t2.mappings file contains all of the configurable controller mappings. If you open this file with a text editor (i.e. notepad), you can read descriptions of all supported configuration options. If you change this file, simply restart XInputMapper for the changes to take effect.
The default controller mappings are shown below. These went through a few iterations and I'm fairly happy with the current mappings. Almost every action in the game is mapped, including 8 of the 10 quickslots. There are actually a few unused button combinations that I didn't bother mapping with this default configuration (such as DPad+Modifier), so you could easily map any remaining actions to them if you like.
Tips and Troubleshooting:
- If your controller is not working at all in Torchlight II, chances are that Torchlight II is running at a higher privilege level than XInputMapper. The easiest way to fix this is to run XInputMapper.exe as Administrator.
- If the left analog stick is not moving your player (or if any other default controls are not working), most likely there was no key mappings file for XInputMapper to parse. Try going into Settings->Controls within Torchlight II and clicking the green checkmark (accept button). This forces creation of your KeyBindings.dat within the Torchlight II save folder. Restart XInputMapper or select the 'Refresh Mappings' menu option to (hopefully) resolve your problems.
- If you get an error when starting XInput Mapper stating "Unable to load Torchlight II key bindings (failed to lookup Documents folder)", try manually specifying the path to your Torchlight II "save" folder via the T2SavePath option in t2.mappings.
- The default player control mappings (which rely on a 'move circle' in the middle of the screen) assume a fully zoomed out camera. This will be just fine for most players. However, if you decide to change the camera zoom, the move circle size may need to be increased for movement to work smoothly. You can update the default move circle size by changing the 'MoveCircleSize' setting in t2.mappings. You can also update the move circle size on the fly while playing, using the 'Set Move Circle' and 'Reset Move Circle' actions (see controller image above for default mappings).
- If you change your control settings from within Torchlight II or your t2.mappings file while XInputMapper is running, right click the system tray icon and select 'Refresh Mappings' to have the tool pick up your changes.
- XInputMapper will currently only work with Torchlight II when the game is on your primary monitor.
- Use the Quickbar for your most frequently used attacks and skills, since the buttons are easier to press. Assign less frequently used skills to the left and right shoulder buttons (Left and Right mouse buttons in default T2 controls).
* See download link above for changelog.
Please post any bugs or feedback.