Resource icon

VASSAL Launcher 1.30

No permission to download

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski submitted a new resource:

VASSALlauncher - Manage and launch multiple VASSAL/module/preference configurations

If you want to right-click to open a VASSAL game file in one subdirectory with VASSAL 3.7.16, VASL 6.7.1-beta4, and a certain set of extensions, and open those in a different subdirectory with VASSAL 3.7.13, VASL 6.6.10, and a different set of extensions, VASSAL Launcher will do that for you. VASSAL Launcher also lets you switch between different preferences and sets of extensions with just three mouse clicks (click on Make Default, then double-click on the configuration to use).

VASSAL...
Read more about this resource...
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Two new buttons and bug fixes

Added "Show VASSALs" button to show the versions of VASSAL you've told VL about.
Internal cleanup: removed InterfaceFuncs.py and import Interface inside functions when necessary. Made minor fixes so VSCode's Pylance no longer detects problems because it's overzealous.
Fixed error when if you tried to edit a config and chose the same name or the same VASSAL version it currently has.
Added "File Info" button to show which VASSAL version and module version a game file was created by.
Replaced...
Read the rest of this update entry...
 

dlazov

Forum Guru
Joined
Mar 22, 2004
Messages
8,739
Reaction score
2,174
Location
Toledo, Ohio
First name
Don
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:
Scott I can't get this work. I can create configs but they don't launch VASSAL nor VASL. I am probably not doing something wrong. It seems this wants a pre-saved vlog or vsav which is not what I was expecting. I was expecting this to actually launch a specific version of VASSAL and then a specific version of VASL with or without extensions and then I could pick my boards and pull my counters and begin. But this is not what this VASSAL Launcher seems to do, instead it was to launch something and load a vsav or vlog, which again is not what what I was expecting.
 

Gordon

Elder Member
Joined
Apr 5, 2017
Messages
3,173
Reaction score
4,003
Country
llUnited States
@ScottRomanowski OK, I started playing around and before I go too deeply, I wanted to see if there was any prep work that I should do before I start creating configurations. Primarily I am going to want to use this to prototype splitting the extensions into "pre-6.7.0" and "6.7.0 and beyond" as well as to easily switch between various beta versions that I am working on. I also have saved games that represent a SASL campaign I am playing, a SASL campaign I am using to introduce my son to ASL, miscellaneous games and a boatload of saved games I use for testing and developing SVG features. I will almost always just using the latest version of VASSAL for all these.

Should I create 2 extension directories for the pre/post separation I mentioned above? Do I keep all the different VASL vmods in my main VASSAL folder as before? Do I create separate saved game folders or simply keep separate sub-directories of the saved game folder?

