home *** CD-ROM | disk | FTP | other *** search
/ RISCWORLD 7 / RISCWORLD_VOL7.iso / Software / Issue4 / IYONIX / MANICMINER / SOURCE.ZIP / manicminer-1.6.3 / doc / readme.txt < prev   
Encoding:
Text File  |  2000-12-10  |  14.4 KB  |  385 lines
  1.          __________________________________________________________
  2.         |                                                          |
  3.         |  LL      LL              OO      OO                      |
  4.         |  LLLL  LLLL    %%%%%%    OOOO    OO            ======    |
  5.         |  LL  LL  LL  %%      %%  OO  OO  OO  888888  ==      ==  |
  6.         |  LL      LL  %%      %%  OO    OOOO    88    ==          |
  7.         |  LL      LL  %%%%%%%%%%  OO      OO    88    ==      ==  |
  8.         |              %%      %%                88      ======    |
  9.         |                                      888888              |
  10.         |                                                          |
  11.         |              ======              %%%%%%%%%%              |
  12.         |                ==    LL      LL  %%                      |
  13.         |  88      88    ==    LLLL    LL  %%%%%%%%%%  OOOOOOOO    |
  14.         |  8888  8888    ==    LL  LL  LL  %%          OO      OO  |
  15.         |  88  88  88  ======  LL    LLLL  %%%%%%%%%%  OOOOOOOO    |
  16.         |  88      88          LL      LL              OO  OO      |
  17.         |  88      88                                  OO    OOOO  |
  18.         |__________________________________________________________|
  19.                                                              v1.6.3
  20.  
  21.  
  22. ##>=-LEGAL BIT:-=<###########################################################
  23.  
  24.  This game is released as FREEWARE and we except no responsibility for any
  25.  damage caused by using this programme.
  26.  
  27.  The original game is (C) 1983 BUG-BYTE Ltd and SOFTWARE PROJECTS Ltd.
  28.               (C) 1997 Alchemist Research.
  29.  
  30.  Please copy on to anybody you know providing you do not charge for the
  31.  privilege and this file accompanies the game.
  32.  
  33.  If you intend to use this game on a magazine cover disk or compilation CD,
  34.  all I [Andy Noble] ask is for you to send me a copy of the magazine or CD.
  35.  
  36.  Read midas.txt for the MIDAS Digital Audio System license.
  37.  
  38.  
  39. ##>=-INFO:-=<################################################################
  40.  
  41.  The original PC version was written over a 6 week period, on a night, after
  42.  work. It was written in 100% C using Watcom 10.6. The graphics where drawn
  43.  with Deluxe Paint.
  44.  
  45.  Right, let's get something straight. If you are looking for Manic Miner
  46.  2000, you are looking in the wrong place. You will not get any rendered
  47.  intros, rendered Willy's (Oo! Er!) or rendered anything. I [Andy] have made
  48.  the game in it's original style. I like to think of it as a version of the
  49.  game that would have appeared in 1984 if such things as "256 colour
  50.  displays" where about. I am sick of downloading a game off the net, only to
  51.  see some rendered intro and no game. Lets get back to basics. Lets play some
  52.  good, old fashioned, playable games.
  53.  
  54.  "Why have you done a DOS version when the emulated version is perfect?"
  55.  
  56.  The answer is this. I [Andy] just wanted to. I like to mess around with
  57.  programming. I am not very good at it, but I enjoy it. It's as simple as
  58.  that.
  59.  
  60.  
  61. ##>=-THE GAME:-=<############################################################
  62.  
  63.  Miner Willy, while prospecting down Surbiton way, stumbles upon an ancient,
  64.  long forgotten mine-shaft. On further exploration, he finds evidence of a
  65.  lost civilisation far superior to our own, which used automatons to dig deep
  66.  into the Earth's core to supply the essential raw materials for their
  67.  advanced industry. After centuries of peace and prosperity, the civilisation
  68.  was torn apart by war, and lapsed into a long dark age, abandoning their
  69.  industry and machines. Nobody, however, thought to tell the mine robots to
  70.  stop working, and through countless aeons they had steadily accumulated a
  71.  huge stockpile of valuable metals and minerals, and Miner Willy realises
  72.  that he now has the opportunity to make his fortune by finding the
  73.  underground store. Can YOU take the challenge and guide Willy through the
  74.  underground caverns to the surface and riches. In order to move to the next
  75.  chamber, you must collect all the flashing keys in the room while avoiding
  76.  nasties like POISONOUS PANSIES and SPIDERS and SLIME and worst of all, MANIC
  77.  MINING ROBOTS. When you have all the keys, you can enter the portal which
  78.  will now be flashing. The game ends when you have been "got" or fallen
  79.  heavily three times.
  80.  
  81.  NOTE: This was taken from the original BUG-BYTE inlay. I have never seen any
  82.  POISONOUS PANSIES, SPIDERS or SLIME anywhere in the game.
  83.  
  84.  
  85. ##>=-INSTALLATION:-=<########################################################
  86.  
  87.  DOS, Linux:
  88.  
  89.   If you are building from source, you will edit the "Makefile" to select the
  90.   operating system, and graphics and sound libraries that you will be using.
  91.   (You can safely delete the directory !Manic and its contents.)
  92.  
  93.   If you're using DOS and you don't understand this, don't worry -- you
  94.   should be using the binary version instead.
  95.  
  96.   To install the binary version, just copy the zip or tar.gz file to a
  97.   directory (e.g. c:\games or "c:\program files" in DOS/Windows, or
  98.   /usr/local/games in Linux) and extract the archive. If you use pkunzip,
  99.   make sure that you use the -d option.
  100.  
  101.  RISC OS:
  102.  
  103.   If you are building from source, just do so :-)
  104.  
  105.   Requirements are Acorn C v5 and OSLib; gcc should be useable with
  106.   appropriate modifications to the makefile. Unzipping: unzip to some
  107.   convenient directory, then move the contents of manicminer (or
  108.   manicminer-<version>) into !Manic. Note that the filenames are arranged for
  109.   DOS and Linux; unzip 5.41 and later can deal with this with the -/ switch
  110.   (you'll need -/c:h:s).
  111.  
  112.   To install the binary version, just extract !Manic from the archive. Or
  113.   even run it from the archive, if you have SparkFS.
  114.  
  115.  
  116. ##>=-RUNNING FROM THE COMMAND LINE:-=<#######################################
  117.  
  118.  Usage: manic [ OPTIONS ]
  119.  Options:
  120.    -fs                       reconfigure sound, if applicable
  121.    -rh                       reset hiscore
  122.    -h                        display this help and exit
  123.    -v                        output version information and exit
  124.    -2                        double size display (Allegro only)
  125.    FILE                      load level data file FILE
  126.  
  127.  The RISC OS version cannot (normally) be run from the command line; it is
  128.  designed as a desktop application with a single-tasking mode.
  129.  
  130.  
  131. ##>=-INSTRUCTIONS:-=<########################################################
  132.  
  133.  For those of you who have never played Manic Miner before, all you have to
  134.  do is collect all of the flashing items from each screen to open the exit
  135.  before your air runs out. Sounds easy? Just give it a try.
  136.  
  137.  From the loading screen press any key to get to the main title.
  138.  
  139.  On the title screen:
  140.  
  141.    F1           ABOUT and game SPEED / MUSIC / LEVELS setup.
  142.    ENTER/RETURN Start Game.
  143.  
  144.    (If you leave the keyboard alone the game will go into demo mode. Just
  145.    press a key to return to the title screen.)
  146.  
  147.  In Game:
  148.  
  149.    Q E T U O [           = Left
  150.    W R Y I P ]           = Right
  151.    SHIFT to SHIFT, SPACE = Jump
  152.    A to G                = Pause
  153.    H to L                = Music toggle
  154.  
  155.    CTRL+F1-F5= Change Game Speed. F1=Fast/F5=Slow
  156.  
  157.  ESCAPE      at any time will take you back to the title screen.
  158.  F10         (DOS, Linux) will quit the program.
  159.  F12         (RISC OS) will suspend the game, returning you to the desktop.
  160.  
  161.  
  162. ##>=-ANDY'S FINAL WORDS:-=<##################################################
  163.  
  164.  I hope you enjoy the game and I hope it brings back some happy and
  165.  frustrating memories. If it is popular, even if it's not, I am planning on
  166.  doing Jet Set Willy. Well, you can't have one without the other I say.
  167.  
  168.  I would like some feedback even if it's bad. So please send mail to
  169.  andy@andyn.demon.co.uk.
  170.  
  171.  Oh, by the way, there is a CHEAT you know.
  172.  
  173.  
  174. ##>=-TALES FROM A PARALLEL UNIVERSE:-=<######################################
  175.  
  176.  In addition to the normal Manic Miner levels, this game includes Blood's
  177.  "Tales From a Parallel Universe" (the filename is set1.lev).
  178.  
  179.  (excerpts from Blood's 'Tales From a Parallel Universe' docs)
  180.  
  181.  Designed by the infamous BLOOD! (ltonks@iclretail.icl.com)
  182.  (c)1996 Cheese Freak Software
  183.  
  184.  Manic Miner programmed by Matthew Smith
  185.  (c)1983 Bug Byte Software
  186.  
  187.  Manic Miner Editor by Rich Swann (for the Sinclair Spectrum)
  188.  Printed by YS, supplied by Henning and typed by BLOOD!
  189.  
  190.  INSTRUCTIONS
  191.  
  192.  It is rumoured that there are an infinite number of parallel universes where
  193.  every possibility is played out. Things in these other dimensions may be
  194.  very similar to our own reality, but subtly different because of certain
  195.  decisions which were taken differently.
  196.  
  197.  Miner Willy is no exception to this rule. Previously, thousands of Speccy
  198.  owners had thrilled to his adventures in his battle to escape the Manic
  199.  Mining machines, but now Cheese Freak Software brings you the escapades of
  200.  ANOTHER Miner Willy from a parallel universe! Just like his counterpart in
  201.  this reality, Willy has fallen into a mine packed with dangers and must
  202.  escape from 20 lethal caverns in order to locate the untold treasures of an
  203.  ancient civilisation. However, in this universe things are subtly
  204.  different..... Can Miner Willy emulate the antics of his trans-dimensional
  205.  counterpart, or are the Speccy owners of the other universe doomed to a life
  206.  with no Jet Set Willy?
  207.  
  208.  FOR THE EASILY FOOLED
  209.  
  210.  In case you hadn't noticed, this is a version of Manic Miner which I have
  211.  edited with the Manic Miner Editor to produce a very different game! All 20
  212.  screens have been replaced (and the scrolly message!) and should prove a new
  213.  challenge for MM addicts. I can't pretend that my screens are as good as
  214.  Matt Smith's originals, but I GUARANTEE that they're much better than the
  215.  very crap 'Manic Miner 2' snapshot which has been doing the rounds on the
  216.  Internet.
  217.  
  218.  I haven't changed many graphics, for two reasons :
  219.  1) The graphics were very good anyway
  220.  2) I'm crap at drawing
  221.  You won't recognise any of the rooms anyway - it's completely different.
  222.  They're not all rock hard either - some are easy and some are like The
  223.  Warehouse.....Eeek!
  224.  
  225.  I'm not asking for anything for this - it's free, just play it and enjoy it.
  226.  And when you've done, why not grab a copy of the editor and have a go at
  227.  redesigning it yourself? The editor's free too. I'm just too nice. I'd like
  228.  to see any of your creations.....
  229.  
  230.  
  231.  Regards,
  232.  Blood.
  233.  
  234.  p.s. The screens are as follows. If you want to take a peek at 'em, use the
  235.  level skip cheat or watch the demonstration......
  236.  
  237.   1. Slightly to One Side Cavern
  238.   2. Brass Penguins?
  239.   3. Bernard Matthews' Personal Hell
  240.   4. Sealed with a Glasgow Kiss
  241.   5. Future Echoes
  242.   6. Pac Up Your Troubles
  243.   7. Altar of 7th Day Advent Hoppists
  244.   8. Alan Sugar's Take-Over Bid
  245.   9. Perils of a Bad-Hair Day
  246.  10. Dr. Jones WOOD Believe This!
  247.  11. Revenge of Brian's Phone Bill! (dedicated to Brian 'No Binaries!' Gaff)
  248.  12. Alan Sugar must DIE!
  249.  13. The 'Difficult to Edit' Cavern
  250.  14. Crashing More Often Than a ZX81!
  251.  15. Matthew Smith's Unpaid Royalties
  252.  16. Zucchini! Or Something.... (dedicated to the hard working YS team)
  253.  17. Farmer Barleymow's DDT Store
  254.  18. Eye o' Oktup (dedicated to 'dat ole looney...bwah!)
  255.  19. Warp Core Breach
  256.  20. Join the Jet Set (with apologies to Richard Hallas!)
  257.  
  258.  
  259. ##>=-CREDITS:-=<#############################################################
  260.  
  261. Original Programming, Graphics, Sound, Music:
  262.     Matthew Smith
  263. Programming, Graphics, Sound:
  264.     Andy Noble
  265. Music Arrangements:
  266.     Matt Simmonds
  267. Programming:
  268.     Stuart Brady, Darren Salt, Matan Ziv-Av
  269. Testing, Help, Ideas:
  270.     Ewan Christie, Tyrone L. Cartwright, Alex Cornhill, Andrew Cadley,
  271.     Andy Noble, Matan Ziv-Av, John Dow, Richard Hallas, André Timmermans
  272. Additional Levels:
  273.     Blood!
  274.  
  275.  
  276. ##>=-CHANGELOG:-=<###########################################################
  277.  
  278.  v1.6.3 [DS]
  279.    Reformatted the source (C comments; indented using GNU indent -br).
  280.    Integrated the RISC OS port:
  281.      Replaced the Miner Willy control and collision code.
  282.      Replaced the end-of-level effect with a "fade to blue" routine.
  283.      Added piano-playing code (works with libmikmod or RISC OS).
  284.      Re-fixed the piano image for this :-)
  285.    Moved a lot of variables into structures.
  286.    Restructured the "game completed" text.
  287.    Replaced a lot of repeated code with function calls.
  288.    Added an option for *2 display (if you're using Allegro).
  289.    Level file format tweaked a little:
  290.      +0: "MANIC\r\n\x1A"
  291.      +8: Short (16-chr) description, NUL-terminated
  292.      +24: level data, as before
  293.  
  294.  v1.6.2 [SB]
  295.    Moved level data into two files
  296.    Added command line option to specify a level data file
  297.  
  298.  v1.6.1 [SB]
  299.    Non-busy sleep code for SVGAlib [Matan Ziv-Av]
  300.    Graphics now loaded from files
  301.    Improved the Makefile
  302.    MIDAS uses mm_snd_update in Linux
  303.    LibMikMod target now works properly
  304.    Fixed the piano graphics
  305.  
  306.  v1.6.0 [SB]
  307.    SVGAlib, Allegro, LibGGI targets added, MODEX code removed
  308.    MIDAS code restructured, LibMikMod code added
  309.  
  310.  
  311.  All changes made by Andy:
  312.  
  313.  v1.51
  314.    Default screen mode is now 320x200 (not 360x240).
  315.  
  316.  v1.50
  317.    Command Line Options added.
  318.    Pixel Perfect Collision against Bad Guys added.
  319.    Solar Power Generator made slightly easier.
  320.    Errors in Jump Sound fixed.
  321.    Errors in Just onto Conveyor fixed.
  322.  
  323.  v1.0
  324.    Hopefully most of the bugs fixed.
  325.  
  326.  v0.97
  327.    New music system.
  328.    Digital effects.
  329.    Small end of game sequence.
  330.  
  331.  v0.9
  332.    Music some bug fixes.
  333.  
  334.  v0.5
  335.    First release.
  336.    No music and loads of bugs.
  337.  
  338.  
  339. ##>=-EMAIL:-=<###############################################################
  340.  
  341.  Andy Noble ................... andy@andyn.demon.co.uk
  342.  Stuart Brady ............ stuart@wholehog.fsnet.co.uk
  343.  Darren Salt .......... ds@youmustbejoking.demon.co.uk
  344.  
  345.  
  346. ##>=-WEB SITES AND NEWSGROUPS:-=<############################################
  347.  
  348.  Andy's Homepage:
  349.     http://www.andyn.demon.co.uk/
  350.        Manic Miner and Jet Set Willy PC
  351.  
  352.  Darren Salt's Homepage:
  353.     http://www.youmustbejoking.demon.co.uk/
  354.        RISC OS version
  355.  
  356.  Stuart Brady's Homepage:
  357.     http://www.wholehog.fsnet.co.uk/
  358.        Cross-platform version
  359.  
  360.  Andrew Broad's Homepage:
  361.     http://www.cs.man.ac.uk/~abroad/
  362.        Additional levels and level editor, for the Spectrum version
  363.  
  364.  Blood's Crap Speccy Page:
  365.     http://www.geocities.com/SiliconValley/Lakes/6142/
  366.        Tales from a Parallel Universe
  367.  
  368.  Stephen Smith's Spectrum Pages:
  369.     http://www.jonlan.demon.co.uk/spectrum/
  370.        Spectrum Games FAQ, and the "Where is Matthew Smith?" page
  371.  
  372.  Retrospec:
  373.     http://www.retrospec.co.uk/
  374.        But you knew that already
  375.  
  376.  JSW Ultimate Fan Page:
  377.     http://fly.cc.fer.hr/~arsen/jsw/
  378.        JSW tech info
  379.  
  380.  Newsgroups:
  381.     comp.sys.sinclair, alt.binaries.comp.sinclair
  382.  
  383.  comp.sys.sinclair FAQ:
  384.     http://www.srcf.ucam.org/~pak21/cssfaq/
  385.