Rockin Radio WINServer Documentation

Version	1.8
Author/Contact	Al Lawrence/Sunrise Door Software
Overview	ROCKIN' RADIO allows users to play D.J. for a day. Users get to perform various tasks that a Radio D.J. would each day with their ultimate goal being to obtain a listening audience of 1,000,000 people.
Non-Registered Restrictions	- Game cannot be reset - Game can't be won. Game reset after 100,000 listeners reached - Number of Player Steals cannot be altered in CFG file - Number of Commercials per day cannot be altered in CFG file - Starting Advertisements per day cannot be altered in CFG file - Number of Promotions per day cannot be altered in CFG file - Game time limit disabled - Number of days of inactivity before being purged is defaulted to 5 days
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: RRADIO Parameter: c:\wc5\doors\RRADIO (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
	Y	Y = Log all callers to USAGEx N = Do not log callers
	# 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
	# 2	Player Steals per day (Max=5)
	# 3	Commercials per day
	# 3	Advertisements per day
	# 3	Promo Appearances per day
	# 5	Players purged after this many days of inactivity
	N	Y=use European Date Format (dd/mm/yyyy) N=use American date Format (mm/dd/yyyy) DEFAULT!
	G	Door Rating. Default is G. Maximum Characters: 5

Maintenance	The daily maintenance is performed AUTOMATICALLY when the first player enters the door for the day. This maintenance program performs the games daily maintenance such as: Players automatically deleted after the number of inactive days defined in the CFG file. Fix any ON-NOW flags if the main program has somehow missed setting this to NO because of LOSS OF CARRIER or another problem in the door.
Game Reset	To reset a game, which in effect resets EVERYONE and causes them to start over, you would have to enter the game and use an NON-DISPLAYED Main menu Command of ~ (tilde). Be sure that no one is in the game on any other node. Please be aware that this is a REGISTERED feature ONLY.
Game Data Files	We would strongly advise you to AVOID making any changes to the .DAT files. If you just can't resist, and you do so at your own risk, then be sure to RESET the GAME first. If you encounter ANY strange occurrences in the game AFTER you fiddle with the files, be sure that you restore them to their original state BEFORE you call Sunrise Door Software for help.
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.

ROCKIN' RADIO WINServer Documentation