annotate README.txt @ 641:35243e090a30

Update README.
author Simon Cross <hodgestar@gmail.com>
date Sun, 08 Sep 2013 01:45:35 +0200
parents 67387621c61b
children 2b9f3bd74635
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
1 Werewolf Sonata
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
2 ===============
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
3
193
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
4 Entry in PyWeek #17 <http://www.pyweek.org/17/>
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
5
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
6 URL:
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
7 http://pyweek.org/e/nagslang
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
8 Team:
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
9 Cape Viper
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
10 Members:
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
11 Simon Cross
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
12 David Fraser
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
13 Neil Muller
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
14 Adrianna Pinska
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
15 Stefano Rivera
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
16 David Sharpe
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
17 Jeremy Thurgood
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
18 License:
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
19 see LICENSE.txt
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
20
193
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
21 Requirements
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
22 ============
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
23
287
67387621c61b Added requirements.txt and use it from setup.py
David Fraser <davidf@sjsoft.com>
parents: 193
diff changeset
24 The game requires pygame and pymunk. Requirements can be installed by
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
25
287
67387621c61b Added requirements.txt and use it from setup.py
David Fraser <davidf@sjsoft.com>
parents: 193
diff changeset
26 pip install -e .
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
27
287
67387621c61b Added requirements.txt and use it from setup.py
David Fraser <davidf@sjsoft.com>
parents: 193
diff changeset
28 Or
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
29
287
67387621c61b Added requirements.txt and use it from setup.py
David Fraser <davidf@sjsoft.com>
parents: 193
diff changeset
30 pip install -r requirements.txt
193
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
31
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
32 It was developed using python 2.7, pymunk 4.0 and pygame 1.9.2. Older
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
33 versions may or may not work.
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
34
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
35 The editor also requires Albow 2.2.0 from
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
36 http://www.cosc.canterbury.ac.nz/greg.ewing/python/Albow/
193
d862cc209de4 Add some notes on requirements to the readme
Neil Muller <drnlmuller@gmail.com>
parents: 0
diff changeset
37
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
38
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
39 Running the Game
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
40 ----------------
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
41
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
42 On Windows or Mac OS X, locate the "run_game.pyw" file and double-click it.
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
43
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
44 Othewise open a terminal / console and "cd" to the game directory and run:
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
45
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
46 python run_game.py
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
47
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
48
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
49 How to Play the Game
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
50 --------------------
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
51
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
52 Move Lyca, the werewolf insurance assessor, around the screen with the arrow
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
53 keys or A, S, W, D.
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
54
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
55 Fire a gun or claw aliens with X or CTRL.
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
56
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
57 Change between werewolf and human by pressing C.
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
58
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
59 Interact with doors and other objects using SPACE.
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
60
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
61 There are no ducks.
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
62
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
63
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
64 Development notes
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
65 -----------------
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
66
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
67 Creating a source distribution with::
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
68
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
69 ./scripts/build_unix.sh
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
70
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
71 You may also generate Windows executables and OS X applications::
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
72
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
73 python setup.py py2exe
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
74 python setup.py py2app
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
75
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
76 Later you might be able to upload files to PyWeek with::
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
77
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
78 python pyweek_upload.py
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
79
641
35243e090a30 Update README.
Simon Cross <hodgestar@gmail.com>
parents: 287
diff changeset
80 Later you might be able to upload to the Python Package Index with::
0
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
81
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
82 python setup.py register
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
83 python setup.py sdist upload
1ea8fa09b70f Add skellington
Neil Muller <drnlmuller@gmail.com>
parents:
diff changeset
84