Quake In order to run Quake on the simulator and/or device, you must: 1) Configure the Sources 2) Build 3) Install 4) Run 5) Uninstall Quake (this step is optional) Configure the Sources --------------------- Edit src/com/android/quake/QuakeActivity.java to configure where and how Quake will obtain its data files. The configuration variables are: private final static boolean USE_INTERNAL_FLASH = false; private final static boolean USE_DOWNLOADER = false; This means that by default Quake will look for its files on the SD Card, and it will not attempt to download the files from an external web server. (Use the ./setupdevicesdcard.sh script, described below, to copy the data files from the Android source tree onto the device's SD Card.) Note that if USE_DOWNLOADER is set to true then you need to configure a web server to serve the Quake data files, and the FILE_CONFIG_URL variable needs to be set to point to the configuration file on the web server. Read the source for DownloaderActivity.java to figure out how to do this. Building Quake -------------- Quake and libQuake are built by default, as part of the standard Android build. If for some reason you would like to build Quake manually, you can do so by using the mm command: $ cd $TOP/apps/Quake $ mm Installing Quake ---------------- Quake is not installed by default. To install Quake you need to copy the Quake executable files and data files to the device. Quake needs about 20 MB of space to store its data files. Quake files go on an external micro SD card (This is /sdcard/data/quake directory). Using the device with a microsd card: Turn on phone, plug into your development PC/Mac using the supplied ADB cable. cd $TOP/apps/Quake adb remount adb install $OUT/system/app/Quake.apk Make sure your device is not mounted as an USB Storage Device: Press Home button on Phone Press Menu Select "SD card & phone storage Make sure "Use for USB storage" is unchecked. Then install the Quake data files by executing this script: ./setupdevice.sh (Or if you've set QuakeActivity.USE_INTERNAL_FLASH to false, then use this script instead:) ./setupdevicesdcard.sh Using the emulator: You can use Quake with the emulator, but you have to create and mount an sdcard image. (Doing that is beyond the scope of this document.) Once you've started the emulator with a sdcard image you can follow the directions for a real device. Running Quake ------------- Turn on the device Look for Quake in the Activities folder. Launch it as you would any other activity. It will take up to thirty seconds to start running. When Quake starts running it will display a console with some debug information, then go into an "attract mode" loop. Starting a game: Press space bar to bring up the main menu. The "Quake icon" should be next to the "Single Player" menu item. Press the "Enter" button twice to start the game. Controls: The Quake controls are customizable, depending upon the settings of config.cfg, but the defaults are: Android PC Key Command Notes Keypad ---------- --------- --------------- ---------------------------------- Alt Space TAB +showscores Shows scores in multiplayer games DPad Enter ENTER +jump Menu ESCAPE togglemenu Shows/hides menu space SPACE +jump + + sizeup Increases size of screen , , +moveleft Strafe left - - sizedown . . +moveright Strafe right / / impulse 10 Toggle weapons up 0 0 impulse 0 1 1 impulse 1 Select weapon 1 (axe) 2 2 impulse 2 Select weapon 2 (shotgun) 3 3 impulse 3 Double-barrled shotgun 4 4 impulse 4 Nailgun 5 5 impulse 5 Super nailgun 6 6 impulse 6 Grenade launcher 7 7 impulse 7 Rocket Launcher 8 8 impulse 8 Thunderbolt = = sizeup \ \ +mlook Mouse look. (Not very useful, as there is no mouse.) Alt w ` toggleconsole Used to enter fancy commands. w w +forward s s +back a a +left d d +right q q +lookup z z +lookdown v v +movedown f f +moveup t t messagemode DPad Up UPARROW +forward DPad Down DOWNARROW +back DPad Left LEFTARROW +left DPad Right RIGHTARROW+right Alt ALT +strafe @ or / CTRL +attack Cap SHIFT +speed Alt 1 F1 help (This is just an advertisement in the shareware version.) Alt 2 F2 menu_save Alt 3 F3 menu_load Alt 4 F4 menu_options Alt 5 F5 menu_multiplayer Alt 6 F6 echo Quicksaving...; wait; save quick Alt 9 F9 echo Quickloading...; wait; load quick Alt 0 F10 quit Alt t F11 zoom_in Alt y F12 screenshot INS +klook DEL +lookdown PGDN +lookup END centerview MOUSE1 +attack MOUSE2 +forward MOUSE3 +mlook Alt z PAUSE pause Camera HOME ...not bound by default... ----- Console Commands: timedemo demo# run time demo # (1..3) god turns on god mode fly enables fly mode kill commits suicide notarget enemies don't attack until provoked noclip walk through walls give s # gives # (where # = a number) of shotgun shells give n # gives # of nails give r # gives # of rockets/grenades give c # gives # of cells give h # gives # of health give # gives weapon # map e#m# warps to the episode and mission specified impulse -1 quad cheat impulse 9 all weapons and keys impulse 255 quad cheat Uninstalling Quake ------------------ Quake has to be uninstalled in two parts: a) the Quake.apk file b) the data files on the sdcard Use the Phone UI to uninstall the Quake apk: Press Home Key Press Menu Key Select Settings Select Applications Selct Manage Applications Select Quake Press "Uninstall" Make sure your device is not mounted as an USB Storage Device: Press Home button on Phone Press Menu Select "SD card & phone storage Make sure "Use for USB storage" is unchecked Then run this script to delete the Quake files on the sdcard: cd $TOP/apps/Quake ./cleanupdevicesdcard.sh