GameMaster
Rank: Admin
Site Administrator
Ottawa, Canada
# of Posts: 1172 |
Instructions on using DGMS
Download and unzip the DGMS zip file to a folder on your hard drive.
As mentioned, DGMS is a DOS/command line based program so will require that you open a DOS window (simplest way is "start" -> "run" then type "cmd"). Open a DOS window in the directory that contains DGMS or open a DOS window, then use the CD command to navigate to the correct location.
Verify that DGMS runs on your system by typing "DGMS". Simple syntax/help information should be displayed.quote:
C:\DGMS>dgms
DGMS v3.1.1 (2009/05/05 10:28:53) Today (2454957): 2009/05/05 10:43:49
Syntax: DGMS [GameID] [command]
Where [command] is one of:
c -> process the [C]urrent turn and create an order file for the next turn.
r -> [R]eprocess the last turn and create a new order file for the current turn.
o -> create a new [O]rder file for the current turn (or new game).
m -> Display the contents of the [M]ap data file. [GameID] is not required.
Verify that the map file is compatible with your system. Type "dgms m" to dump the map data to the console display.
Through Windows Explorer, or using the mkdir command in the DOS window, create a subdirectory for the Game ID you will be working with. The subdirectory name must match exactly with the Game ID. For example, you can create a subdirectory called "test" if running a new game. If you are using DGMS in conjunction with a game on this site, then the format is year-xx such as "2009-1".
If you wish to use data from a live game, then download the dgmsmstr.gameid file and copy it to the subdirectory you just created. If you are starting a new game, then a new dgmsmstr.gameid file will be created automatically.
Create order files for the current (or new) turn by typing "DGMS gameid o". Example: quote:
C:\DGMS>dgms test o
DGMS v3.1.1 (2009/05/05 10:28:53) Today (2454957): 2009/05/05 10:29:08
-----------------------------------------------------------
Reading Map File 'dgms.map' -> 75 map positions read.
turn_file: test/dgmsmstr.test
Building new file test/dgmsmstr.test
Game ID: test Last Processed Turn: WINTER 1900
Making order template for: SPRING 1901
Writing positions to order file: test/moves01.test
Writing positions to retreat file: test/moves01r.test
2009/05/05 10:29:08 DGMS Exiting.
This example shows the creation of 2 text files used for entering orders (moves01.test) and retreats (moves01r.test). The file names are in the format move[S|F|W][year][retreat].[gameid].
These file can be modified with any text editor (notepad, wordpad, etc).
Use abbreviations for all commands and province names. Example: A LIV S A WAR - MOS
(See the Original Orders popup option on the Turn Results pages for more examples or to copy/paste into an order file)
Once updated and saved, run the DGMS command to process this turn, generate a report and create a new template for the next turn. quote:
C:\DGMS>dgms test c
DGMS v3.1.1 (2009/05/05 10:28:53) Today (2454957): 2009/05/05 10:29:09
-------------------------------------------------------------------------
Reading Map File 'dgms.map' -> 75 map positions read.
turn_file: test/dgmsmstr.test
Game ID: test Last Processed Turn: WINTER 1900
Command: Process Turn
Looking for the order file: test/moves01.test
Processing the order file: test/moves01.test
Orders processed and saved.
Writing to report file: test/spring01.test
Making order template for: FALL 1901
Writing positions to order file: test/movef01.test
Writing positions to retreat file: test/movef01r.test
2009/05/05 10:29:09 DGMS Exiting.
To play with various outcomes, edit and save the move files and use the "(R)eprocess" command.
Continue entering orders and processing turns as required.
Log files will be written to the main directory and will contain details about the actions taken during the turn processing.
That's about it. It is a very basic program and a simple interface.
|
Attachment: 
05-May-2009 02:56 PM
