skWare's HTML Roll The Dice Game Online Documentation

Release 1.00e


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.

You can also check out skWare Online for the latest information on this program and also the others written by skWare.

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.

Upgrading to v1.00e

To upgrade from v1.00d to v1.00e you should proceed as follows:-

Upgrading to v1.00d

To upgrade from v1.00a, v1.00b, v1.00c to v1.00d you should proceed as follows:-

Install the program as descibed in the installation section below.

The configuration file has been changed so that the program uses the standard skWare configuration file skware.cfg. You will need to transfer the information from the old configuration file data\skrollthedice.cfg manually with a text editor. This is explained in more detail in the section on the configuration file.

All the files in the directory http\skware_images\dice can be deleted along with the directory itself.

As the program has been renamed from html-skrollthedice to html-skrtdice don't forget to change the links on your html pages that contain a link to html-skrollthedice.

Finally you can delete the following files as they are no longer used. They have all been specified releative to your default wildcat directory. (d:\wc5)

Upgrading to v1.00c

To upgrade from v1.00a,v1.00b to v1.00c you should proceed as follows:-

Installation

To install skRollTheDice you should follow these steps.

Configuration File

The operation of the program is controlled by the configuration file. This configuration file is called skware.cfg and must be in your WildCat data directory (d:\wc5\data). This file is in the process of being setup so that it is shared by all of skWare's programs as the single source of configuration information. An example file has been shipped with the package called skware.cfg.dist which can be used as an example.
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.

HTML Template Customisation

All of the templates used by the game are totally customisable. The templates supplied are in the http\skware\template\rtdice directory and are used as per the following table.
Template FileUsed By
help.htm This template is the help paged displayed to the user when they use the help button.
main.htm This template is the main template used by the game.
nogames.htm This template is used when the user has no more games left for the day.
nopoints.htm This template is used when the user has no more points left for the day.
over.htm This template is used when a game is over and the user did not make it to the top ten.
over10.htm This template is used when a game is over and the user has made it to the top ten.
topten.htm This template is used when displaying the top ten.

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 the required amount to the following address:-
skWare
PO Box 9559
Wellington
NEW ZEALAND
If you want to pay by Credit Card (either Mastercard or Visa) to can either print the file ccreg.txt fill it in and send to the address above or fill in the form and email it to
skWare.

You can also register online at skWare Online - Online Registration.

Copyright © 1997-1998 skWare, All Rights Reserved