skWare's HTML Roll The Dice Game Online Documentation

Release 1.00a


Introduction

skWare's HTML Roll The Dice Game (skRollTheDice) is a HTML Roll The Dice Game written in wcCode.

Usage of this software is covered by skWare's Software License which you should read at some stage and you should also check out skWare's Software Warranty. You may also want to check out the Trademarks page at some stage.

You should definately read the Software History page.

In this documentation we have assumed that Wildcat! has been installed on drive d: in the directory wc5 resulting in the fact that the default wildcat directory is d:\wc5, as this is how our development system is set up. Your system may not be set up like this.

Installation

To install skRollTheDice you should follow these steps.

Configuration File

The operation of the games is controlled by the configuration file. This configuration file is called skrollthedice.cfg and must be in your WildCat data directory (d:\wc5\data). It is an 'ini' type file the contents of which are described in the following table.
ParameterDescription
RegCode Once registered this parameter should contain your registration code as supplied by skWare. In the shareware version this should contain the word "SHAREWARE" without the quoutes.
StartPoints This is the number of points given to a new player. It is also the number of points given to a player when they start a new day with no points.
GamesPerDay This is the number of games a player is allowed per day. If this is set to 0 then the games allowed per day is unlimited.
HomePageLink This is the link to your home page. It is used by the Home button so that the user can return quickly to you home page.
BackPageLink This is the link used by the back button so the user can return quickly to the page that called the query program.

Header Customisation

To customise the headers displayed by the game you should modify the supplied templates (in http\skware_templates) to suit your needs. Header customisation only works in the registered version of the game. The templates supplied are discussed in the following table:-
Template FileUsed By
skrollthedice_html_header.htm This template is used as the header to the main game page. If the program does not find this file it will use the internal default.
skrollthedice_html_lost_header.htm This template is used as the header on the page displayed when the user looses a game. If the program does not find this file it will use the internal default.
skrollthedice_html_topten_header.htm This template is used as the header on the page displayed when the user selects the top ten. If the program does not find this file it will use the internal default.
skrollthedice_html_over_header.htm This template is used as the header on the page displayed when the user completes a game. If the program does not find this file it will use the internal default.
skrollthedice_html_over10_header.htm This template is used as the header on the page displayed when the user completes a game and makes it to the top ten. If the program does not find this file it will use the internal default.
skrollthedice_html_nomoregames_header.htm This template is used as the header on the page displayed when the user has no more games left for the day. If the program does not find this file it will use the internal default.
skrollthedice_html_nomorepints_header.htm This template is used as the header on the page displayed when the user has no more points left for the day. If the program does not find this file it will use the internal default.

Footer Customisation

To customise the footers displayed by the game you should modify the supplied templates (in http\skware_templates) to suit your needs. Footer customisation only works in the registered version of the game. The templates supplied are discussed in the following table:-
Template FileUsed By
skrollthedice_html_footer.htm This template is used as the footer to the main game page. If the program does not find this file it will use the internal default.
skrollthedice_html_lost_footer.htm This template is used as the footer on the page displayed when the user looses a game. If the program does not find this file it will use the internal default.
skrollthedice_html_topten_footer.htm This template is used as the footer on the page displayed when the user selects the top ten. If the program does not find this file it will use the internal default.
skrollthedice_html_over_footer.htm This template is used as the footer on the page displayed when the user completes a game. If the program does not find this file it will use the internal default.
skrollthedice_html_over10_footer.htm This template is used as the footer on the page displayed when the user completes a game and makes it to the top ten. If the program does not find this file it will use the internal default.
skrollthedice_html_nomoregames_footer.htm This template is used as the footer on the page displayed when the user has no more games left for the day. If the program does not find this file it will use the internal default.
skrollthedice_html_nomorepoints_footer.htm This template is used as the footer on the page displayed when the user has no more points left for the day. If the program does not find this file it will use the internal default.

Help File Customisation

You can totaly customise the help page shown to users when they select the help button in the game. To do this all you need to do is modify the html file skrollthedice_html.help.htm found in the skware_templates directory. You should ensure that the form part at the bottom of the file is left intact so that users can still navigate around the game.

Changing the Graphics

If you want you can change the graphics used by the program by either modifying the supplied gif's or creating your own and replacing the supplied gif's. All of the gifs for the dice are in the directory http\skware_images\dice.

Registration

To Register skRollTheDice print the file register.txt fill it in, and send it and US$10 to the following address:-
skWare
PO Box 9559
Wellington
NEW ZEALAND

Copyright © 1997 skWare, All Rights Reserved