VASSAL Mass Piece Loader

The Mass Piece Loader allows you to create multiple Game Pieces at once, based on a directory of appropriately named images. All Game Pieces created will use the same Piece template, but will have different images loaded into their Layer traits.

VASSAL Piece Mass Loader is activated with a right-click on an item which can contain pieces. Decks, At Start Stacks and Piece Palettes are all good examples of such entities; right-click on the item and select Add Multiple Pieces:

VASSAL Piece Mass Loader window shows up:

Images can be loaded into multiple levels within each Layer trait. A modified version of the Layer trait is used which defines how image names are matched and loaded into each level.

The processing works as follows:

  1. Locate all images that match any of the selection criteria in any level of any layer defined in the template.
  2. Any remaining images are used as the base images.
  3. A level image is matched to a base image when it commences with the base image, but has a different suffix and matches the rule recorded against the level.

Images that match one of the level definitions, but do not match any base image are ignored.

A Layer trait is added to the counter only if it has at least one image in a level.

The table in the lower half of the screen shows the Game Pieces that will be created.

Display Columns


Piece Template

The Piece Template used to create each piece looks like the standard Piece Window used to define Prototypes. You can add any traits to the template except for the Basic Piece, this is created for you automatically. Define each trait in exactly the same way as you would for a normal piece, they are all the same as the for the standard Piece Window with the exception of the layer trait. The Layer trait included in the Mass Piece Definer is a modified version taht allows you to specify which images will be loaded into levels with the trait.

Modified Layer Trait

The Modified Layer trait is the same as a standard Layer trait except for the way the image for each level is defined. Instead of an Image Picker to select any image, you define how the image name you want to load is related to the base image that defines the piece.

The options you have to choose from are:


A set of counters has a 'back' side that shows the Transport side of the counter. The image for the transport side of the counter is the same as for the front side, but with a suffix of -trn. Example counter names will be:

The template will have a layer with a single level with the selection set to Ends with -trn.