Elite Wiki - User contributions [en]

Linux Joysticks and Gamepads

2011-01-19T12:52:02Z

Getafix:

== Setting up a Joystick or Gamepad in Oolite ==
 
Linux distributions, nowadays, have many joystick and gamepad drivers built in. However, even if they work out of the box, they offer limited configuration options. An alternative to the xpad kernel driver is the [[http://pingus.seul.org/~grumbel/xboxdrv/ XBoxDrv]]. It is a user-space driver, giving a variety of configuration options for all controllers. For XBox controllers, this alternative works without the need of having a Linux distribution with XBox controller support. 

The instructions below describe how to set up XBoxDrv for use with an XBox 360 controller on Ubuntu Lucid, nevertheless, the XBoxDrv author has extended it to also work with non-XBox controllers. If anyone gets it to work with a non-XBox controller, feel free to expand this wiki page with any information helpful to others trying to do the same. 
''(quote from xboxdrv changelog: support for reading from evdev, this allows the use of regular PC joysticks or the Playstation 3 controllers with xboxdrv, useful if you need configurability or joy2key-like functionality, but don't have a Xbox360 gamepad.)'' 

1. Install [[http://pingus.seul.org/~grumbel/xboxdrv/ XBoxDrv]] - for Ubuntu there is a binary package. Installation instructions are [[http://github.com/Grumbel/xboxdrv/blob/master/README here]]. 
2. Don't worry about all the stuff about sudo modprobe uinput and changing permissions on /dev/uinput etc. 
3. Download [[http://www.box.net/shared/koxvusxtap runxboxdrv]], a wrapper I wrote to make using xboxdrv very simple. Hopefully, this will be included in a future release of XBoxDrv. 
4. Also in the download are an Oolite configuration for xboxdrv: oolite.ini and a key configuration for Oolite to go with it: keyconfig.plist 
5. Extract them to your home folder and move keyconfig.plist to ~/.Oolite/Addons 
6. Make runxboxdrv executable:
$ chmod +x ~/runxboxdrv
 
7. Execute the following to get the oolite executable path: ''(the oolite executable path may vary depending to your installation)''
$ which oolite
/usr/bin/oolite
$
and then execute: ''(for the sake of this tutorial we will assume the path /usr/bin/oolite.)''
$ ~/runxboxdrv --config=~/oolite.ini /usr/bin/oolite
 
8. The only joystick setup needed in Oolite is to set up the axes. The left hand analog stick left-right should be roll. The right hand stick is up, down, left, right. 
9. Open oolite.ini in a text editor to see the mappings of everything else. Descriptions of the option names can be found at [[http://pingus.seul.org/~grumbel/xboxdrv/xboxdrv.html xboxdrv manpage]] 
10. The left shoulder button acts like a shift key and effectively almost doubles the number of buttons. 

If you have any problems, post on the [[http://www.aegidian.org/bb/viewforum.php?f=9 Oolite Linux Forum]].

[[Category:Oolite]]

Linux Joysticks and Gamepads

2011-01-12T09:33:16Z

Getafix: /* Setting up a Joystick or Gamepad in Oolite */

== Setting up a Joystick or Gamepad in Oolite ==
 
Linux distributions such as Ubuntu Lucid have many joystick and gamepad drivers built in. While they work out of the box, they offer limited configurability. Here I will outline a better alternative which gives far greater configurability for all controllers. For XBox controllers, the alternative works irrespective of whether your Linux distribution includes XBox controller support. 

The instructions below describe how to set up a userspace driver called xboxdrv for use with an XBox 360 controller. The author of xboxdrv has extended it to also work with non-XBox controllers, so if anyone tries this with a non-XBox controller and gets it to work, please expand this wiki page with any information helpful to others trying to do the same. (xboxdrv author wrote: support for reading from evdev, this allows the use of regular PC joysticks or the Playstation 3 controllers with xboxdrv, useful if you need configurability or joy2key-like functionality, but don't have a Xbox360 gamepad.) 

1. Install [[http://pingus.seul.org/~grumbel/xboxdrv/ XBoxDrv]] - for Ubuntu there is a binary package. Installation instructions are [[http://github.com/Grumbel/xboxdrv/blob/master/README here]]. 
2. Don't worry about all the stuff about sudo modprobe uinput and changing permissions on /dev/uinput etc. 
3. Download [[http://www.box.net/shared/koxvusxtap runxboxdrv]], a wrapper I wrote to make using xboxdrv very simple. Hopefully, this will be included in a future release of XBoxDrv. 
4. Also in the download are an Oolite configuration for xboxdrv: oolite.ini and a key configuration for Oolite to go with it: keyconfig.plist 
5. Extract them to your home folder and move keyconfig.plist to ~/.Oolite/Addons 
6. Make runxboxdrv executable:
$ chmod +x ~/runxboxdrv
 
7. Execute the following to get the oolite executable path: ''(the oolite executable path may vary depending to your installation)''
$ which oolite
/usr/bin/oolite
$
and then execute: ''(for the sake of this tutorial we will assume the path /usr/bin/oolite.)''
$ ~/runxboxdrv --config=~/oolite.ini /usr/bin/oolite
 
8. The only joystick setup needed in Oolite is to set up the axes. The left hand analog stick left-right should be roll. The right hand stick is up, down, left, right. 
9. Open oolite.ini in a text editor to see the mappings of everything else. Descriptions of the option names can be found at [[http://pingus.seul.org/~grumbel/xboxdrv/xboxdrv.html xboxdrv manpage]] 
10. The left shoulder button acts like a shift key and effectively almost doubles the number of buttons. 

If you have any problems, post on the [[http://www.aegidian.org/bb/viewforum.php?f=9 Oolite Linux Forum]].

[[Category:Oolite]]

Oolite Keyboard Controls

2008-04-30T14:13:59Z

Getafix: Switch HUD on/off key added.

== Default Key Assignments ==

Linux users will find the following key assignments in <code> /usr/lib/Oolite/oolite.app/Contents/Resources/Config/keyconfig.plist </code> (assuming you did a default installation!).
++'''Please Note''': All characters in capitals are shift + character, i.e. R = shift + r.++

{| border="1" cellpadding="9" align="center"
|+
|-style="background:darkslateblue; color:white"
! Action !! Key !! Keycode (Dec) !! Keycode (Hex) !! Notes
|-align="center"
! Roll Left
| Left arrow || 253 || FD ||
|-align="center"
! Roll Right
| Right arrow || 252 || FC ||
|-align="center"
! Pitch Forward
| Up arrow || 255 || FF ||
|-align="center"
! Pitch Back
| Down arrow || 254 || FE ||
|-align="center"
! Increase Speed
| w || 119 || 77 ||
|-align="center"
! Inject Fuel
| i || 105 || 69 ||
|-align="center"
! Decrease Speed
| s || 115 || 73 ||
|-align="center"
! Fire Lasers
| a || 97 || 61 ||
|-align="center"
! Target Missile
| t || 116 || 74 ||
|-align="center"
! Untarget Missile
| u || 117 || 75 ||
|-align="center"
! Launch Missile
| m || 109 || 6D ||
|-align="center"
! Next Missile
| y || 121 || 79 || [[Multi-Targeting System]] required
|-align="center"
! Activate Ident System
| r || 114 || 72 ||
|-align="center"
! Cycle forward between targets
| + || 43 || 2B || [[Target System Memory Upgrade]] required
|-align="center"
! Cycle backward between targets
| - || 45 || 2D || [[Target System Memory Upgrade]] required
|-align="center"
! Activate ECM
| e || 101 || 65 ||
|-align="center"
! Launch Escape Pod
| Esc || 27 || 1B ||
|-align="center"
! Energy Bomb
| Tab || 9 || 09 ||
|-align="center"
! Energy Bomb (On the Mac)
| 9 || ? || ? ||
|-align="center"
! Galactic Hyperspace
| g || 103 || 67 ||
|-align="center"
! Emergency Hyperdrive
| H || 72 || 48 || won't work, probably
|-align="center"
! Hyperspace
| h || 104 || 68 ||
|-align="center"
! Jumpdrive
| j || 106 || 6A ||
|-align="center"
! Dump Cargo
| d || 100 || 64 ||
|-align="center"
!Cycle cargo to dump
| R || 82 || 52 ||
|-align="center"
! Autopilot
| c || 99 || 63 ||
|-align="center"
! Autodock
| D || 68 || 44 ||
|-align="center"
! Take a Snapshot
| * (shift+8) || 42 || 2A || Written to $HOME/oolite-saves
|-align="center"
! Docking Music Toggle
| s || 115 || 73 || Only if Docking Computer fitted!
|-align="center"
! Scanner Zoom
| z || 122 || 7A ||
|-align="center"
! Map Dump
| ! (shift+1) || 33 || 21 ||
|-align="center"
! Map Home
| Home || 302 || 12E || Selects your current system
|-align="center"
! Comms Log
| ` || 96 || 60 ||
|-align="center"
! Next Compass Mode
| \ || 92 || 5C ||
|-align="center"
! Display Frame Rate
| F || 70 || 46 || Displays frame rate, object- and collision-counter and player's pwm-coordinates.
|-align="center"
! Pause Game
| p || 112 || 70 ||
|}

 

== Debugging Keys ==

The following keys only work while you have paused the game by pressing '''p'''. Most of them will dump debug-messages to Oolite's logfile. This is highly useful for debugging OXPs or helping to debug Oolite.

{| border="1" cellpadding="9" align="center"
|+
|-style="background:darkslateblue; color:white"
! Action !! Key !! Notes
|-align="center"
! Entity Dump
| 0 (zero) || Writes a list of all entities in your current system to the logfile. Useful e.g. to find out whether a certain ship exists.
|-
|-align="center"
! Collision Debug
| b || Enables collision test debugging.
|-
|-align="center"
! Octree Debug
| c || Enables octree debugging, which will print the line “DEBUG Octrees collide!” in the logfile whenever two objects collide.
|-
|-align="center"
! Complete Debug
| d || Enables all debug flags.
|-
|-align="center"
! Shader Debug
| s || Enables shader debug messages.
|-
|-align="center"
! Entity Boxes
| x || Enables drawing of bounding boxes around all entities in the game.
|-
|-align="center"
! Planet Textures
| t || Turns on the experimental on-the-fly generation of planet textures. Dock and launch or hyperjump to see the effect. This feature is still under development and [http://www.aegidian.org/bb/viewtopic.php?t=3644 may produce unintended results]. Therefore it is disabled in Oolite 1.69.1.
|-
|-align="center"
! Switch off HUD
| o || Switches of the HUD.
|-
|-align="center"
! End Debugging
| n || Disables all debug flags and the textured planets. Switches the HUD back on.
|-
|}

 

== Changing Key Assignments ==

If you want to change key assignments ''don't'' alter the default file. Instead copy <code> keyconfig.plist </code> from
<code> /usr/lib/Oolite/oolite.app/Contents/Resources/Config/ </code> to
<code> /usr/lib/Oolite/AddOns/Config/</code>.
(Note that you may need to create the Config directory first.)

You can edit <code> keyconfig.plist </code> with any standard text editor. You'll find a list of Linux keycodes [http://www.comptechdoc.org/os/linux/howlinuxworks/linux_hlkeycodes.html here]. Note that Oolite uses ''decimal'' values whereas most keycodes are expressed in ''hexadecimal''. This can cause confusion. For example the comma key produces a keycode of 2C (hex) which translates to 44 (decimal), whereas keycode 44 (hex) refers to the uppercase "D" key, which is actually 68 (decimal)! (If you don't have a hex/decimal calculator handy try [http://www.lookuptables.com/ this table] or [http://www.blooberry.com/indexdot/color/hexcalc.htm this online converter].)

== Undocumented Keys ==

The following keys aren't yet official so your mileage may vary!

{| border="1" cellpadding="9" align="center"
|+
|-style="background:darkslateblue; color:white"
! Action !! Key !! Keycode (Dec) !! Keycode (Hex) !! Notes
|-align="center"
! Toggle Mouse Control
| M || 77 || 4D || When activated, the mouse becomes a virtual joystick. (Under Linux: only in fullscreen mode) The left mouse button fires and the right should re-centre your ship.
|-
|-align="center"
! Dump Target State
| undefined || undefined || undefined || By inserting the key <code> key_dump_target_state </code> to your keyconfig.plist and giving it a value you get a complete dump of your current target in the logfile. If no target is chosen, the player's state will be dumped.
|-
|}

 

== Silly Keyboard Tricks ==

* Change <code> key_launch_missile </code> to 112. Now you'll need to hit "p" to launch a missile - which also pauses the game. You'll sometimes get a nice snapshot of the departing missile!

[[category:oolite]]