VASSAL Tutorials

Board Game | Mineatures | Card Game | Double-Blind | Programming


Before Beginning

VASSAL is not a graphics or paint program. We leave that to the experts. VASSAL uses imported artwork in GIF format, which you must have created beforehand using your favorite graphics program. In most cases, this means creating images for the maps, counters, and charts.

A good free tool for making VASSAL counters is the button-making utility ZPaint

Maps must be drawn outside of VASSAL and imported as straight graphics files.  An excellent guide to drawing maps from scratch was written by the VASL map artists.  The most popular program for drawing maps is Paint Shop Pro.  However, an interesting utility for creating maps is Realm Creator.

For each tutorial, there is a data directory containing all necessary artwork so that you can work through the tutorial.

Launching the editor

Launch the VASSAL module editor.

Click on "New Module" to begin a new module. You will see two new windows come up. One is the main control window for playing a game.  Theother is the editing window, where you will do the work of creating your module. As you create the module, you can start new games, move pieces, save, etc. just as if you were playing the module. This allows you to test your module as you create it. Save the module periodically with the "Save" button n the edit window toolbar as you progress.  You may also access the Reference Manual from the edit window toolbar.

The editing window has a standard folder-and-file browser interface. Each component in the tree represents a component of the module. The text for the node gives the name of the module followed by the type of that component in square brackets. The top level represents the module itself. By default, the module contains one Map window, one Game Piece Palette and one Help Menu.  Every component in the edit window has a right-click menu.

The first step in creating a new module is to name it.  Right-click on the module component and select "Properties"  Alternatively, double-click on it.. You'll be presented with a window in which you may set the name and a version number for the module.