> What did I do wrong? Would someone please be so kind
> to explain the process of updating saved games in
> other words than the help file does.


I updated the Reference Manual page.  Let me know if this explains things
more clearly.

rk

---

When a game is saved using one version of a VASSAL module, and then
re-opened using a later version, the game pieces retain the original
behavior, even if the piece has changed in the Game Piece Palette.  This is
necessary for modules to be backward-compatible with old saved games.
The Update
Saved Games dialog allows you to update a game saved with an older version
of a module to use the corresponding piece definitions in the current
version.  The intended use is to save work when creating Predefined Setups
for a new module version.

The updater works by attempting to match each piece in a saved game to the
component in the Game Piece Palette or Deck that it came from.  The name of
the piece in the saved game is matched with a component in the Game Piece
Palette.  For example, a piece named "4-6-7" may be defined in a list called
"Squads" within a drop-down menu named "German" inside a tab named "Ground
Units".  The Saved Game Updater notes the component in the Game Piece
Palette where the "4-6-7" piece was defined in the old module version, then
looks for the same component in the new module version (i.e. the "Ground
Units"->"German"->"Squads"->"4-6-7" component).  If it finds the component,
it will replace any "4-6-7" piece in the saved game with the piece from that
component, matching the value of Text Labels, Layer activation, rotation,
etc., to the best of its ability.  It is likely you will have to load the
updated saved game and make some adjustments, as the process is not perfect.


Because the updater relies on matching piece names with component names in
the editor, it will not work well if many different kinds of pieces share
the same name, or if the structure of the Game Piece Palette has changed
significantly between module versions.

To update a saved game:

   1. Open the earlier module version in the VASSAL editor
   2. Select Updaters->Update Saved Games->Export GamePiece info
   3. Save the info to a file on disk
   4. Close the editor
   5. Open the later module version in the VASSAL editor
   6. Select Updaters->Update Saved Games->Import GamePiece info.
   7. Select the info file saved in step 3.  The Module version of saved
   games field will list the earlier module version number
   8. Hit the Choose button and select any number of files in the same
   folder to update.  It is recommended to back up the files first.
   9. Hit Update games to overwrite the files.


[Non-text portions of this message have been removed]

Reply via email to