/Jungle-Journey

Jungle exploration/escape game.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Jungle Journey

The last flames of the campfire fade to glowing embers and I am alone.
My recent acquaintances, their packs and paraphernalia have gone, leaving
me stranded deep in the heart of this jungle realm. Clouds momentarily
sweep the cold face of the moon and I perceive the clicks, whistles and
cries of creatures in the hot air that cloaks this place. Desperately, I
try to stay my panic and remember those fragments of wilderness craft
learned and unlearned many years ago.

    Choose your weapon carefully,
    Get ready for a fight.
    The jungle can be dangerous
    If you go there at night.
    There's time to pick up treasure,
    But no time to stop and stare.
    If you don't find the hidden cave
    You won't get out of there.

Hopeless, I scramble to my feet, reaching for any weapon still left to me.
Struggling through the dense undergrowth, I search for signs of a track or
trail. At first glance, paths that seemed to lead to safety turn out to be
impassable, overgrown by tangled and twisted vines. I remember the words of
an old teacher:

 "Do not be tempted to use fire to make your way.
  Many a traveller has strayed from the path, using fire to blaze a trail,
  only to reach a dead end. Trying to return, they find that the jungle
  has grown back. Those who are desperate enough will even seek out
  forgotten routes when the way home is in sight."

Sensing my presence, obscene creatures emerge from the darkness, hungry
for prey. Only through skill and luck am I able to dispatch them back
into the shadows. Even though I know I must journey deeper into this
uncharted land to find the way home, the thought of vengeance drives me on.


Installation

The sources for this game can be obtained from the Mercurial repository hosted
on the Retro Software Web site:

  http://www.retrosoftware.co.uk/hg/junglejourney

You can download an archive of the current sources by clicking on one of the
"bz2", "zip" or "gz" links on the main repository page.

Alternatively, you can use Mercurial to clone this repository from the command
line, obtaining the full development history of the game:

  hg clone http://www.retrosoftware.co.uk/hg/junglejourney

You need Python, the Python Imaging Library and the Ophis 6502 assembler to
build the game.

Run the build.py script at the command line, passing the name of the UEF file
to create. If the file was created, load it into an Electron emulator or create
a sound file with one of the UEF utilities available online.


Loading the Game

Insert the cassette or disk and type

  *RUN JUNGLE

then press Return. If you are loading the game from cassette, press play on the
cassette recorder. The game should now load.


Playing the Game

The player must help the character reach the exit for each level. However, the
player must first find a key to unlock the exit. On the final level, the exit
does not require a key but it may be obstructed. Enemies will appear in each
location and attack the player's character. They can be destroyed by
projectiles fired by the current weapon.

Your character can be moved around the screen by using four control keys:

  Z     left
  X     right
  :     up
  /     down

To fire a weapon, press the Return key. There are four different types of
weapon available in the game.

Alternatively, you may may using an analogue joystick. Select joystick controls
by pressing the Fire button on the title page to start the game. Press Space to
start the game with keyboard controls.

Other keys can be used to control the game:

  S         enable sound effects
  Q         disable sound effects
  P         pause the game
  O         resume the game
  Escape    quit the game, returning to the title screen


License

Copyright (C) 2011 David Boddie <david@boddie.org.uk>
An Infukor production for Retro Software (http://www.retrosoftware.co.uk/)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.