############################## GRIM.XBOXDRV
############################### by Frash Pikass, 2013
#
# I wanted to play some Grim Fandango on Linux with residualVM but the keyboard
# in that game is painful... So I thought
# "Why not making an xboxdrv script for it to work with my new Xbox360
# controller?"
#
# Works just fine both in camera relative perspective and character relative
# perspective!
#
# Maps the Xbox360 controller like this:
#	-Left analog stick: arrow keys
#	-D-Pad: arrow keys (duh)
#	-Left shoulder button: examine
#	-A: use, select, enter
#	-B: pick, put away
#	-X: run
#	-Y: inventory
#	-Start: pause
#	-Back: Esc (exit from menus)
#	-Home (big Xbox button): main menu
#
# If you don't like it, you can easily change it with your favourite
# configuration (or just screw yourself: that is free too!).
#
#~############################# INGREDIENTS
#
#	- a Linux machine
#
#	- residualVM	Install it with the following terminal command in most
#	  		linux distros:
#				sudo apt-get install residualvm
#
#	- xboxdrv	Install it with the following terminal command in most
#			linux distros:
#				sudo apt-get install xboxdrv
#			NOTE: Mind that you might need to disable xpad before you
#			      install/run xboxdrv. Do it this way:
#				sudo rmmod xpad
#
#	- Xbox360 pad	Buy it from your favourite retailer, preferably NOT
#			one of those big chains like Gamestop. They are EVIL
#
#	- Grim Fandango	Buy the game from a Childhood Reseller (TM)
#			Estract the *.LAB files from both disks in a folder.
#			Save the version 1.0.1 Grim Fandango patch in the same
#			folder (http://demos.residualvm.org/patches/gfupd101.exe)
#			More info available at
#			http://wiki.residualvm.org/index.php/Grim_Fandango
#
#~############################# INSTRUCTIONS
#
# - Save the script in a file called grim.xboxdrv
#
# - Open up your favourite terminal
#
# - Plug the controller in a spare USB port
#
# - Eventually disable xpad
#	sudo rmmod xpad
#
# - Launch xboxdrv with the script with the following command:
#	sudo xboxdrv -d --config grim.xboxdrv
#
# - Launch residualVM, load Grim Fandango and have fun
#
# - When you're done playing, terminate the script with Ctrl-C in the terminal
#
#~############################# ENJOY!

[xboxdrv]
ui-clear=true
trigger-as-button = true
dpad-as-button = true
#four-way-restrictor = true
silent = true
 
[ui-axismap]
x1=KEY_LEFT:KEY_RIGHT
y1=KEY_UP:KEY_DOWN

[ui-buttonmap]
#use
a=KEY_ENTER
#pick
b=KEY_P
#run
x=KEY_LEFTSHIFT
#inventory
y=KEY_I

#examine
lb = KEY_E

#unused
#lt = BTN_RIGHT
#rt = BTN_LEFT
# rb = KEY_PAGEDOWN
# tl = KEY_BACKSPACE
# tr = KEY_SPACE
# lt = KEY_VOLUMEDOWN
# rt = KEY_VOLUMEUP

[ui-buttonmap]
dl = KEY_LEFT
dr = KEY_RIGHT
du = KEY_UP
dd = KEY_DOWN
 
[ui-buttonmap]
start = KEY_PAUSE
back  = KEY_ESC
guide = KEY_F1
 
# EOF #