MMShipMarauder - HELP

 

INTRODUCTION

Wreak havoc among other ships with your attack sub. In the MandoMartis ShipMarauder game you have two weapons (torpedos and a gun) against the shells of the enemy ships. Point your weapon using the cross hairs and sink three types of ships which give different scores and have different speeds and firepower. The game has the following features:

  • Supports the Mandomartis CGI Highscore System so that players can compete against each other and which gives you the opportunity to set up competitions on your site. The highscore system uses encrypted data which prevents cheating.
  • Each level may increase the number of enemy ships, enemy accuracy, enemy speed and enemy shelling rate.
  • The language in the game is fully configurable.
  • Supports banners of the size 150x100 pixels for the bottom-right corner of the game with corresponding URLs.
  • Compatible and tested with Netscape 3.0 (or later) and Internet Explorer 3.0 (or later) for Windows 95/NT4/98 and Internet Explorer 4.0 and higher for Macintosh.

 

DEPENDENT FILES

The following files must be included with the applet in order for the it to work:

bigexpl0.gif, bigexpl1.gif, bigexpl2.gif, bigexpl3.gif, bigexpl4.gif, bigexpl5.gif
bigship0.gif, bigship1.gif, bigship2.gif, bigship3.gif, bigship4.gif, 
mediumship0.gif, mediumship1.gif, mediumship2.gif, mediumship3.gif, mediumship4.gif, 
smallship0.gif, smallship1.gif, smallship2.gif, smallship3.gif, smallship4.gif, 
explosion0.gif, explosion1.gif, explosion2.gif, explosion3.gif, explosion4.gif,
smoke0.gif, smoke1.gif, smoke2.gif, smoke3.gif, 
splash0.gif, splash1.gif, splash2.gif, splash3.gif, splash4.gif, splash5.gif,
mainpanel.gif, torpedo.jpg, shell.jpg, panel.jpg, 
bomb.au, explosion.au, hit.au, shipgun.au, splash.au, subshot.au, torpedo.au

 

GENERAL PARAMETERS

The game is an applet and configurable with normal HTML applet parameters. The first thing that must be done is to configure the applet tags:

<APPLET CODE="mmshipmarauder.class" WIDTH=450 HEIGHT=350>
</APPLET>

As you can see, the size of the game is 450x350 pixels. You should not change this. The following parameter controls the general game delay and thus the frames per second (FPS). The default value is 60 and should not be changed: 

<PARAM name="delay" value="60">
<PARAM name="usehighscore" value="Yes">

The "usehighscore" should be set if your applet is online and you have the highscore system setup. The content of the following parameters are given to you by the Mandomartis support and may not be changed:

<PARAM name="host0" value="XXXXXXXXX">
<PARAM name="host1" value="XXXXXXXXX">

 

TITLES, TEXT AND LANGUAGE

Insert the following parameters between the applet tags:

<PARAM name="loadinghighscoretext" value="Please wait, loading highscore system...">
<PARAM name="loadingshipimagestext" value="Please wait, loading ship images...">
<PARAM name="loadingmoreimagestext" value="Please wait, loading more images...">

The lines above are the texts that will be displayed during the three stages of downloading as the applet is being initialized. To configure the panel use the following parameters:

<PARAM name="titletext0" value="MandoMartis">
<PARAM name="titletext1" value="ShipMarauder">
<PARAM name="livestext" value="Lives">
<PARAM name="strengthtext" value="Strength">
<PARAM name="leveltext" value="Level">
<PARAM name="scoretext" value="Score">
<PARAM name="startgametext" value="Click here to start!">

As you can see, you are able to configure most of the applet's text. You can configure the in-game messages with the following lines:

<PARAM name="gameovertext" value="Game Over...">
<PARAM name="destroyedtext" value="You were destroyed, lifes left:">
<PARAM name="newlifetext" value="New life!">

The information pages are configured with the following lines:

