Sunrise Door and Home Software





WHEEL OF FORTUNE WINServer Documentation



Version 2.5
Author/Contact Al Lawrence/Sunrise Door Software
Overview Wheel of Fortune is an adaptation of the very popular TV game show. The game is played almost exactly the same, however, you will have to use your imagination when it comes to who is turning the letters on the board. I can assure you that Vanna is not doing the turning. The game has a SAVE feature which allows the caller to quit the game and pick up where they left off, when the caller next chooses the door.
Non-Registered
 Restrictions
- No Bulletins created
- Puzzles per day limited to 2
- Puzzle Import Disabled
- Puzzle Recycle Disabled
- Event Process Disabled
- Players can NOT leave puzzles for Sysop
- Usage of the LEVELS option is Disabled
- Player limited to 7 incorrect letter choices per puzzle
- Play time cannot be restricted
Installation (1) Create a directory to hold all files
(2) Unzip the archive into the above directory
(3) MOVE the WCX file to your WC5 directory and delete it from the directory created in step (1)
(4) Create a menu entry to run the wcBASIC Door and you MUST pass the FULL drive:\path of the directory as a command line parameter when defining the Door on the menu. An example follows:

Program Name: WHEEL
Parameter:      c:\wc5\doors\WHEEL

(5) Modify the supplied CFG file. A description follows:

CONFIGURATION FILE

# = Requires registration to change to a different value.


NOTE: There are NO Blank Lines in the Config File!!
SUNRISE-80 BBS Your BBS Name
Al Lawrence Sysop's First AND Last name
00000000 Registration Number
# N Y = Allow callers to add Puzzles
N = Do not allow callers to add Puzzles.
(See 'Caller Supplied Puzzles' below)
# 20 Number of puzzles each player has to solve.
Maximum=100, Default=20
Y Y = Log all callers to USAGEx
N = Do not log callers
# N NUMBER of chances given to solve each puzzle. A wrong letter choice, landing on "LOSE TURN" or "BANKRUPT" reduces this variable by 1. When it reaches 0 the caller receives 100 pts, whether
caller has accumulated more or not, and they move on to the next puzzle. This is the default!

- OR -

LEVELS - allows caller to select a level of difficulty. There are 4 levels and each level carries a different number of chances & a sliding percentage of the wheel points caller will accumulate.
# 0 Time Allowed in Door per day. (0 = BBS Time remaining)
2 1 = DO NOT Display ADOPT-A-DOOR Message
2 = Display ADOPT-A-DOOR message
# NONE Full drive:\path\filename for Top Score Bulletin
2 The number of players that must complete all puzzles, before the puzzles are changed automatically by WOFMAINT, usually in your nightly event processing.
# 2 Number of puzzles caller can play/day
# Y Y = Allow player to send PRIVATE messages from the Door Message Center
N = Do NOT allow PRIVATE messages
# 0 Place PRIVATE messages in this BBS Conf #
# Y Y = Allow player to send PUBLIC messages addressed to ALL from Message Center
N = Do NOT allow PUBLIC messages
# 1 Place PUBLIC messages in this BBS conf. #
# Y Y = Allow Player to Check for Mail from the Door Message Center
N = Do NOT allow Check for Mail
Y Allow player to send EMAIL to Door Author
xxxx@yyyyyyy.zzz Door Author's EMAIL Address
# NONE Full Drive\path\filename for High Score Bulletin file (HTML Format)
G Door Rating. Default is G.
Maximum Characters: 5

Maintenance WOFMAINT is the Wheel of Fortune utility maintenance program. See below for a list of WOFMAINT functions. To start WOFMAINT enter the following:

WOFMAINT full\path\to\wof\directory


WOFMAINT FUNCTIONS

(1) Add WHEEL Puzzles to Database Add puzzles/categories to WHEEL puzzle database.

(2) Add BONUS Puzzles to Database Add puzzles/categories to BONUS puzzle database.

(3) Import a Puzzle File Import puzzle files you have created offline with your favorite editor or word processor. See detailed explanation below under "OFFLINE PUZZLE CREATION".

(4) Check For REGULAR and BONUS Puzzle Duplicates. You should use this option ANY time you either ADD or IMPORT
puzzles and at periodic intervals. WOFMAINT will only use the first 2000 puzzles to check the ENTIRE database against.

