Unable to enter new version of a module

Technical Support & Bugs
1

I am trying to add a new version of a module to my Torch project and it gives me an ‘Invalid version’ error message. I am trying to add ‘WITD-Western_Desert&Torch-2.2.0.vmod’ to the project. It is an update to the ‘WITD-Western_Desert&Torch_v2.1.vmod‘.

Torch was released by GDW and it contained rules for fighting the World War II Torch campaign. It also contains rules for combining the Torch campaign with the Western Desert campaign from the Western Desert game. Finally, it also contains rules for combining the Torch campaign with the Western Desert campaign from the Western Desert game and the Near East campaign from the Near East game.

I planned on having all VASSAL modules for the Torch campaign by itself to be version 1.X. All VASSAL modules for the Torch and Western Desert campaigns combined would be version 2.X. Finally, All VASSAL modules for the Torch, Western Desert, and Near East campaigns combined would be version 3.X. What do I need to do here? Thanks.

2

I guess you are talking about the project Torch.

As I understand it, you have three types of modules

  1. Torch campaign
  2. Torch and Western Desert campaigns
  3. Torch, Western Desert, and Near East campaigns

What would be most natural in that case, would be to have 3 different packages, say

  • Torch campaign
  • Torch and Western Desert campaigns
  • Torch, Western Desert, and Near East campaigns

Module releases (or versions) within a package are independent of each other, so there’s no need to make any kind of convention on the release numbers in that case. In fact, it is better to use a straight-forward increasing version number for each package.

If you do this, you will have a structure like

  • Project: Torch
    • Packages:
      • Torch campaign
        • Release 1.1.0
        • Release 1.0.0
      • Torch and Western Desert campaigns
        • Release 1.1.0
        • Release 1.0.0
      • Torch, Western Desert, and Near East campaigns
        • Release 1.1.0
        • Release 1.0.0

Users will see the three package and the latest release of each of them underneath. See for example Afrika Korps (3rd Ed.) which has 2 packages: Colourful and Ol’School. Please also read about the structure of the GL.

If you put all three kinds of modules in the same package, then users will off-hand only see the module with the largest version number (according to Semantic Versioning) - e.g., your WITD-Western_Desert&Torch&Near_East_v3.0.vmod module. To see the other modules, a user would have to click Older releases.. which is a little counter-intuitive.

Please also consider to structure the README part to make it clear what goes with what.

Check that the version set inside the module file WITD-Western_Desert&Torch-2.2.0.vmod - presumably 2.2.0 is the same as the release to which you are trying to add it. See also about adding a module to a release.

Yours,
Christian

3

Thanks for the suggestions Christian. I have modified the Torch project and now have 3 packages

WITD-Western Desert, Torch & Near East

WITD-Western Desert & Torch

Torch Campaign

When I click the + symbol next to the new WITD-Western Desert & Torch package header and try to enter ‘WITD-Western_Desert&Torch-2.2.0.vmod‘ for the new release name, it is still giving me a ‘Invalid version’ error message before I get to select the actual file to be uploaded.
Also, how do I get the 3 existing Torch releases under the Torch Campaign package and the 2 existing WITD-Western_Desert&Torch releases under the WITD-Western Desert & Torch package.

Ramon

4

The release name is supposed to be a version number. WITD-Western_Desert&Torch-2.2.0.vmod isn’t a version number.

5

That is, your release name should be 2.2.0 (not WITD-Western_Desert&Torch-2.2.0.vmod). See also Adding a release to a package.

Perhaps you should take another look over How to upload modules to the Game Library. Everything - and then some - is explained there.

Please also remember to mark the answer to your question - that helps other users find solutions to their problems. And only you - as the OP - can do that. Thanks.

Yours,
Christian

6

