-
Notifications
You must be signed in to change notification settings - Fork 32
Chapter P: Update Game Tool
The “Update Game” tool that allows a player to easily and correctly update setup files and games saved in an earlier version of VASL to the current version.
Currently the Game Update Tool does not work properly with SVG graphics and should not be used in VASL6.7.0 and beyond until a fix is implemented.
To avoid breaking an existing file in this initial rollout, follow these three simple rules:
- No save, no worries: if something goes wrong during the update process, close the current game without saving it. The original file should survive unchanged.
- Copy this: Make a copy of a setup file or saved game you want to update. Convert the copy; keep the original.
- SNAFU and FUBAR. Appropriately, these are recognized military terms describing normal daily occurrences. When you experience them, stay calm and carry on!
Open a setup file or a saved game (.vsav file) created in a previous version of VASL. You will see messages in the Chat Window about the VASSAL/VASL versions used to save the game and currently in use. Boards and overlays added via the traditional method (Boardpicker dropdown) will automatically be synced to the latest version and messages will show in the Chat window. Open the VASL dropdown menu (click on the ASL icon) and select Update Game. You will get a popup warning message on the screen. Click Yes to proceed. At this point, all counters will be updated and reported in the Chat Window. If you see any "Cannot Refresh piece . . . " messages please note unit names and VASL version of original game and report. Next the game will compare installed versions of extensions with available versions and, if a new version of an extension is available, it will ask if the user wishes to update it. If so, it will attempt to update and will report results to the Chat Window. Finally, if VASL LOS Checking was disabled in the original .vsav file, users will be prompted to attempt to restore los checking by reselecting boards and overlays. This completes the update process. Players should check that counters now have the latest functionality and that the map is displaying correctly and LOS is working. Please note and report any issues or problems.
For log files .vlog, please follow the same steps after opening the log file (and before playing it). Counter Updating will attempt to update counters that originate in extensions. There will be errors due to inconsistent or duplicate naming of counters in extensions. Please note and report any such errors so that they can be fixed. Such errors should not prevent use of the updated .vsav. The extension updater only checks for updates to extensions the user has already installed. It is not checking for extensions needed for the .vsav file to work properly. For the extension updater to work, users must do a onetime download of version-enabled copies of current extensions. See http://vasl.info/extensions.htm[.](http://vasl.info/extensions.htm)