How to select language translations


I’m trying to understand how to use language translations. I can see how to add a language, and add translations for individual buttons and whatnot. However, I don’t see how to actually get the module to use them.

Specifically, I wanted to update the Espana 1936 module, which is currently only Spanish. I thought it would be nice to add an English version. So edited the module, added some English translations to everything I could see - buttons, etc, but I’m not seeing a way to actually see them.

My Vassal preferences are definitely set to English, and I tried it in Play mode as well.

What’s the trick? Do I need to add a custom menu of some sort?

Vassal 3.5.8 on Mac (Catalina), BTW.



I believe you set your OS language setting to the language, and then restart VASSAL and it will use that language.

@Cattlesquat I already have my preferred language set to English via the Settings gui. My locale settings via the terminal are as follows:


And yet the Espana 1936 module always shows Spanish even after adding English.

Some possible clues. I noticed that if I don’t explicitly set the country for English then there’s some sort of error when you try to start it up:

2021-11-10 23:09:51,480 [96269-AWT-EventQueue-0] ERROR - '' not found in /Users/dberger/Downloads/Vassal/Modules/the_late_unpleasantness.vmod
	at VASSAL.i18n.Translation.getBundle(
	at VASSAL.i18n.Localization.translate(
	at VASSAL.launch.Player.launch(
	at VASSAL.launch.Launcher$
	at java.desktop/java.awt.event.InvocationEvent.dispatch(
	at java.desktop/java.awt.EventQueue.dispatchEventImpl(
	at java.desktop/java.awt.EventQueue$
	at java.desktop/java.awt.EventQueue$
	at java.base/
	at java.base/$JavaSecurityAccessImpl.doIntersectionPrivilege(
	at java.desktop/java.awt.EventQueue.dispatchEvent(
	at java.desktop/java.awt.EventDispatchThread.pumpOneEventForFilters(
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForFilter(
	at java.desktop/java.awt.EventDispatchThread.pumpEventsForHierarchy(
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(
	at java.desktop/java.awt.EventDispatchThread.pumpEvents(
	at java.desktop/

But, even if I select a country, e.g. United States, I still see these warnings in the log:

2021-11-10 23:10:43,467 [96275-AWT-EventQueue-0] INFO - The Late Unpleasantness version 1.0
2021-11-10 23:10:43,488 [96275-AWT-EventQueue-0] WARN  VASSAL.i18n.BundleHelper - No Translation: Wizard.Next_mnemonic
2021-11-10 23:10:43,488 [96275-AWT-EventQueue-0] WARN  VASSAL.i18n.BundleHelper - No Translation: Wizard.Prev_mnemonic
2021-11-10 23:10:43,488 [96275-AWT-EventQueue-0] WARN  VASSAL.i18n.BundleHelper - No Translation: Wizard.Finish_mnemonic
2021-11-10 23:10:43,488 [96275-AWT-EventQueue-0] WARN  VASSAL.i18n.BundleHelper - No Translation: Wizard.Cancel_mnemonic

Relevant? Not sure.

I dug a bit on that warning:

>zipgrep "Next_mnemonic" wizard-0.998.1.jar      
org/netbeans/api/wizard/displayer/NavButtonManager.class:Binary file (standard input) matches

I don’t really know what that file does, though it’s curious that there’s no English or Spanish there. Relevant? Again, I don’t know.



Those errors you see aren’t really relevant.

First thing is that translations are never active when you are editing the module. A module is only ever translated when you ‘Open’ it to play it, not when you ‘Edit’ it.

Otherwise doing as you describe should work, it works for me. I edited the Espana module, added an English translation, translated the Retire button and saved the module. When I then play the module, I now see Retire instead of Retirarse.


Ok, I started from scratch this morning and…now it works?

The only thing I did differently was click the little arrow between the original text and the translation. Could that have triggered something? Otherwise, I’m at a loss as to why it didn’t work before.

Sorry for the noise, folks.


In my case the problem appears with the translated images of the buttons. At the beginning all the buttons appear correctly translated but, once I click on any of them, all the buttons change to the original buttons in Spanish…
I have reported this issue a long time ago but so far nobody has found a solution
Thank you in advance.

@hector.caraballo Yes, I’m now noticing the same thing, though it seems to depend on which window. So far, it’s only happening on the game piece window. The other windows seem to be ok.

I’ll keep tinkering with it, and see how it goes.