<PARAM name="infopage0" value="Instructions:">
<PARAM name="infopage1" value=" ">
<PARAM name="infopage2" value="1. Click on button to start.">
<PARAM name="infopage3" value="2. Select your weapon torpedo/gun">
<PARAM name="infopage4" value="3. Start shooting!">
<PARAM name="infopage5" value=" ">
<PARAM name="infopage6" value="Below you see the score for each ship:">
<PARAM name="infopage7" value=" ">
<PARAM name="abouttext" value="was developed by">
<PARAM name="highscorelisttext" value="All times high:">
<PARAM name="highscoresubmissiontext0" value="Congratulations, you has made it to the list!">
<PARAM name="highscoresubmissiontext1" value="Your name:">
<PARAM name="highscoresubmissiontext2" value="Your e-mail (will not be disclosed):">
<PARAM name="highscoresubmissiontext3" value="Which city do you come from?">
<PARAM name="highscoresubmissiontext4" value="Click here to submit">

Here you should look at the applet in order to see what each parameter does. Note that some text cannot be configured like the Mandomartis credits.

 

SETTING UP THE HIGHSCORE SYSTEM

The highscore system is delivered to you by mandomartis support. The first thing you must do is to install the highscore.cgi file to your cgi server. The server MUST support Perl. Ask your webmaster or Internet provider for the path to the perl interpreter/compiler and replace the default path (the first line in the highscore.cgi file) with your path.

Second you open the encoder.html in a browser. It will execute a specially configured applet for the game. Write the path to the cgi file on your server in the empty field and press the decode button. An example of the path you must write could look like this:

http://www.yourhost.com/cgi-bin/highscore.cgi
http://cgi.yourhost.com/highscore.cgi

You should see a garble in the coded text field. Select and copy this text with CTRL-C and use it as a value to the following parameter:

<PARAM name="cgiurl" value=",zQ9zYa*a7|GYsE,/cVbgDVBD,Z)ODcoMO9dw8;e:3TX$@W_kgi@">

Now clear the empty field in the encoder applet and write the relative path FROM THE APPLET TO THE HIGHSCORE FILE. For instance if your applet is located at:

http://www.yourhost.com/games/mmshipmarauder.html

and your CGI file is located at the cgi-bin folder

http://www.yourhost.com/cgi-bin/highscore.cgi

then you must write the following path so that the applet knows where to find the highscore file:

../cgi-bin/

Please notice that the "../" is used to move up in the directory structure. Write the path in the applet's empty field and press the decode button. Copy with CTRL-C and paste the text with CTRL-V to the value field of the following parameter: 

<PARAM name="pathtohighscorefile" value="rrJ9">
<PARAM name="filename" value="CCz9s/aQaM|@YwE,@-VbGDpB9XG)OWcwMO">

The second parameter above is the filename parameter. Here you can specify the name of the highscore file, in case you have changed the default filename in the CGI file. If you are having problems with this, then contact Mandomartis support. Do not use the encoder applet to specify the "hostX" parameters, they use another coding system and may only be coded by Mandomartis. Trying to do this would also breach the license agreement.

Finally, use the "redirect" parameter in order to change the page after the player has submitted his/her score:

<PARAM name="redirect" value="http://www.yourhost.com/games/thankyouforyoursubmission.html">

Note that this parameter may NOT be encrypted. Please note that in the case of the "redirect" and "cgiurl" parameters you MUST use the "http://" part of the hostname and the hostname itself. You cannot just specify the relative file and path.

If you are having competitions on your site and you want to see the e-mail in the highscore list, then you must use the viewlist applet. Download and put the txt file (ask mandomartis support for its name) to the same folder as the viewlist applet's HTML file. Do not open the txt file (it is encrypted so you won't be able to read it anyway). Open the viewlist.html in your Internet browser to see the list.

 

ADDING YOUR OWN BANNERS

If you have received a special pro version of this applet where you can configure the banners and use other banners than Mandomartis banners, then you must use the "adimage" and "adurl" parameters. The image name for the first banner should be specified in the parameter "adimage0" and it's URL in the parameter "adurl0". The second banner's image goes in the "adimage1" and it's URL in the "adurl1" parameter and so on. See the following example: 

<PARAM name="adimage0" value="mandomartis.jpg">
<PARAM name="adimage1" value="gamesforrent.jpg">
<PARAM name="adimage2" value="devinfocenter.jpg">
<PARAM name="adurl0" value="http://www.mandomartis.com/">
<PARAM name="adurl1" value="http://www.mandomartis.com/gamesforrent/">
<PARAM name="adurl2" value="http://www.mandomartis.com/developers/">

Please note that the images must be located at the same location as the applet class files and the URLs must use the "http://" with the hostname.