Portable Space Engine, Installation Notes
Alpha version 0.9.x
-------------------------------------------------------------------------------

The Portable Space Engine is maintained by Cameron Smith and Mark Cooke
(spaceengine@geocities.com and vspace@geocities.com). It may be used freely
as indicated in the GNU General Public License (see the file 'COPYING').


INSTALLATION
============

- Untar the space distribution.
- Create a symbolic link from the newly created distribution directory
  to your server source directory.

    % cd server-dir/src
    % ln ../../space-0.9.x/src space

  An alternative (definately not recommended method):

    % cd server-dir/src
    % mv ../../space-0.9.x/src space

- Copy the appropriate patch file from the PSE patches/ directory over to
  your MU* server top level directory.
- cd to your server top level directory
- Type:  

      TinyMUX

    % patch -p1 < patch-tinymux*
    % cd src
    % ./configure

      TinyMUSH

    % patch -p1 < patch-tinymush*
    % ./configure

      PennMUSH

    % patch -p1 < patch-tinymush*
    % ./Configure

- Make your usual changes to the server Makefile and the configuration
  files you use for your site.
- Change directory to the one from where you compile your MU* server.  (On
  MUX type: cd mux-dir/src, and on MUSH type: cd mush-dir/)
- Type:

    % make

- This should rebuild both the server and the Portable Space Engine.
- Congratulations!  The engine is now installed! 


DUMMIES GUIDE
=============

      TinyMUX

    % mkdir tiny
    % cd tiny
    % tar xvfz ../tinymux-1.5p7.tar.gz
    % cd ..
    % tar xvfz space-0.9.x.tar.gz
    % cd tiny/src
    % ln -s ../../space-0.9.x/src space
    % cd ..
    % patch -p1 < ../space-0.9.x/patches/patch-tinymux-1.5p7
    % cd src
    % ./configure
    % make clean
    % make

      TinyMUSH

    % tar xvfz tinymush-2.2.3.tar.gz
    % tar xvfz space-0.9.x.tar.gz
    % cd tinymush-2.2.3/src
    % ln -s ../../space-0.9.x/src space
    % cd ..
    % patch -p1 < ../space-0.9.x/patches/patch-tinymux-1.5p7
    % ./configure
    % make clean
    % make

      PennMUSH

    % tar xvfz pennmush-1.7.2pl13.tar.gz
    % tar xvfz space-0.9.x.tar.gz
    % cd pennmush/src
    % ln -s ../../space-0.9.x/src space
    % cd ..
    % patch -p1 < ../space-0.9.x/patches/patch-pennmush-1.7.2pl13
    % ./Configure -d
    % make update
    % make clean
    % make


REQUIRED SOFTCODING
===================

Quite a bit of softcode is required to make the space engine work.  An example
of a working space system (in the form of a MUX database) can be found at the 
Example Code site at www.geocities.com/TimesSquare/Realm/3221/.  Please drop 
by, give the system a try, and steal whatever code you think you might need!  
All of the important objects should be there.

NOTE:  The sample database may lag behind the development of the 0.9.x series
somewhat.  If you find bugs in the sample objects and manage to fix them, 
please send the changes to spaceengine@geocities.com.


ADDITIONAL NOTES FOR TINYMUSH USERS
===================================

Please note that soft code developed for PSE running on TinyMUX may not work
with TinyMUSH.  To help you get started in porting any sample code that
we release, here are a few hints:

- Objects with $-commands will need to have the COMMAND flag set.
- You will have to substitute 'think' with a similar command that MUSH 
  supports.  @pemit me= might work just as well.  


FINALLY
=======

If you do come up with a set of sample objects that works well with the
PSE, and would be willing to share, please e-mail Cameron at
spaceengine@geocities.com, or the discussions list at
pse-discuss@pc24.sr.bham.ac.uk
