Wonka DS run & ctl programs
(Dec 2003)


mods -
WonkaDSrun (v1.05 Jan 2004) - Increased commandline buffer from 132 chars to 256 chars.
WonkaDSrun (v1.04 Jan 2004) - Moved quit on win and mines to wonkaDSctl.txt. Password in wonkaDSctl is now ignored. wonkaDSrun now expects first 3 arguments as [gametype] [port] [mapname]. Any additional parameters are passed as normal arguments. (See wonkaDSrun examples below).
WonkaDSrun (v1.03 Jan 2004) - Added logic to handle winboloDS hanging. The pipe that recieved messages from winboloDS would end early, and not all messages were received. This caused DS to hang.
-------

This program starts winboloDS as a background process, then creates a MailSlot so the game BOTS can interface to winboloDS via the program wonkaDSctl.exe.

Files:

wonkaDSrun.exe, wonkaDSctl.exe, and wonkaDSctl.txt must be in the same directory that winbolods is located.

wonkaDSctl.txt - This file contains certain default parameters used when winboloDS is executed.

pword=mypassword This parameter is no longer used (as of v1.04)
track=tracker.winbolo.com:50000 This is the default URL for the tracker.
quitw=yes The presence of quitw in the control will set winboloDS to run with the -quitonwin parameter.
mines=no Set this value to 'yes' to allow hidden mines in the game.

Executing:

wonkaDSrun - There are several required command line parameters that must appear in the following order:

wonkaDSrun [gametype] [port] "[mapname]"

examples:

wonkaDSrun strict 62110 "chew toy 3.map"
wonkaDSrun strict 62110 "chew toy 3.map" -password chewbacka
wonkaDSrun strict 62110 "chew toy 3.map" -password chewbacka -ai no -delay 120

Example 1 starts the map chew toy 3 as a strict game on port 62110 with no password.
Example 2 does the same thing except the password for the game is now chewbacka. Example 3 is the same as examples 1 and 2 plus, no brains and a delay of 120 seconds.

wonkaDSrun then starts winbolods as a background process and opens a MailSlot in the format of gm62110. It uses the port number to uniquely estabish the MailSlot. WonkaDSctl then uses this mail slot to pass commands to wonkaDSrun; which in turn passes the commands on to winboloDS.

wonkaDSctl - This program is then used to pass LOCK, UNLOCK, or QUIT to winboloDS via the named pipe.

examples:

wonkaDSctl lock 62110
wonkaDSctl quit 62110

The first example opens the pipe named gm62110, passes the LOCK command to winboloDS. the second sends a quit.