1Quake 2 3In order to run Quake on the simulator and/or device, you must: 4 5 1) Configure the Sources 6 2) Build 7 3) Install 8 4) Run 9 5) Uninstall Quake (this step is optional) 10 11Configure the Sources 12--------------------- 13 14Edit src/com/android/quake/QuakeActivity.java to configure where and how Quake will obtain its data files. The 15configuration variables are: 16 17 private final static boolean USE_INTERNAL_FLASH = false; 18 private final static boolean USE_DOWNLOADER = false; 19 20This means that by default Quake will look for its files on the SD Card, and it will not 21attempt to download the files from an external web server. (Use the ./setupdevicesdcard.sh script, 22described below, to copy the data files from the Android source tree onto the device's SD Card.) 23 24Note that if USE_DOWNLOADER is set to true then you need to configure a web server to serve the Quake 25data files, and the FILE_CONFIG_URL variable needs to be set to point to the configuration file on 26the web server. Read the source for DownloaderActivity.java to figure out how to do this. 27 28Building Quake 29-------------- 30 31Quake and libQuake are built by default, as part of the standard Android build. 32If for some reason you would like to build Quake manually, you can do so by 33using the mm command: 34 35$ cd $TOP/apps/Quake 36$ mm 37 38 39Installing Quake 40---------------- 41 42Quake is not installed by default. To install Quake you need to copy the Quake executable 43files and data files to the device. 44 45Quake needs about 20 MB of space to store its data files. Quake files go on an external 46micro SD card (This is /sdcard/data/quake directory). 47 48Using the device with a microsd card: 49 50 Turn on phone, plug into your development PC/Mac using the supplied ADB cable. 51 cd $TOP/apps/Quake 52 adb remount 53 adb install $OUT/system/app/Quake.apk 54 55Make sure your device is not mounted as an USB Storage Device: 56 Press Home button on Phone 57 Press Menu 58 Select "SD card & phone storage 59 Make sure "Use for USB storage" is unchecked. 60 61Then install the Quake data files by executing this script: 62 63 ./setupdevice.sh 64 65(Or if you've set QuakeActivity.USE_INTERNAL_FLASH to false, then use this script instead:) 66 67 ./setupdevicesdcard.sh 68 69Using the emulator: 70 71 You can use Quake with the emulator, but you have to create and mount an sdcard image. 72 (Doing that is beyond the scope of this document.) 73 Once you've started the emulator with a sdcard image you can follow the directions for 74 a real device. 75 76 77Running Quake 78------------- 79 80Turn on the device 81 82Look for Quake in the Activities folder. Launch it as you would any other activity. 83It will take up to thirty seconds to start running. 84 85When Quake starts running it will display a console with some debug information, then 86go into an "attract mode" loop. 87 88Starting a game: 89 90Press space bar to bring up the main menu. 91The "Quake icon" should be next to the "Single Player" menu item. Press the 92"Enter" button twice to start the game. 93 94Controls: 95 96The Quake controls are customizable, depending upon the settings of config.cfg, 97but the defaults are: 98 99Android PC Key Command Notes 100Keypad 101---------- --------- --------------- ---------------------------------- 102Alt Space TAB +showscores Shows scores in multiplayer games 103DPad Enter ENTER +jump 104Menu ESCAPE togglemenu Shows/hides menu 105space SPACE +jump 106+ + sizeup Increases size of screen 107, , +moveleft Strafe left 108- - sizedown 109. . +moveright Strafe right 110/ / impulse 10 Toggle weapons up 1110 0 impulse 0 1121 1 impulse 1 Select weapon 1 (axe) 1132 2 impulse 2 Select weapon 2 (shotgun) 1143 3 impulse 3 Double-barrled shotgun 1154 4 impulse 4 Nailgun 1165 5 impulse 5 Super nailgun 1176 6 impulse 6 Grenade launcher 1187 7 impulse 7 Rocket Launcher 1198 8 impulse 8 Thunderbolt 120= = sizeup 121\ \ +mlook Mouse look. (Not very useful, as there is no mouse.) 122Alt w ` toggleconsole Used to enter fancy commands. 123w w +forward 124s s +back 125a a +left 126d d +right 127q q +lookup 128z z +lookdown 129v v +movedown 130f f +moveup 131t t messagemode 132DPad Up UPARROW +forward 133DPad Down DOWNARROW +back 134DPad Left LEFTARROW +left 135DPad Right RIGHTARROW+right 136Alt ALT +strafe 137@ or / CTRL +attack 138Cap SHIFT +speed 139Alt 1 F1 help (This is just an advertisement in the shareware version.) 140Alt 2 F2 menu_save 141Alt 3 F3 menu_load 142Alt 4 F4 menu_options 143Alt 5 F5 menu_multiplayer 144Alt 6 F6 echo Quicksaving...; wait; save quick 145Alt 9 F9 echo Quickloading...; wait; load quick 146Alt 0 F10 quit 147Alt t F11 zoom_in 148Alt y F12 screenshot 149<none> INS +klook 150<none> DEL +lookdown 151<none> PGDN +lookup 152<none> END centerview 153<none> MOUSE1 +attack 154<none> MOUSE2 +forward 155<none> MOUSE3 +mlook 156Alt z PAUSE pause 157Camera HOME ...not bound by default... 158----- 159 160Console Commands: 161 162timedemo demo# run time demo # (1..3) 163god turns on god mode 164fly enables fly mode 165kill commits suicide 166notarget enemies don't attack until provoked 167noclip walk through walls 168give s # gives # (where # = a number) of shotgun shells 169give n # gives # of nails 170give r # gives # of rockets/grenades 171give c # gives # of cells 172give h # gives # of health 173give # gives weapon # 174map e#m# warps to the episode and mission specified 175impulse -1 quad cheat 176impulse 9 all weapons and keys 177impulse 255 quad cheat 178 179 180 181Uninstalling Quake 182------------------ 183 184Quake has to be uninstalled in two parts: 185 a) the Quake.apk file 186 b) the data files on the sdcard 187 188Use the Phone UI to uninstall the Quake apk: 189 190 Press Home Key 191 Press Menu Key 192 Select Settings 193 Select Applications 194 Selct Manage Applications 195 Select Quake 196 Press "Uninstall" 197 198Make sure your device is not mounted as an USB Storage Device: 199 Press Home button on Phone 200 Press Menu 201 Select "SD card & phone storage 202 Make sure "Use for USB storage" is unchecked 203 204Then run this script to delete the Quake files on the sdcard: 205 206 cd $TOP/apps/Quake 207 ./cleanupdevicesdcard.sh 208