skWare's X-Files Trivia Game (skXft) is a trivia game based on the X-Files TV Series. Users can play this trivia game either by using the traditional ansi interface or by using a browser and html interface.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.
To upgrade from v1.00a, v1.00b or v1.00c to v1.00d you should first install the program as described below.
Once you have done this you will need to customise the new html headers and footers if your version is registered. The following table lists the old filenames and the new filenames.
Old File New File http\skxfilestrivia.htm This file is no longer used http\skxfilestrivia_instructions_html_footer.htm This file has been replaced by http\skware\template\xft\help.htm http\skxfilestrivia_instructions_html_header.htm This file has been replaced by http\skware\template\xft\help.htm http\skxfilestrivia_playgame_html_footer.htm This file has been replaced by http\skware\template\xft\main_f.htm http\skxfilestrivia_playgame_html_header.htm This file has been replaced by http\skware\template\xft\main_h.htm http\skxfilestrivia_topten_html_footer.htm This file has been replaced by http\skware\template\xft\topten_f.htm http\skxfilestrivia_topten_html_header.htm This file has been replaced by http\skware\template\xft\topten_h.htm You should then should edit the configuration file skware.cfg as explained in the section on the configuration. As the registration code system has changed you will need to use the new registration code as supplied by skWare.
You can then delete the directory as specified in line 3 of the old configuration file. In our case this was d:\wc5\skxfilestrivia.
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)
- skxfilestrivia.log
- skxfilestrivia.wcx
- skxfilestrivia_exp.bat
- skxfilestrivia_exp.bat
- html-skxfilestrivia.wcx
- data\skxfilestrivia.cfg
- data\skxfilestrivia.ctl
- http\skxfilestrivia.htm
- http\skxfilestrivia_instructions_html_footer.htm
- http\skxfilestrivia_instructions_html_headerer.htm
- http\skxfilestrivia_playgame_html_footer.htm
- http\skxfilestrivia_playgame_html_header.htm
- http\skxfilestrivia_topten_html_footer.htm
- http\skxfilestrivia_topten_html_header.htm
To install skXft you should follow these steps.
- Unzip the package skxf100d.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).
- skxft.wcx
- html-skxft.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\images d:\wc5\http\skware\images http\skware\ol_docs\xft d:\wc5\http\skware\ol_docs\xft http\skware\template\xft d:\wc5\http\skware\template\xft language d:\wc5\language - Next you should edit the configuration file skware.cfg as explained in the section on the configuration file.
- Add the program skXft to one or of your ansi menus as required. Please don't forget about allowing access to the security levels required.
- Add one or more links to the game on the html pages that you want. An example of the link required is as follows:-
<a href="/code/html-skxft.wcx?Mode=New+Game"<b>Skware's HTML X-Files Trivia Game</b></a>
The operation of the game 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.
It is an 'ini' type file the contents for the [skxft] section are described in the following table.
Parameter Description [skxft] This is the section header and is used to seperate parameters from other programs. 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. QuestionsPerDay This is the number of questions a player is allowed per day. If this is set to 0 then the questions allowed per day is unlimited. RightPoints This is the number of points a user will get if they answer the question correctly. WrongPoints This is the number of points a user will loose if they answer the question incorrectly. 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 program.
To customise the headers displayed by the game you should modify the supplied templates (in http\skware\template\xft) 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 main_h.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. topten_h.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.
To customise the footers displayed by the game you should modify the supplied templates (in http\skware\template\xft) 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 main_f.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. topten_f.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.
You can totaly customise the help screen shown to users when they select [I]nstructions from the main menu. To do this all you need to do is modify the skxft_help.prm found in the default language directory (ie. d:\wc5\language).
There are several other html templates that can be customised. Again you should modify the supplied templates (in http\skware\template\xft) to suit your needs. These modifications will work in the registered and unregistered version of the game. The templates supplied are discussed in the following table:-
Template File Used By help.htm This template is used when the user clicks on the help button. If the program can not find this file it will produce an error. nogames.htm This template is used when the user trys to enter the game and no longer has any more games left for the day. If the program can not find this file it will produce an error. nopoints.htm This template is used when the user trys to enter the game and no longer has any more points left for the day. If the program can not find this file it will produce an error.
In the registered version of skXft you are able to add your own questions. To do this you should edit the file skxft.txt that is in your wildcat data directory. The format of the file is as follows:-
When the program is next started it will detect that there have been changes made to this file and import them into the database that the program uses. It will also randomise the correct answer as it is importing the questions.
- The question to ask. This can be a maximum of 139 characters long.
- The correct answer. This can be a maximum of 70 characters long.
- Alternate answer 1. This can be a maximum of 70 characters long.
- Alternate answer 2. This can be a maximum of 70 characters long.
- Alternate answer 3. This can be a maximum of 70 characters long.
- A blank line
To Register skXft print the file register.txt fill it in, and send it and the required amount to the following address:-
skWareIf 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.
PO Box 9559
Wellington
NEW ZEALAND
You can also register online at skWare Online - Online Registration.