# Documentation

**URL:** https://forum.vassalengine.org/c/documentation/18.md

[Latest](https://forum.vassalengine.org/latest.md) · [Categories](https://forum.vassalengine.org/categories.md) · [Tags](https://forum.vassalengine.org/tags.md)

---

## [Documentation Index](https://forum.vassalengine.org/t/documentation-index/78944)

<div class="topic-metadata">

**Author:** [@uckelman](https://forum.vassalengine.org/u/uckelman)\
**Replies:** 0\
**Last updated:** [February 9, 2024, 8:08pm UTC](https://forum.vassalengine.org/t/documentation-index/78944 "2024-02-09T20:08:56Z")

</div>

This forum category contains documentation articles that are not covered by the guides. Links to th…

---

## [Vassal 3.7 Release Notes](https://forum.vassalengine.org/t/vassal-3-7-release-notes/78948)

<div class="topic-metadata">

**Author:** [@uckelman](https://forum.vassalengine.org/u/uckelman)\
**Replies:** 0\
**Last updated:** [February 9, 2024, 8:59pm UTC](https://forum.vassalengine.org/t/vassal-3-7-release-notes/78948 "2024-02-09T20:59:46Z")

</div>

This article will give you a quick tour of the new features in VASSAL 3.7, as well as listing some s…

---

## [How to set up a networked game](https://forum.vassalengine.org/t/how-to-set-up-a-networked-game/90005)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 23, 2026, 10:44pm UTC](https://forum.vassalengine.org/t/how-to-set-up-a-networked-game/90005 "2026-03-23T22:44:22Z")

</div>

Network game setup These are for when you want to run a game either using the central Vassal serve…

---

## [How to Run VASSAL on Android (X11)](https://forum.vassalengine.org/t/how-to-run-vassal-on-android-x11/84398)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [January 29, 2025, 12:19pm UTC](https://forum.vassalengine.org/t/how-to-run-vassal-on-android-x11/84398 "2025-01-29T12:19:14Z")

</div>

N.B.: This post is long, but mainly because the steps are thoroughly explained. The process is not…

---

## [How to set up a peer-to-peer game](https://forum.vassalengine.org/t/how-to-set-up-a-peer-to-peer-game/90004)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 2\
**Last updated:** [July 19, 2026, 1:21am UTC](https://forum.vassalengine.org/t/how-to-set-up-a-peer-to-peer-game/90004 "2026-07-19T01:21:37Z")

</div>

Peer-to-peer game setup These are instructions for running a peer-to-peer game. If you want to ru…

---

## [How to Play by EMail (PBEM)](https://forum.vassalengine.org/t/how-to-play-by-email-pbem/90008)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 25, 2026, 1:14am UTC](https://forum.vassalengine.org/t/how-to-play-by-email-pbem/90008 "2026-03-25T01:14:51Z")

</div>

Play by E-Mail (PBEM) Two players, A and B, want to play the module Battle for Moscow by means of …

---

## [Empty links and typo found in Reference Manual](https://forum.vassalengine.org/t/empty-links-and-typo-found-in-reference-manual/90469)

<div class="topic-metadata">

**Author:** [@Jim\_Hunter](https://forum.vassalengine.org/u/Jim_Hunter)\
**Replies:** 4\
**Last updated:** [September 1, 2026, 7:08pm UTC](https://forum.vassalengine.org/t/empty-links-and-typo-found-in-reference-manual/90469 "2026-09-01T19:08:20Z")

</div>

I’ve noticed for some time now that the Home → Concepts page of the Reference Manual is missing the …

---

## [Where are my user preferences stored?](https://forum.vassalengine.org/t/where-are-my-user-preferences-stored/90468)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 1\
**Last updated:** [August 28, 2026, 4:10am UTC](https://forum.vassalengine.org/t/where-are-my-user-preferences-stored/90468 "2026-08-28T04:10:33Z")

</div>

Module preferences Vassal stores user preferences - those set in File→Preferences of a module - in a…

---

## [Vassal 3.8 Release Notes](https://forum.vassalengine.org/t/vassal-3-8-release-notes/90445)

<div class="topic-metadata">

**Author:** [@uckelman](https://forum.vassalengine.org/u/uckelman)\
**Replies:** 0\
**Last updated:** [August 18, 2026, 6:57pm UTC](https://forum.vassalengine.org/t/vassal-3-8-release-notes/90445 "2026-08-18T18:57:34Z")

</div>

This article will give you a quick tour of the new features in VASSAL 3.8, as well as listing some s…

---

## [How to Integrate VASSAL into the Linux Desktop](https://forum.vassalengine.org/t/how-to-integrate-vassal-into-the-linux-desktop/84400)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 19\
**Last updated:** [August 17, 2026, 4:40am UTC](https://forum.vassalengine.org/t/how-to-integrate-vassal-into-the-linux-desktop/84400 "2026-08-17T04:40:34Z")

</div>

Introduction Most Linux desktops (Gnome, KDE, etc.) adhere to the Filesystem Hierarchy Standard (FHS…

---

## [How to format posts](https://forum.vassalengine.org/t/how-to-format-posts/85002)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [April 15, 2025, 8:41pm UTC](https://forum.vassalengine.org/t/how-to-format-posts/85002 "2025-04-15T20:41:22Z")

</div>

How to format posts The VASSAL forum supports MarkDown to format posts. MarkDown is a simple mar…

---

## [How to report problems](https://forum.vassalengine.org/t/how-to-report-problems/84989)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [April 13, 2025, 10:08pm UTC](https://forum.vassalengine.org/t/how-to-report-problems/84989 "2025-04-13T22:08:00Z")

</div>

How to report problems In the interest of most efficiently and effectively solve a problem you may…

---

## [How to debug Vassal](https://forum.vassalengine.org/t/how-to-debug-vassal/90403)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [August 10, 2026, 8:39pm UTC](https://forum.vassalengine.org/t/how-to-debug-vassal/90403 "2026-08-10T20:39:49Z")

</div>

Introduction Sometimes, Vassal may error out on some exception, or similar, and in that case, it c…

---

## [Issues whilst using VASSAL](https://forum.vassalengine.org/t/issues-whilst-using-vassal/79320)

<div class="topic-metadata">

**Author:** [@slimy](https://forum.vassalengine.org/u/slimy)\
**Replies:** 0\
**Last updated:** [March 31, 2024, 9:26pm UTC](https://forum.vassalengine.org/t/issues-whilst-using-vassal/79320 "2024-03-31T21:26:20Z")

</div>

I am getting an Exception Error, what do I do? If vassal crashes, it creates an Errorlog file and …

---

## [Creating Custom Classes](https://forum.vassalengine.org/t/creating-custom-classes/84963)

<div class="topic-metadata">

**Author:** [@marktb1961](https://forum.vassalengine.org/u/marktb1961)\
**Replies:** 0\
**Last updated:** [April 9, 2025, 7:00pm UTC](https://forum.vassalengine.org/t/creating-custom-classes/84963 "2025-04-09T19:00:04Z")

</div>

Custom VASSAL classes and elements Custom Classes allow you to override parts of VASSAL’s code to …

---

## [How to upload modules to the Game Library](https://forum.vassalengine.org/t/how-to-upload-modules-to-the-game-library/85586)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 30\
**Last updated:** [July 3, 2026, 8:15am UTC](https://forum.vassalengine.org/t/how-to-upload-modules-to-the-game-library/85586 "2026-07-03T08:15:40Z")

</div>

How to upload modules to the Game Library Service Below are some instructions and help on how to c…

---

## [Set VASSAL Look'n'Feel](https://forum.vassalengine.org/t/set-vassal-looknfeel/84865)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 17, 2025, 10:32pm UTC](https://forum.vassalengine.org/t/set-vassal-looknfeel/84865 "2025-03-17T22:32:49Z")

</div>

Changing the Look’n’Feel of VASSAL In Swing library (the Java Graphical User Interface - GUI) look…

---

## [Installation Instructions](https://forum.vassalengine.org/t/installation-instructions/85146)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [May 9, 2025, 7:11am UTC](https://forum.vassalengine.org/t/installation-instructions/85146 "2025-05-09T07:11:18Z")

</div>

Installation instructions Skip to Windows MacOS Linux Debian GNU/Linux and derivatives RedHat a…

---

## [Basic Video Demonstration for creating a project and uploading a module](https://forum.vassalengine.org/t/basic-video-demonstration-for-creating-a-project-and-uploading-a-module/90161)

<div class="topic-metadata">

**Author:** [@clanmacrae](https://forum.vassalengine.org/u/clanmacrae)\
**Replies:** 0\
**Last updated:** [May 24, 2026, 9:42pm UTC](https://forum.vassalengine.org/t/basic-video-demonstration-for-creating-a-project-and-uploading-a-module/90161 "2026-05-24T21:42:02Z")

</div>

Video link for a short demonstration on how to create a project and upload a module. https://www.yo…

---

## [Issues with Download, Installation or Running being Blocked](https://forum.vassalengine.org/t/issues-with-download-installation-or-running-being-blocked/79316)

<div class="topic-metadata">

**Author:** [@slimy](https://forum.vassalengine.org/u/slimy)\
**Replies:** 2\
**Last updated:** [March 20, 2026, 12:58pm UTC](https://forum.vassalengine.org/t/issues-with-download-installation-or-running-being-blocked/79316 "2026-03-20T12:58:22Z")

</div>

Mac not being able to verify the Developer On a Mac you may get an error: “VASSAL cannot be open…

---

## [Incomplete page in reference manual](https://forum.vassalengine.org/t/incomplete-page-in-reference-manual/90105)

<div class="topic-metadata">

**Author:** [@Pinetree](https://forum.vassalengine.org/u/Pinetree)\
**Replies:** 5\
**Last updated:** [May 2, 2026, 4:31pm UTC](https://forum.vassalengine.org/t/incomplete-page-in-reference-manual/90105 "2026-05-02T16:31:52Z")

</div>

This page is incomplete in both the online and local versions:

---

## [Tools for module developers](https://forum.vassalengine.org/t/tools-for-module-developers/84785)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 5, 2025, 10:09pm UTC](https://forum.vassalengine.org/t/tools-for-module-developers/84785 "2025-03-05T22:09:16Z")

</div>

Below are various tools that can be useful when doing module developments. Platforms Ava…

---

## [Module library disappearing from the Module Manager](https://forum.vassalengine.org/t/module-library-disappearing-from-the-module-manager/90016)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 27, 2026, 7:26am UTC](https://forum.vassalengine.org/t/module-library-disappearing-from-the-module-manager/90016 "2026-03-27T07:26:35Z")

</div>

Modules disappearing As this pull request got merged into the release branch, it means that the belo…

---

## [Other sources of modules](https://forum.vassalengine.org/t/other-sources-of-modules/86242)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [August 5, 2025, 8:31am UTC](https://forum.vassalengine.org/t/other-sources-of-modules/86242 "2025-08-05T08:31:02Z")

</div>

Other sources of modules Beside the Vassal module library there are a number of other resources o…

---

## [Module considerations](https://forum.vassalengine.org/t/module-considerations/89930)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 3\
**Last updated:** [April 7, 2026, 5:15am UTC](https://forum.vassalengine.org/t/module-considerations/89930 "2026-04-07T05:15:19Z")

</div>

This page is adapted from the old wiki page entitled Module Section Information. However, irrelevan…

---

## [How to play in Hotseat or Solitaire](https://forum.vassalengine.org/t/how-to-play-in-hotseat-or-solitaire/90015)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [March 27, 2026, 7:14am UTC](https://forum.vassalengine.org/t/how-to-play-in-hotseat-or-solitaire/90015 "2026-03-27T07:14:38Z")

</div>

Play as Hotseat or Solitaire Two players, A and B, want to play the module Battle for Moscow as ho…

---

## [Custom Terrain Recording \[incomplete\]](https://forum.vassalengine.org/t/custom-terrain-recording-incomplete/84962)

<div class="topic-metadata">

**Author:** [@marktb1961](https://forum.vassalengine.org/u/marktb1961)\
**Replies:** 2\
**Last updated:** [December 23, 2025, 11:00am UTC](https://forum.vassalengine.org/t/custom-terrain-recording-incomplete/84962 "2025-12-23T11:00:10Z")

</div>

Original article by: Brent Easton Custom Terrain Recording In this tutorial, we will add Terrain re…

---

## [Unofficial videos on using Vassal](https://forum.vassalengine.org/t/unofficial-videos-on-using-vassal/89602)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [November 10, 2025, 7:25pm UTC](https://forum.vassalengine.org/t/unofficial-videos-on-using-vassal/89602 "2025-11-10T19:25:02Z")

</div>

Various videos on using Vassal This page presents a number of videos on using Vassal in various sett…

---

## [How to convert to a module from other tools to VASSAL](https://forum.vassalengine.org/t/how-to-convert-to-a-module-from-other-tools-to-vassal/84940)

<div class="topic-metadata">

**Author:** [@cholmcc](https://forum.vassalengine.org/u/cholmcc)\
**Replies:** 0\
**Last updated:** [April 5, 2025, 4:08pm UTC](https://forum.vassalengine.org/t/how-to-convert-to-a-module-from-other-tools-to-vassal/84940 "2025-04-05T16:08:32Z")

</div>

How to convert modules from other tools Beside VASSAL, there are a number of other tools available…

---

## [How to recompress an unzipped module's files to get a valid module](https://forum.vassalengine.org/t/how-to-recompress-an-unzipped-modules-files-to-get-a-valid-module/79296)

<div class="topic-metadata">

**Author:** [@slimy](https://forum.vassalengine.org/u/slimy)\
**Replies:** 0\
**Last updated:** [March 29, 2024, 11:26pm UTC](https://forum.vassalengine.org/t/how-to-recompress-an-unzipped-modules-files-to-get-a-valid-module/79296 "2024-03-29T23:26:57Z")

</div>

Introduction A common module editing task is bulk renaming or deletion of images. To that end, edito…

[Next page](https://forum.vassalengine.org/c/documentation/18.md?page=1)
