NameDateSize

..17-Jul-20124 KiB

Android.mk17-Jul-20121.9 KiB

AndroidManifest.xml17-Jul-20121.8 KiB

CleanSpec.mk17-Jul-20122.2 KiB

cleanupdevicesdcard.sh17-Jul-20121.2 KiB

MODULE_LICENSE_GPL17-Jul-20120

NOTICE17-Jul-201235.8 KiB

quake/17-Jul-20124 KiB

README17-Jul-20126.6 KiB

res/17-Jul-20124 KiB

setupdevice.sh17-Jul-2012601

setupdevicesdcard.sh17-Jul-2012740

src/17-Jul-20124 KiB

tools/17-Jul-20124 KiB

README

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