junglejourney

view README.txt @ 204:0e1ae5213c3b

Added information about the sources and the hosted repository at retrosoftware.co.uk.
author David Boddie <david@boddie.org.uk>
date Sun Oct 09 00:09:28 2011 +0200
parents c0400eb6eabd
children dae2a8efc58f
line source
1 Jungle Journey
3 The last flames of the campfire fade to glowing embers and I am alone.
4 My recent acquaintances, their packs and paraphernalia have gone, leaving
5 me stranded deep in the heart of this jungle realm. Clouds momentarily
6 sweep the cold face of the moon and I perceive the clicks, whistles and
7 cries of creatures in the hot air that cloaks this place. Desperately, I
8 try to stay my panic and remember those fragments of wilderness craft
9 learned and unlearned many years ago.
11 Choose your weapon carefully,
12 Get ready for a fight.
13 The jungle can be dangerous
14 If you go there at night.
15 There's time to pick up treasure,
16 But no time to stop and stare.
17 If you don't find the hidden cave
18 You won't get out of there.
20 Hopeless, I scramble to my feet, reaching for any weapon still left to me.
21 Struggling through the dense undergrowth, I search for signs of a track or
22 trail. At first glance, paths that seemed to lead to safety turn out to be
23 impassable, overgrown by tangled and twisted vines. I remember the words of
24 an old teacher:
26 "Do not be tempted to use fire to make your way.
27 Many a traveller has strayed from the path, using fire to blaze a trail,
28 only to reach a dead end. Trying to return, they find that the jungle
29 has grown back. Those who are desperate enough will even seek out
30 forgotten routes when the way home is in sight."
32 Sensing my presence, obscene creatures emerge from the darkness, hungry
33 for prey. Only through skill and luck am I able to dispatch them back
34 into the shadows. Even though I know I must journey deeper into this
35 uncharted land to find the way home, the thought of vengeance drives me on.
38 Installation
40 The sources for this game can be obtained from the Mercurial repository hosted
41 on the Retro Software Web site:
43 http://www.retrosoftware.co.uk/hg/junglejourney
45 You can download an archive of the current sources by clicking on one of the
46 "bz2", "zip" or "gz" links on the main repository page.
48 Alternatively, you can use Mercurial to clone this repository from the command
49 line, obtaining the full development history of the game:
51 hg clone http://www.retrosoftware.co.uk/hg/junglejourney
53 You need Python, the Python Imaging Library and the Ophis 6502 assembler to
54 build the game.
56 Run the build.py script at the command line, passing the name of the UEF file
57 to create. If the file was created, load it into an Electron emulator or create
58 a sound file with one of the UEF utilities available online.
61 Loading the Game
63 Insert the cassette or disk and type
65 *RUN JUNGLE
67 then press Return. If you are loading the game from cassette, press play on the
68 cassette recorder. The game should now load.
71 Playing the Game
73 The player must help the character reach the exit for each level. However, the
74 player must first find a key to unlock the exit. On the final level, the exit
75 does not require a key but it may be obstructed. Enemies will appear in each
76 location and attack the player's character. They can be destroyed by
77 projectiles fired by the current weapon.
79 Your character can be moved around the screen by using four control keys:
81 Z left
82 X right
83 : up
84 / down
86 To fire a weapon, press the Return key. There are four different types of
87 weapon available in the game.
89 Alternatively, you may may using an analogue. Select joystick controls by
90 pressing the Fire button on the title page to start the game. Press Space to
91 start the game with keyboard controls.
93 Other keys can be used to control the game:
95 S enable sound effects
96 Q disable sound effects
97 P pause the game
98 O resume the game
99 Escape quit the game, returning to the title screen
102 License
104 Copyright (C) 2011 David Boddie <david@boddie.org.uk>
105 An Infukor production for Retro Software (http://www.retrosoftware.co.uk/)
107 This program is free software: you can redistribute it and/or modify
108 it under the terms of the GNU General Public License as published by
109 the Free Software Foundation, either version 3 of the License, or
110 (at your option) any later version.
112 This program is distributed in the hope that it will be useful,
113 but WITHOUT ANY WARRANTY; without even the implied warranty of
114 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
115 GNU General Public License for more details.
117 You should have received a copy of the GNU General Public License
118 along with this program. If not, see <http://www.gnu.org/licenses/>.