Switching to the New Module Library

The Module Library is changing!

We’re switching from the current module library to the new module library soon. This post is to explain the switchover plan and what you can expect from the new module library.

Plan for the switch

  • 18 May: the wiki will become read-only and the new module library will become available
  • 25 May: the new module library will become editable
  • 1 June: the wiki will be archived as static pages
  • In 6 months: the wiki archive will be removed

Differences between the old and new Module Libraries

The old module library has been hosted in our wiki since 2010, when it replaced the old, old module library which had been in a CMS. The old, old module library was inflexible and roundly disliked. We sought to remedy that by using a wiki for its replacement, which went too far in the opposite direction: A major drawback of the old module library has been that the formatting is merely advisory, which makes any procedural handling of the data in it infeasible. The new module library provides more structure. Common items like game titles, names of maintainers of modules, and lists of players are in uniform locations across pages, but the “readme” section remains freeform. We hope this strikes an appropriate balance.

Pages in the old module library are per game; pages in the new module library are per project. In the old module library, every module for a particular game appears on one page. This has historically led to confusion and contention when there are multiple competing modules for a game. The new module library has one page per project, so that competing modules for the same game may have their own pages.

Users in the old module library were listed by some name and maybe a link to their email address, if they had any contact information at all. This made it hard to contact module maintainers or people in the players lists. Users in the new module library are denoted by their forum avatar, forum username, and a link to their forum profile. This should make contacting users simpler and more reliable.

In the old module library, modules with frequent releases either had obnoxiously long release lists or removed older releases from their pages, neither of which are desirable. The new module library hides releases in each package which are older than the current one behind an accordion, which can be expanded if desired. This displays the current release prominently while keeping older releases available with an additional click.

The old module library, due to being a wiki, has no notion of page ownership. Because anyone with an account can edit pages in the old module library, we needed a moderation system, which Tim McCarron has diligently tended for 15 years. It’s been a lot of work, and we all owe Tim our thanks for his dedication to keeping module pages in order. Pages in the new module library have owners, which means that not just any rando who wanders in can edit them. Because only page owners can edit their pages and there is a fixed structure, it’s no longer necessary to vet page edits. Moderation in the new module library is modeled after moderation here in the forum: There is a Flag button which anyone logged in can use to report a problem.

More specific details about the new module library will follow in a few days. Thank you, everyone, for your patience while we make the switch.

11 Likes

Hrm, I co-edit a couple of different modules along with another person. e.g. the original developer created the page for the module, I updated the module to a new version adding some features and then updated the page. How is that going to work in the new module library? Will there be some kind of edit permission that can be shared?

Projects in the new module library have owners. Existing owners of a project can add and remove users from the owners list for that project. It sounds like one of the project owners should add you as another owner.

Presumably (in hope), any pending wiki page module updates, will be moderated once the wiki goes read-only ?

Band of brothers ghost panzer and Band of Brothers Texas Arrows module pages should probably be removed. The only module currently maintained and “official” is Band of Bothers. It includes all games. Those pages do not seem to contain any module, in fact. g

Yes, I’ll work through whatever is left in the moderation queue.

1 Like

The old module library (and the rest of the wiki) are now read-only. It will not be possible to edit module pages for the next week, while we complete conversion of all the module page data to the new module library.

I think I’m understanding this…so if a project owner goes incommunicado, the only option is to fork to a new project? Relevant to me since I’ve just started bringing some old modules up to the current game standards and the old module developers are no longer in contact.

Forking is the solution that the software wold has settled on. It seems to work, and avoids needing someone to make judgments in an admin capacity.

3 Likes

The swtichover is taking a bit longer than I expected; the new library won’t become editable today. I do still expect to complete the work in the next few days.

There is now a read-only version of the new module library at https://vassalengine.org/library/projects.

Is this “final”, or are you still fixing things? I ask because Terraforming Mars has multiple Packages but no actual module files at the moment…

There will be a list of module pages where the maintainers of those pages will need to sort the pages out because I cannot. Terraforming Mars is one of those.

1 Like

Looks good. Looking forward to being able to upload my next module.

I’ve switched all the site links for the library to point to the new library. Note that the new library is not yet editable; expect that tomorrow.

For reference the old library is here: Category:Modules - Vassal

1 Like

Here is the promised list of problem pages.

These need attention from their maintainers to convert them from the old module library:

  • Dungeons & Dragons Miniatures
  • A Game of Thrones: The Board Game (Second Edition)
  • Malifaux
  • Napoleon’s Last Battles
  • Twilight Sparkle’s Secret Shipfic Folder
  • World in Flames

These host multiple distinct modules and need splitting into two or more projects for the new library:

  • Afrika Korps
  • Age of Sail
  • Arkham Horror
  • Assault of the Dead: Tactics
  • Au fil de l’epee
  • Battle for Moscow
  • BattleLore (Second Edition)
  • Battles for the Ardennes
  • Battle: The Game of Generals
  • Betrayal At House On The Hill
  • Bitter Woods (4th Edition)
  • Blitzkrieg
  • Breakout Normandy
  • Caesar: Epic Battle of Alesia
  • Caesar in Alexandria
  • Codex: Card-Time Strategy
  • Combat!
  • D-Day
  • Downtown: Air War Over Hanoi, 1965 - 1972
  • Dreamblade
  • Drive on Washington: The Battle of Monocacy Junction, July 9, 1864
  • Dune
  • El Alamein: Battles in North Africa, 1942
  • Empires of the Middle Ages
  • Fighting Sail
  • Fortress Europa
  • Gettysburg: 125th Anniversary Edition
  • Great Battles of Alexander: Deluxe Edition
  • Hannibal: Rome vs. Carthage
  • Imperium
  • Kingmaker
  • L’Art de la Guerre
  • Marine Fighter Squadron: A Solitaire Game of Aerial Combat in the Solomons (1942-1945)
  • MechWar '77: Tactical Armored Combat in the 1970’s
  • Napoleon at Waterloo
  • NFL Strategy
  • No Retreat!
  • PanzerArmee Afrika: Rommel in the Desert, April 1941 - November 1942
  • Platoon Commander Deluxe: The Battle of Kursk
  • Red Storm: The Air War Over Central Germany, 1987
  • Richthofen’s War
  • Rise and Decline of the Third Reich
  • Rommel (2017)
  • Russia Besieged
  • Scorched Earth
  • Silent War + IJN (Second Edition)
  • Sleuth
  • Snapshot
  • Source of the Nile
  • Sphactérie -425
  • S.P.Q.R. Deluxe
  • Stalingrad
  • Starship Troopers
  • Star Wars: Imperial Assault
  • Statis Pro Baseball
  • Stellar Conquest
  • Terraforming Mars
  • The Arab-Israeli Wars
  • The Civil War
  • The Drive on Metz, 1944
  • The Guns of August
  • The Republic of Rome
  • The Russian Campaign
  • The Succession Wars
  • Up Front
  • Vietnam 1965-1975
  • War and Peace
  • Western Front Ace: The Great Air War 1916-1918

If you’re the maintainer of one of these modules and you’re unsure what needs doing, please ask.

The “Knight” icon at the top of the forums page is still pointing to the old wiki URL (it’s correct on the home page)…

And now it’s correct. Either you fixed it really fast, or it was a caching problem on my end.

Will the “recent changes” search function still be available? That was a daily visit for me.

Select “Recent updates” as the sort order: Module Library - Vassal