You should get @uckelman to move the various files into their respective packages:

 "packages": [
    {
      "name": "WITD-Western Desert, Torch & Near East",
      "slug": "WITD-Western-Desert-Torch-Near-East",
      "sort_key": 0,
      "description": "",
      "releases": [
        {
          "version": "3.0.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch&Near_East_v3.0.vmod",
              "url": "https://obj.vassalengine.org/images/d/d9/WITD-Western_Desert%26Torch%26Near_East_v3.0.vmod",
              "size": 15552250,
              "sha256": "29c164fae95c3876f85f92dbe8c9d877bd3995307318411ffd13580c261deeae",
              "published_at": "2024-11-14T04:45:47Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "2.1.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch_v2.1.vmod",
              "url": "https://obj.vassalengine.org/images/c/cd/WITD-Western_Desert%26Torch_v2.1.vmod",
              "size": 11013080,
              "sha256": "99c0acf9a769f68fba20b04149ac17cfa1b724569781920c02404005461cb498",
              "published_at": "2024-01-26T06:01:54Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "2.0.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch_v2.0.vmod",
              "url": "https://obj.vassalengine.org/images/c/c5/WITD-Western_Desert%26Torch_v2.0.vmod",
              "size": 11000877,
              "sha256": "96df95a4e6568f179ed61954a07cee706744a1015257b1c9d38d586574761d25",
              "published_at": "2022-12-05T02:40:32Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "1.1.0",
          "files": [
            {
              "filename": "Torch-1.1.0.vmod",
              "url": "https://obj.vassalengine.org/gls/e/7/Torch-1.1.0.vmod",
              "size": 6751135,
              "sha256": "e7cfab8d973a37eb85c38642ee8ef06f51174c296e0be3ca779fab0eb3166004",
              "published_at": "2026-03-24T23:44:51.872247310Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "1.0.0",
          "files": [
            {
              "filename": "Torch_v1.0.vmod",
              "url": "https://obj.vassalengine.org/images/0/0c/Torch_v1.0.vmod",
              "size": 6632103,
              "sha256": "bc3267c72b758d008cbf57e27a527691dd68a0f7a95f47460e8150f0cd572ca8",
              "published_at": "2023-11-16T02:44:36Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "0.9.0",
          "files": [
            {
              "filename": "Torch_v0.9.vmod",
              "url": "https://obj.vassalengine.org/images/2/26/Torch_v0.9.vmod",
              "size": 6558111,
              "sha256": "84934de4be62a1bcd21868858ddaee90b77ff06d6fbfc11bcca2362b14311427",
              "published_at": "2022-11-09T03:54:34Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        }
      ]
    },
    {
      "name": "WITD-Western Desert & Torch",
      "slug": "WITD-Western-Desert-Torch",
      "sort_key": 1,
      "description": "",
      "releases": []
    },
    {
      "name": "Torch Campaign",
      "slug": "Torch-Campaign",
      "sort_key": 2,
      "description": "",
      "releases": []
    }
  ],

to

 "packages": [
    {
      "name": "WITD-Western Desert, Torch & Near East",
      "slug": "WITD-Western-Desert-Torch-Near-East",
      "sort_key": 0,
      "description": "",
      "releases": [
        {
          "version": "3.0.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch&Near_East_v3.0.vmod",
              "url": "https://obj.vassalengine.org/images/d/d9/WITD-Western_Desert%26Torch%26Near_East_v3.0.vmod",
              "size": 15552250,
              "sha256": "29c164fae95c3876f85f92dbe8c9d877bd3995307318411ffd13580c261deeae",
              "published_at": "2024-11-14T04:45:47Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        }
      ]
    },
    {
      "name": "WITD-Western Desert & Torch",
      "slug": "WITD-Western-Desert-Torch",
      "sort_key": 1,
      "description": "",
      "releases": [
        {
          "version": "2.1.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch_v2.1.vmod",
              "url": "https://obj.vassalengine.org/images/c/cd/WITD-Western_Desert%26Torch_v2.1.vmod",
              "size": 11013080,
              "sha256": "99c0acf9a769f68fba20b04149ac17cfa1b724569781920c02404005461cb498",
              "published_at": "2024-01-26T06:01:54Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "2.0.0",
          "files": [
            {
              "filename": "WITD-Western_Desert&Torch_v2.0.vmod",
              "url": "https://obj.vassalengine.org/images/c/c5/WITD-Western_Desert%26Torch_v2.0.vmod",
              "size": 11000877,
              "sha256": "96df95a4e6568f179ed61954a07cee706744a1015257b1c9d38d586574761d25",
              "published_at": "2022-12-05T02:40:32Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        }
      ]
    },
    {
      "name": "Torch Campaign",
      "slug": "Torch-Campaign",
      "sort_key": 2,
      "description": "",
      "releases": [
        {
          "version": "1.1.0",
          "files": [
            {
              "filename": "Torch-1.1.0.vmod",
              "url": "https://obj.vassalengine.org/gls/e/7/Torch-1.1.0.vmod",
              "size": 6751135,
              "sha256": "e7cfab8d973a37eb85c38642ee8ef06f51174c296e0be3ca779fab0eb3166004",
              "published_at": "2026-03-24T23:44:51.872247310Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "1.0.0",
          "files": [
            {
              "filename": "Torch_v1.0.vmod",
              "url": "https://obj.vassalengine.org/images/0/0c/Torch_v1.0.vmod",
              "size": 6632103,
              "sha256": "bc3267c72b758d008cbf57e27a527691dd68a0f7a95f47460e8150f0cd572ca8",
              "published_at": "2023-11-16T02:44:36Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        },
        {
          "version": "0.9.0",
          "files": [
            {
              "filename": "Torch_v0.9.vmod",
              "url": "https://obj.vassalengine.org/images/2/26/Torch_v0.9.vmod",
              "size": 6558111,
              "sha256": "84934de4be62a1bcd21868858ddaee90b77ff06d6fbfc11bcca2362b14311427",
              "published_at": "2022-11-09T03:54:34Z",
              "published_by": "SteelDragon",
              "requires": "\u003E= 3.6.7"
            }
          ]
        }
       ]
    }
  ],

That’s the best way to do it, because you cannot delete or move files yourself, and storage is conserved. Sorry Joel for giving you more work.

Perhaps also consider to remove WITD from the package names - that’s sort of already given by the context.

Consider to use Markdown to format the README section - see here.

Yours,
Christian

7

Thanks Christian and uckelman. I was able to upload version 2.2.0 under the WITD-Western Desert & Torch package.

uckelman, would you please move the 3 existing Torch releases under the Torch Campaign package and the 2 existing WITD-Western_Desert&Torch releases under the WITD-Western Desert & Torch package?

Thanks again,

Ramon

8

To make life easy (or at least easier) for @uckelman, you should

  • Create the releases you need under the packages you need
  • Specify which files should go into which releases.

In short, set up the package and releases tree

  • WITD-Western Desert, Torch & Near East
    • 3.0.0
  • WITD-Western Desert & Torch
    • 2.2.0
    • 2.1.0
    • 2.0.0
  • Torch Campaign
    • 1.1.0
    • 1.0.0
    • 0.9.0

That you can do yourself. Then specify which files goes where

You can then remove the superfluous releases from the package WITD-Western Desert, Torch & Near East

Yours,
Christian

9

Christian,

I added the releases needed under each of the packages as you specified. I was also able to add version 1.1.0 to the Torch package myself since it used the new versioning rules. I still need uckelman to move the following files from the WITD-Western Desert, Torch & Near East package to the correct package. See below:

WITD-Western_Desert&Torch_v2.1.vmod → WITD-Western Desert & Torch / 2.1.0
WITD-Western_Desert&Torch_v2.0.vmod → WITD-Western Desert & Torch / 2.0.0
Torch_v1.0.vmod → Torch Campaign / 1.0.0
Torch_v0.9.vmod → Torch Campaign / 0.9.0

Delete the Torch-1.1.0.vmod under the WITD-Western Desert, Torch & Near East package, since I was already able to add it under the Torch Campaign package myself.

Thanks for the help,
Ramon

10

I’ve moved the release files as requested. You should now be able to delete the empty releases.

11

Hello uckelman,

I have deleted the empty releases and appreciate all of the help and advice. Sorry its taken a while to get used to the new interface.

Yours, Ramon