Grim Fandango on Linux with xboxdrv and residualVM

############################## 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 #