DipTool 2.7.1
This is the home page of the Java program DipTool. DipTool parses the output of
the diplomacy judges (results, lists, histories, summaries, and press) and history files of Keith
Schneider. It then adds the games, turns, and messages to a tree and displays the maps.
DipTool can
- read the judge output from files and the clipboard,
- connect to POP3 and IMAP servers to directly get the e-mail messages from the judges, and
- import games from Alain Tésios online mapper www.floc.net.
You can enter the orders using Drag & Drop or popup menus and
send the orders directly to the judges using SMTP. DipTool also has a build in
adjudicator so that you can use it during a FTF game.
If you want to know more about Diplomacy, visit
Hasbro or
The Diplomatic Pouch.
Terms Of Use
DipTool is a Freeware program. You may use it for any purpose. However,
you are not allowed to sell it or include it into any disc/CD collection
that is to be sold for profit. Otherwise, it may be freely uploaded to and
distributed by any Bulletin Board or Internet Site, providing no fee is required
upon its download.
It is provided "as is", without any guarantee made as to its suitability or
fitness for any particular use. It may contain bugs, so use of this tool is at
your own risk. The author takes no responsibility for any damage whatsoever that
may be caused through its use.
Installation
You need a Java 2 Runtime Environment (JRE) 1.4
or newer to run DipTool.
There are two installation alternatives:
- Using Java Web Start (a part of
the JRE 1.4) you can install DipTool by simply clicking here.
Diptool needs access to the network (e.g. to import a game from
www.floc.net)
and the local disks (e.g. to store data files). So before DipTool
is started you will be prompted to allow this (based on a certificate for the
Thawte Freemail Member
diptool@hagenah.de).
- Download DipTool.jar and
store it in a new directory. Then run DipTool.jar with:
java -jar DipTool.jar
Under some operating systems you can also double click the file DipTool.jar to start DipTool.
Note: If you work with many games (over 100) you perhaps have to increase the memory allocation pool size, e.g.:
java -Xmx448m -jar DipTool.jar
DipTool.ico
is an icon for a Windows shortcut.
DipTool.icns and
DipToolFile.icns
are icons for Mac OS X (created by David Kornhauser).
Quick Start
- Creating a group: Click the right mouse button over "DipTool" in the tree and
select "New Group...". Enter "Some Games"
as name and click OK. The group "Some Games" is
added to the tree.
- Adding a result/history: Click the right mouse button over "Some Games" in the tree
and select "Scan a Directory or File Once...". Select a result or
history file (e.g. vgnp1085 (USTX)) and click Scan.
- Displaying a map: Expand the tree and select a turn to display the map
for the turn. Below the map the orders are displayed.
- Read the documentation.
Documentation
Contents
Introduction
Entering Orders
The Menu Bar
The Preferences
The Tool Bar
The Tree
Groups
Games
Turns
Press Messages
E-Mail Accounts
Add-Ins
Variants
At the moment the following variants are supported:
1897, 1898, Asia, Britain, Chaos, Colonial, Colonial96, Crowded, Crowded_1898, Fleet_Rome,
H31, H32, MinorPower, SailHo, SailHo2, SailHo_Crowded, Shift_Around, Shift_Left, Shift_Right,
and Standard.
Judges
DipTool was written to parse the output of the traditional English judges (like
DEDO, FROG, NZMB, SEPO, USEF, USIN, USGG, USOS, USTR, USTX, USVG). The
language-specific judges (like DEAC) are only supported as far as their output
is completely English. The non-traditional judges (like UKDP and USDP) are only
partly supported (parsing of histories and summaries).
Adjudicator
I did the Diplomacy Adjudicator Test Cases
(2004-February-10) with DipTool. The file datc.dtf
contains the test cases. The protocol contains
a description of the rule interpretation and the results of the test cases.
Therefore DipTool is '2000 rulebook/DATC compliant' with the deviations
mentioned in the protocol (especially 4.A.3., 4.A.5., 4.E.1, and 4.E.5.).
I also readjudicated more than 500 Standard games played on the judges and
compared the results. So the adjudicator is very accurate.
Games Collection
The file vgnp.dtf contains all games of
The file vgfp2000.dtf contains all games of the
2000 Vermont Group Full-Press Tournament
including all the press of the final game titleist and the Yahoo group vgfp_titleist
(as messages from Observer to Observer). The information in this file is also available as
web site (created using the web add-in).
The file comments.dtf contains full-press games
with all the press and no-press games were the players wrote a comment each turn.
The information in this file is also available as
web site (created using the web add-in).
Special thanks to Keith Schneider and Rastislav Senderak for several histories, to
Douglas T. Massey for the press of the game titleist, and to Gregory A. Greenman for
the press of the game comments.
Java Classes
Perhaps you can use some of the Java classes of DipTool as framework.
Here is the JavaDoc documentation.
History
Version 2.7.1
- Bug fixed (Copy to Clipboard didn't work)
- Java 6 compatible version (version number not changed)
Version 2.7.0
- SSL and TLS (TLS only for SMTP) protected connections to POP3/IMAP/SMTP servers are supported
- The port of the POP3/IMAP/SMTP server can be set (if no port is specified the default port is used)
- Parsing of diary entries
- The orders/command dialog is not modal anymore (thus you can e.g. open multiple dialogs simultaneously
or view other turns while the dialog is open)
- Command templates can be inserted in the orders/command dialog.
- New variant MinorPower
- A judge can have an secondary email address.
- The adjudicator was tested using the Diplomacy Adjudicator Test Cases (2004-February-10)
- Bugs fixed
Version 2.6.3
- The adjudicator no longer allows moves to own sector via convoy, e.g. Army London -> London via convoy, Fleet North Sea CONVOY Army London -> London
- The adjudicator was tested using the Diplomacy Adjudicator Test Cases (2004-January-23)
- Mac icons from David Kornhauser
- Bugs fixed
Version 2.6.2
- Parsing of messages from a power before the game started
- njudge 1.4 support (the output was changed slightly)
Version 2.6.1
- Java Web Start supported
- New turn images
- Bugs fixed
Version 2.6
- Web add-in to create web sites
- Send commands to judges
- Parsing of deadlines
- Icon that show the state of the orders for a game
- Option to automatically save the file
- Option to automatically enable the order editing mode in a game
- Bugs fixed
Version 2.5.1
- Bugs fixed (D&D order editing, adjudicator, SMTP witn no authentication)
Version 2.5
- Enter orders using Drag & Drop and popup menus
- Send orders to judge using SMTP
- Copy judge orders to clipboard
- Adjudicate turns using the build in adjudicator
- Rollback turns
- E-mail Account, Group, Game, and Turn menus in the menu bar
- Support for parsing DPJudge histories and summaries
- Show starting position of a variant
- Icons for armies and fleets (can be turned off in the preferences)
- Colonial96 variant
- Bugs fixed
Version 2.0
- Receive e-mails from POP3 and IMAP accounts and store them on the hard disk
- New variants: 1897, Asia (from Stephen McKee), Britain, Colonial, Crowded_1898, H31, H32, SailHo, SailHo2, SailHo_Crowded, and Shift_Around
- Documentation/online help (F1)
- Parse press messages and add them to the tree
- Message filter
- Parse summaries
- Parse draw, victory, parameters, and comment in lists
- Progress dialogs are displayed during time consuming operations
- In the preferences antialiasing can be turned on/off and the brightness of the centers can be adjusted
- Colors of the powers changed in the DipTool v1.0 maps
- New icons
- Observer add-in (from Matthias Wuttke) to get a history and summary/list from Alain Tésios online mapper www.floc.net
- The test add-in uses the internal adjudicator to test all aspects of the games
- Bugs fixed
Version 1.0.2
- Skipping of zeros in files (some mail programs add one at the end of saved e-mails)
- Parsing of starting positions
- Support for builds during the starting turn (e.g. Chaos games)
- Support for histories from Alain Tésios online mapper www.floc.net
- Removed bug in the crowded map (wrong name)
Version 1.0.1
- About dialog
- Catching of out of memory exceptions when opening and saving files
Version 1.0
- Support for orders with no or an invalid coast, e.g.
Army Rumania SUPPORT Fleet Bulgaria or
Army Munich SUPPORT Italian Army Piedmont -> Tyrolia (south coast)
- Better ordering of the orders if proxy orders are used
- A simple opening statistic add-in
- Bugs fixed
Version 0.9 Beta
Contact
diptool@hagenah.de