(5) Re-Cycle Used REGULAR and BONUS Puzzles When puzzles are changed, the old ones are placed in a file called WHEELQUE.OLD or BONUSQUE.OLD. At some point in time you may want to add them back into the current database. This option will place them at the end of the database file.

(8) EXIT:  Exit WOFMAINT
Offline Puzzle Creation This Wheel of Fortune Door program has the ability to import files you create offline, with your favorite editor or word processor. The file format is simple: PUZZLE, CATEGORY. The maximum length of each puzzle is 35 characters and the maximum length of each category is 20 characters. When this file is imported it is first checked to ensure that it conforms to the length restrictions and then the program checks to ensure that there is enough room in the database. If there is no room, you will receive a message to that effect and you will have to wait until enough puzzles are used and space is made available. If the length of any puzzle or category is invalid, the offending puzzle will be displayed along with which parts are in error. You will have to correct the problem and rerun the import option.

As a reminder, there are two (2) databases; REGULAR puzzles and BONUS puzzles. You must create separate files for each and answer the prompt with the appropriate file type.
Caller Supplied Puzzles The caller will be given the option to enter puzzles for you to use in the databases. This is optional and is controlled by an entry in the CONFIG file (see Config description above).

These entries will reside in a separate file, WOFUSER.PUZ. It will be your responsibility to check the entries out and import them into the WHEEL and/or BONUS databases. Be sure to delete the file when you are finished with it, as WOF will add on to the file if it is found in the WHEEL directory. If not found it creates a new one.

NOTE: This option is only available if Door is registered!
Usage Log As an option, we provide you with the ability to log every player to a text file. IF you enter Y in the CFG file to log callers, the Door will place the caller's name as well as the ON and OFF times each time a caller selects the Door. A separate file will be created for each Node and the name of the file will be USAGEx, where x is the Node number.

You may delete these files at any time and the Door will recreate them the next time a caller enters the Door. If you do NOT want to continue logging callers, change the CFG file entry to N.
Adopt-A-Door The concept, ADOPT-A-DOOR, allows a caller to register (ADOPT) a door. It would be the same as sending in a donation, only this way it is earmarked for registering a particular door. In a way, the user feels he/she is "getting something in return". As a Door author I have decided to build this concept into each of my Door programs. The concept replaces the usual message "tell the Sysop to register this Door" we find in most
doors.

If the Door is unregistered then a message appears on the opening screen to that effect. After finishing or suspending a game, a message screen is displayed about the ADOPT-A-DOOR concept. The message also tells the caller to contact the Sysop to find out if there is any further details to the ADOPT-A-DOOR concept. Some Sysops give extra D/L time, online time, etc to callers that ADOPT-A-DOOR.

If the Door has been registered, either by the Sysop or other callers, the names of those contributors will be displayed in the closing screen.

NOTE: If you want to display the names of the callers that contributed to registering the Door, you must create an ASCII file called ADOPT.SYS. You create it with an ASCII text editor. Enter the names of the contributors (one on each line, maximum of 5 entries, each a maximum of 30 characters long). This file must be saved, in ASCII format, and placed in the Door directory.
Legalities THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
Distribution You may make this file available for downloading from your BBS or you may upload it to any BBS or WEB site of your choice, provided that you do not make any changes to the contents of the archive (ZIP/EXE file). The archive and its individual contents may not be used by any service that charges any money whatsoever, without the written permission of the author.
Registration Registration and the subsequent insertion of the registration number into your configuration file, allows for the display of your BBS name on the opening and closing screen as well as the reduction of a delay built into the opening screen display along with the ability to change certain values in the configuration file.

Once a door is registered, any changes to registration information (Sysop name or BBS Name) will require the doors to be re-registered at the registration fee in effect at that time.

Be sure to use the proper upper/lower case when filling in your name and BBS name, as they MUST match the way you entered them in the configuration file.
Misc. The latest version this product, along with and other fine DOOR and HOME EDITION products are always available for download from this web site.


Moving Eye Line

Moving Eye Line


Last modified: March 28, 2018        Valid XHTML 1.0 Transitional