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.
To install skRollTheDice you should follow these steps.
- Unzip the package skrd100a.zip into a temporary directory with a 32 bit unzip program such as unzip as shipped with WildCat.
- Move the following files to your default WildCat directory (eg: d:\wc5).
- html-skrollthedice.wcx
- The rest of the files supplied in the package are in relative directories and should be moved as follows:-
Source Directory Example Destination Directory data d:\wc5\data http\skware_rd d:\wc5\http\skware_rd http\skware_images d:\wc5\http\skware_images http\skware_images\dice d:\wc5\http\skware_images\dice http\skware_templates d:\wc5\http\skware_templates - Next you should edit the configuration file skrollthedice.cfg as explained in the section on the configuration file.
- Add one or more links to the game on the pages that you want. An example of the link required is as follows:-
<a href="/code/html-skrollthedice.wcx?Mode=Deal"<b>Skware's HTML Roll The Dice Game</b></a>
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.
Parameter Description 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.
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 File Used 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.
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 File Used 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.
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.
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.
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