TIA
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
Hi Gordon,
(As you know, but others don't, all versions of VASSAL use the same preference file, V_Global, and all version of VASL use the same preference file, VASL. VASSAL Launcher lets you have and switch between multiple copies of those. The process I describe here makes sure that the correct versions have written their preferences before VASSAL Launcher copies them.)

First, run VASSAL. Run VASSAL Launcher. In VASSAL Launcher, select "New VASSAL" and select the directory VASSAL is installed in. (On my WIndows box, it's "C:\Program Files\VASSAL-3.7.16".) That will tell VASSAL Launcher about that version of VASSAL and also it will copy the V_Global file. (You can watch VASSAL Launcher doing its work by watching it create files and directories in your AppData\Roaming\VASSAL\prefs\VASSALLauncher folder.)

You need to do this for every VASSAL version you will use. If you want, after you're no longer using them, you can delete old VASSAL versions from VASSAL Launcher's list (but not from your system) with "Delete VASSAL".

For each version of VASL, first run it in VASSAL, change its preferences to how you want them, and set up the extensions as you want (changing the extensions is optional as you can do that in VASSAL Launcher). Then select "New Config" in VASSAL Launcher (VL for short) and create a configuration that uses that .vmod file. When you make the configuration, VL copies the VASL preference file and the extension directory set in it (VASL's File->Preferences->Extensions "Extensions Directory" field) to its own copy.

Should I create 2 extension directories for the pre/post separation I mentioned above?
You can but you don't need to because VL maintains its own copy of the extension directory for each configuration, and lets you edit them independantly. When you "Start Config" (or "Start a File" or open a game file with VL from Explorer), VL copies its copies of V_Global, the module's preference file (VASL), and the extension directory tree, all to where VASSAL and the module expect to find them before it starts VASSAL. "Make Default" also does this copying, but doesn't start VASSAL.

VL will let you activate, inactivate, add, and delete a configuration's extensions. It does this by manipulating its copy of the extension directory tree, which it later copies when you start that configuration.

Do I keep all the different VASL vmods in my main VASSAL folder as before?
The .vmod files can be anywhere, and they can be for any game, not just VASL. When you create a new config, you will tell VL which .vmod file to use.

Do I create separate saved game folders or simply keep separate sub-directories of the saved game folder?
To use all of VL's power, you will want to have multiple folders and/or subfolders. This is because, if you use "Start a File" in VL, or "Open with" VL when you right-click on a .vsav or .vlog file in Explorer, VL uses the file's directory to figure out which config to use.

For example, you might put all your SASL campaign games in "Saved Games\My SASL", creat a VL configuration called "My SASL campaign" with a start directory "Saved Games\My SASL" (actually something like "C:\Users\Gordon\Saved Games\My SASL"). You might put all your SASL games with your son in "Saved Games\son", and create another configuration that uses that start directory. And possibly multiple directories for the SVG development, broken down by the combination of VASSAL version, .vmod file, and extensions.

Think of a configuration as a snapshot of "which VASSAL version + VASSAL preferences + which .vmod file + module preferences + extension directory contents". VL does all the work needed to run a snapshot. (As a side effect, if you run VASSAL independantly, you'll run the snapshot.)

To keep VL up-to-date as you change things in VASSAL or a module,
  • if you add a module to VASSAL, or change VASSAL's preferences, use "New VASSAL" in VL and add that version of VASSAL again. VL won't duplicate it, VL will simply overwrite its copy of V_Global.
  • if you start a config in VL, then change the preferences, use "Update Config" in VL to make VL copy the changed preference file to its copy.
For reference, my VL setup looks like this
32468

Each line should be easy to figure out: game name, .vmod filename, name of the configuration, which VASSAL version it uses, and the start directory.

And to show you behind the curtain, my AppData\Roaming\VASSAL\prefs\VASSALLauncher folder looks like this:
32469
You can see the copy of V_Global that VL keeps, as well as the multiple copies of the VASL preference file "VASL" and the multiple copies ot the extension directories.

I hope this helps.
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.11

  • Get the full path of any command-line argument so you can start it at the command line, e.g. "VASSALlauncher.exe game.vsav". This passes the full path to VASSAL so it can open the game file.
  • Fixed a bug where if you edited the name of a config, you might start editing a different one.
  • Update the last directory used to open a file when the user uses the File Info button.
  • Added an explanation of the display of configurations to the instructions.
Read the rest of this update entry...
 

dlazov

Forum Guru
Joined
Mar 22, 2004
Messages
8,739
Reaction score
2,174
Location
Toledo, Ohio
First name
Don
Country
llUnited States
Is there some simple instructions on how to get this VASSAL launcher to actually launch VASL with some kind of configuration?

So far I am just seeing walls of text which is not helping the matters much.

It seems you may need to first launch the VASSAL program and then launch the actual VASL program and then keep both running and then launch this VASSAL launcher and then make some kind of config file and then in the future you need to launch the specific VASSAL version you want to play with and then launch the specific VASL version you want to play with and then launch the VASSAL launcher which will then launch VASSAL and VASL with the configuration you wanted to run it in.

Boy that is confusing, I thought this would help launch VASSAL with a specific configuration but it does not and is so confusing at this point I think it may be best to just do things the old way, launch VASSAL and then launch VASL lol

Signed totally confused on what this VASSAL Launcher is supposed to do or how to even use it.
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
First you need to create configurations in VASSAL Launcher. When creating configurations you need to run VASSAL and VASL so VL can take "snapshots" of the preferences. After that, you can run only VL; it will run VASSAL and the correct module with the preferences from a "snapshot". Or just right click on a game file (.vsav or .vlog), select "Open With" "VASSAL Launcher".

If you are not changing preferences, and always using the latest version of VASSAL and VASL, you don't need VL. You can simply double-click on a game file to open it. (Or the Linux or Mac equivalent to double-clicking.)

If you are changing the VASL extensions you use, or the VASSAL version you use, or the VASL version you use, then VL will help. Maybe you are running VASSAL 3.7.16, and using VASL 6.6.10 with Abe, VASL 6.7.1-beta4 with Ben, VASL 6.7.1-beta5 with Charlie, and testing a new extension with VASL 6.7.1-beta5. You would like to right click on a game file, select "Open With" "VASSAL Launcher" and have VASSAL start with the right version of VASL and the correct extensions. In situations like that, VL is useful.

To manage the above manually, I'd run VASSAL. For games with Abe, I'd set up the extensions for VASL 6.6.10, double-click on VASL 6.6.10, then open the game file in VASL. I'd do a similar process for games with Ben and Charlie, or when testing the new extension.
 
Last edited:

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
Once you have created configurations in VL, you don't need to start VASSAL yourself. You can
  • In VL select "Start Config", double-click on a configuration and answer "No" when asked if you want to start with a file. This will set the VASSAL and module preferences and extensions from that configuration, then run VASSAL and start the module in that configuration.
  • In VL select "Start Config", double-click on a configuration, answer "Yes" when asked if you want to start with a file, and select a game file (a .vsav or .vlog file). VL will do everything as above and also open that game file in that module.
  • In VL select "Start a File" and select a game file. VL will find the configuration to use -- the one whose "Start Directory" matches the directory of the file you selected -- and VL will do everything as if you started a config with a file above.
  • (This last method requires that you have edited the sample_vl.bat included in VL's .zip file so it has the correct paths for your system, or used pyinstaller to make VASSALLauncher.exe.) In Windows Explorer right-click on a game file and select "Open With" vl.bat (or VASSALLauncher). VL does everything as used "Start a File" above.
In all those cases, the version of VASSAL will start, the version of the game module will open with the right extensions, and (optionally) the game file will open. Which version of VASSAL, which version of the game module, and the extensions are stored in the configuration.
 
Last edited:

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
Would it be easier to understand if the buttons were labeled "Launch Config" and "Launch a File" instead of "Start..."?
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.12

  • Changed "Start" to "Launch" because "Start" can be interpreted as "begin a new thing", but "Launch" implies an existing thing. The buttons are now "Launch Config" and "Launch a Game File
  • Consistently capitalize the name as "VASSALlauncher".
  • Fixed bug where I was copying incorrectly if the user creates a config with an extensions directory, edits that extensions directory in VASSAL/the game module, then clicks "Update config".
  • Record deleted password when you delete a...
Read the rest of this update entry...
 
Last edited:

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.2

I added the function to edit the recent games list from my "Edit recent games list" program (also here in resources). Note that this lets you edit only the copy of the game's preferences in the VL configuration you edit. You have to "make default" or launch using the configuration to have the VASSAL module "see" the edits.
Read the rest of this update entry...
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.21

This is a minor update.
  • After testing I discovered that VASSAL bases the extension directory for old modules on the module's filename, not the game name in the module. That is, if you have a module 18xx.vmod (with the game name of "18xx"), VASSAL assumes its extensions are in 18xx_ext\. If you rename it to My18xx.vmod, VASSAL assumes its extensions are in My18xx_ext\. It doesn't use the game name of "18xx". This made it possible for VASSALlauncher to predict the extensions...
Read the rest of this update entry...
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.22

  • Added code to confirm deletion of a configuration or a VASSAL version.
  • Fixed error when creating a config for an old module that had the extensions in the <name>_ext directory, but that directory didn't exist.
  • When launching a .vsav or .vlog file, compare the module name and version in that game file to that of the module in the config, and ask if the user wants to continue if they don't differ.
Read the rest of this update entry...
 

ScottRomanowski

Q&A/errata Compiler
Joined
Jul 31, 2010
Messages
2,550
Reaction score
3,361
Location
Massachusetts
First name
Scott
Country
llUnited States
ScottRomanowski updated VASSAL Launcher with a new update entry:

Version 1.23

Fixed a bug where, if you had a module open and tried to launch a config that uses any version of that module with VL, VL would try to replace the extensions and silently fail (because the module had them open), and not launch the config and game. Now the code catches that it could not replace the extensions and asks if you want to launch without the changed extensions anyway. "Make default" also had this bug; now VL reports failure.

Re-ordered the columns and sorting order. The columns...
Read the rest of this update entry...
 

sushidog

Junior Member
Joined
May 11, 2016
Messages
40
Reaction score
11
Location
Calgary
First name
Grant
Country
llCanada
I have VASSAL 3.7.21 (and update towhatever is the latest) installed. I then installed 3.7.14 to be able to use VASL-templates and VASL 6.6.10. That all works great. But I play a ton of other gamnes via VASSAL and I'm accustomed to simply double-clicking on the .vlog file, and then VASSAL and the associated module launch. That still happens, but now it launches VASSAL 3.7.14 instead of the latest. Is there some way to get it to still use the latest VASSAL when I double-click on a vlog? I don't want to have to bugger around opening VASSAL and then drag and dropping or opening the vlogs any way other than by double-clicking.
 

Robin Reeve

The Swiss Moron
Staff member
Moderator
Joined
Jul 26, 2003
Messages
21,536
Reaction score
8,113
Location
St-Légier
First name
Robin
Country
llSwitzerland
A simple solution would be to uninstall the older VASSAL version.
 
Top