Wonka Spawn
(Dec 2003)


modifications:
(Jan 7, 2004) v2.00 - Fixes: None.
New: ability to send passthru parameters to wonkaspawn. Ability to use alternate maps. Create logfiles. Moved tracker, quitonwin, mines to wonkamapctl.txt.
(Jan 7, 2004) v1.06 - Fixes: prob with game starting then immediately exiting, fixed prob with end-of-game messages not displaying on timeout.
New: Ability to pass runtime parameters to WonkaSpawn (Port, Timeout, Password, and GameType). See Updated documentation.
(Jan 3, 2004) v1.05 - Set timeout value to 6 hours. Last set of changes to try and force winboloDS to send text back before 60 something game events didn't work. Readme file is now in html format.
(Dec 29, 2003) v1.04 - Fixed Timeout value not working. Changed buffersize for winboloDS window. Nothing returned from DS until some 60 events occured in game or game ended. The fix will not work under 95, 98, nor ME.
(Dec 29, 2003) v1.03 - Added timeo to wonkamapctl.txt. value is the number of minutes to wait before the game times out.
(Dec 22, 2003 09:20) - Changed to run winboloDSopen, winboloDSstrict, or winboloDStourn depending on gametype. This is to make it easier to identify which winboloDS is running what game.
- Fixed prob with winboloDS hanging. DS still had output for the console.
- Now has timer. If nothing sent to wonkaspawn from winboloDS for 15 minutes. spawn will send QUIT to DS so the Game will quit.


(Dec 11, 2003) - Changed to interface with wonkaDSctl.
(Dec 8, 2003 23:30) - Added wonkamapctl.txt which allows for the changing of the port the games run on. winbolods is now started as a background process.

-----------------------
This program loops thru a list of maps contained in the file wonkamap.txt. It executes the maps in the order they are read. It starts games on several ports depending on if strict, tourney, or open were specified.

Files:

wonkaspawn.exe, wonkamapctl.txt, and wonkamap.txt must be in the same directory that winbolods is located. Any alternate map files are located here as well.

winboloDS. 3 copies of this need to be made called winboloDSopen, winboloDSstrict, and wonboloDStourney.

wonkamap.txt - There cannot be a newline following the last map in the list. If there is, the program will end at that point.

wonkaspawnOPEN.log, wonkaspawnSTRICT.log, wonkaspawnTOURNA.log - These are log files created during the execution of the game. All game events are recorded here.

wonkamapctl.txt - This is the control file for specifying the port the games are to run on, and the password for all strict and tourney games.

oport=27500
sport=27501
tport=27502
pword=mypassword
timeo=60
*** NOTE - New items in v2.00 ***
track=tracker.winbolo.com:50000
- If you want this as passthru, remove from file.
quitw=yes
- If you want this as passthru, remove from file.
mines=no
- If you want this as passthru, remove from file.

if pword is ommited, no passwords are required for strict nor tourney games.

Executing WonkaSpawn:

Format: WonkaSpawn [gtype=Game type] [pword=Password] [port=Port#] [timeo=time out value] [mapf=mapfile.txt] ...
gtype - This is Open, strict, or tourny. The program only looks at the first character to see if it is an O, S, or T.
pword - The password for a non-Open game type.
port - The port number to use for these games. All games started will use the same port.
timeo - The number of minutes before timing a game out after no events have occured.
mapf - The name of an alternate mapfile.

If wonkaspawn is ran with no arguments, all games spawned are open and wonkamapctl.txt is used.

1) wonkaspawn
2) wonkaspawn gtype=strict mapf=strictmaps.txt
3) wonkaspawn gtype=strict pword=bubba port=62101 timeo=120
4) wonkaspawn port=62105 timeo=90
5) wonkaspawn port=62105 mapf=openmaps.txt -ai yes -maxplayers 10

Example 1 starts Open games and uses parameters from wonkamapctl.txt.
Example 2 starts strict games and uses the sport and pword parameters from wonkamapctl.txt. wonkamap.txt is overriden with the alternate mapfile.
Example 3 starts strict games and overrides the password, port, and timeout specified in wonkamapctl.txt.
Example 4 starts open games and overrides the oport and timeo values in wonkamapctl.txt.
Example 5 starts open games and overrides the oport and supplies a new mapfile named openmaps.txt and passes -ai and -maxplayers to winboloDSopen.

Once the program is started, you can use wonkaDSctl to issue the lock, unlock, and quit commands which are passed on to winboloDS. the END command issues a quit to winboloDS and ends the spawner.

To pass commands to wonkaspawn from wonkaDSctl, you need to know the port the game is running on. Communication between wonkaDSctl and wonkaspawn are based on the port.

Examples:
wonkadsctl lock 27500 - This locks the current game.
wonkadsctl end 27500 - This quits the current game and ends the spawner.