VASSAL Reference ManualHome > Module |
|||||||||||||||||||||||||||||||||||||||||||||||||||||
Module
|
The Module is the top component in the Editor Configuration Window. Its properties are simply the
name of the game, a version number, and a description. These properties are each displayed separately their own
columns when the module is listed in the Module Manager that appears when Vassal starts up. The version number is
used to warn users who attempt to load save files created by a later version of a module into an earlier
one. All additions and modifications to a module are done through the Configuration Window, also frequently referred to as the Editor window, which is a familiar file/folder type browser in which each file/folder represents a module Component. The second illustration on the right shows the Editor's configuration window for a "Brand New Module", with all of the Components that are added by default. Right-click on the [Module] to get a context menu with options for the many types of Components you can add to a Vassal module, including maps, charts, and palettes full of game pieces. See below for more details. Actually playing the game takes place in the Module window (see example below). This window includes a Toolbar that can be configured by the module designer, as well as a Chat Log to record player messages and game moves. The game's main Map will be displayed just below the Chat Log. ![]()
Module window during play, showing the Toolbar, a Game Piece Palette, and the Chat Log. The mapboard would appear below.
|
![]()
[Module] Properties
![]()
Editor window with [Module] Component Highlighted
|
![]() |
Chat LogEvery game module contains exactly one Chat Log, and it always appears in the main Module window just underneath the toolbar. It exists by default and cannot be removed in the Editor. The chat log not only allows players to "chat" with each other by typing messages into the lower text line, it also displays a running "log" of game events -- messages produced by Report Action traits and other Message Formats in traits and various module components. Messages from your components can be displayed in a variety of colored, bold, and italicized fonts, as the chat log provides substantial HTML support to create a visually attractive and easy-to-read report log. See full article for details. |
A proper module consists of many different types of subcomponents. Any of them can be added by right-clicking on the
[Module] component in the Module Editor (the very top entry in the editor) and then selecting the appropriate Add
option. |
![]()
Editor window with [Module] Component Highlighted
|
Help MenuEvery module has a Help entry on the main menu of its control window. Only one Help menu is allowed, and it may not be removed. See the full article for details on how to add items to the Help Menu. |
![]() |
![]() |
Definition of Player SidesThere is no requirement to define player sides for a module. If you define no sides, then all windows and all game pieces are visible and accessible to all players.If you wish to create components that are available only to one side in a game (e.g. a Private Window), you must define the player sides here. Simply type a name for each side and refer to that name in the restricted component(s). Only one player may be assigned to a side. When joining a game, players will be prompted to take one of the remaining available sides. Any number of observers (players who belong to no side) are allowed. The Retire or Switch Sides button, in the main controls toolbar, allows a player to relinquish their side (making it available to the next player joining the game). You can specify the text, icon, and mouse-over tooltip for the toolbar button. |
Global OptionsA set of options that apply to the module overall. Every module will have one Global Options entry; it can be edited but cannot be removed.The Global Options component allows you to define your own custom preferences for a module. It also contains other settings that apply to the module as a whole, as well as providing a location to configure button images and hotkeys for some of the basic Toolbar buttons. If an option has a Use Preferences Setting choice, selecting it will add an entry to the Preferences window to allow players to choose their own setting at game time. See full article for details. |
![]() |
![]() |
Map WindowA Map Window contains the main interface for playing games with VASSAL. It displays the playing surface on which the players move Game Pieces by dragging and dropping with the mouse. It is possible to have two or more Map Windows; the players may drag and drop pieces between the different windows. A Map Window should be configured with at least one Board (in the "Map Boards" component).A Map Window is most commonly used to display a Board on which pieces can be moved, although Map Windows can also be used to display e.g. reinforcement cards, charts and tables, and so forth. By default, every module has one Map Window, although it may be removed and others added. There are also specialized Map Windows, called Private Windows and Player Hands to contain pieces that are private to one player or side. See full article for details. |
Game Piece PaletteA Game Piece Palette allows an unlimited supply of new pieces to be created and added to the game. Some modules use them exclusively to create pieces whose supply is not limited by the game rules (e.g. control markers); other modules provide palettes from which any type of piece can be created so that players and designers can use them to set up game scenarios. By default, every module has one Game Piece Palette, although it may be removed and/or more may be added.See full article for details. |
![]() |
![]() |
![]() |
Game Piece Prototype DefinitionsGame Piece Prototypes allow you to define sets of commonly-used traits for various types of Game Pieces. For example you could give all of your cards a particular back and a key command to send it to the discard pile, without having to cut-and-paste those traits into every single one of your cards. This also has the advantage of allowing you to change these traits in one place and have the changes affect every one of the pieces assigned to the Prototype.See full article for details. |
![]() |
Global PropertiesAllows you to define default numeric or string values for Global Properties which can then be referenced and modified by traits in your Game Pieces. Global Properties work much like "global variables" in programming, in that they are accessible to any piece or component in your module.See full article for details. |
Toolbar MenuGroups buttons in the Toolbar into a single drop-down menu. Each button named in this component will be removed from the Toolbar and instead appear as a menu item in the drop-down menu.See full article for details. ![]() |
![]() |
![]() |
Multi-Action ButtonCombines multiple buttons in a Toolbar into a single button. The named buttons are removed from the Toolbar and a new button is added. Clicking this button automatically invokes the actions of all the other buttons in the order given.See full article for details. |
Action ButtonA Toolbar button that displays a message, plays a sound, and/or sends Hotkeys.An Action Button component places a button on the Toolbar of the main Module window which combines a number of different actions into a single button. When the button is clicked, or receives its Hotkey, it can display a message to the Chat Log, Play a sound, and/or send a list of Hotkeys or Named Key Commands to other components. See full article for details. |
![]() |
![]() |
Turn CounterCreates a Toolbar item that can be used to track the current game turn and phase.A Turn Counter places a button and/or widget on the Toolbar of the Module window which keeps track of the current turn/phase/sub-phase, etc. of a game. Players can advance the turn forward or backward, or optionally jump directly to a turn. See full article for details. |
Game Piece Image DefinitionsAllows you to build your own layouts and images for simple game counters without the need for an external art tool.Within the Game Piece Image Definitions you can build your own images by combining text, images, and standard NATO symbols. Images defined in this component will appear in the drop-down menu for selecting images for any Trait of any Game Piece just like an imported GIF, JPEG, or PNG. See full article for details. |
![]() |
![]() |
Global Key Command
Creates a button on the Toolbar that applies a given key command or Named Key Command
to many pieces at once. Applies to Game Pieces on all Map Windows
simultaneously. |
Game Piece Inventory WindowCreates a Toolbar button that will open a window which summarizes the pieces in the current game. You can define exactly which pieces are included in the window and howthey are organized. Can be configured to select a particular subset of pieces and to organize them by their properties.See full article for details. |
![]() |
![]() |
Symbolic Dice ButtonRolls dice whose faces are represented by graphical images.A Symbolic Dice Button places a button on the Toolbar which rolls dice that use graphical images to display their faces -- in simpler terms, "dice that look like dice". A Symbolic Dice Button can roll one or more individual dice, each represented by a [Symbolic Die] component, each of which may in turn have any number of faces (represented by [Symbolic Die Face] sub-components). When the button is clicked, a random face is selected for each Symbolic Die that this component contains. The results of the roll can be reported as text into the chat area, and/or graphically in a separate window and/or in the button itself. See full article for details. |
A Toolbar button to generate random numbers in the Chat Log. You may add
any number of buttons. Each button will roll a specified number of dice with a specified number of sides and report
the result in the Chat Log. Name is the text accompanying the resulting roll in the Chat Log. You may specify
Button Text and Tooltip Text for the button and supply an image file to use as a
Button Icon. You may also define a Hotkey that acts as a keyboard shortcut for pressing the button.
Check the Report Total box to report the sum of all dice (e.g. 3-18 for 3x6-sided dice). If the box is
unchecked, the dice will be reported individually (e.g. as "2,6,3"). If the Prompt for values box is checked,
then players will be asked to select the number of sides/dice every time they press the dice button during a game.
Report Format specifies the Message Format for reporting the results: $name$ is the name of the button as specified above, $result$ is the result of the roll, $nDice$ is the number of dice, $nSides$ is the number of sides, $plus$ is the modifier to each die, and $addToTotal$ is the value added to the total. The $result$ of the dice roll is stored as a global Property under the name <name>_result, where <name> is the name given to the component. (Example: A dice button is named "2d6" After a roll of 11, the property name $2d6_result$ will resolve to "11" until the next roll. |
![]() |
Replaces the New Game menu item in the File menu of the main Module
window with a new menu item that loads a saved game which you specify in advance. Name: Text of the menu item. Contains sub-menus: Instead of specifying a saved game, you can check this box to add a sub-menu with the given name to the File menu. Then you can add more Pre-defined setups to this one to create entries in the sub-menu. Use pre-defined file: If left unchecked, this menu entry will start a new game from scratch, like the normal New Game action. Saved Game: Select a saved game from your local hard drive. This game will be loaded when the menu item is selected. If the file does not exist, then the menu item behaves like the normal New Game item. Example: Add a Pre-defined setup named "Play Scenario" to the module and check contains sub-menus. Then add another set of Pre-defined setups named 1939, 1940, 1941, 1942 to the first and select a saved game file for each one. Players may now select File->Play Scenario->1939 to load the 1939 scenario, etc. CAUTION: When creating a Pre-defined setup in a module with defined sides, always remember to click the Retire button and switch to Observer status before saving. Otherwise, the side you chose when creating the game you will be permanently assigned to you. |
![]() ![]() |
![]() |
Chart WindowAdds a button to the Toolbar which opens a window for holding game play aids: charts, tables, etc for player reference.See full article for details. |
Private WindowA Private Window behaves much like a normal Map Window, but is designated as belonging to a particular side or sides. This is particularly useful for holding a secret reinforcement pools. The owning sides must correspond to one or more of the sides defined in the definition of player sides.See full article for details. |
![]() |
![]() |
Player HandA Player Hand is a specialized Map Window for containing a hand of cards. It is designated as belonging to a particular side or sides. The owning sides must correspond to one or more of the sides defined in the definition of player sides.The main difference between a Player Hand and a Private Window is that in a Player Hand, the contents are automatically laid out in a row instead of stacking like counters. Like a Private Window, a Player Hand can only be manipulated by the owning player, and can optionally be completely hidden from other players. Cards can be manipulated in the hand (turned face up, etc.) and can be rearranged in order. Cards can be dragged into and out of the window to add/remove them from the hand. See full article for details. |
A window for saving text notes along with a game. A Notes button will be added to the Toolbar of the
Module window, enabled when a game is started. Clicking the button displays the notes window. The Public tab
contains notes that are visible to all players and to which all players may add. The Private tab contains
notes that are visible only to the player who entered them. The Delayed tab is for writing messages to be
revealed at a later time as a safeguard against cheating. To create a delayed message, hit the New button
and enter a name and message text. Once created, the text of a message cannot be changed. At the appropriate time,
the owning player may reveal the text of the message, at which point other players may read the contents of the message. |
![]() ![]() |