Localizing jME 3 Games
Localizing an application can mean several things:
At minimum you translate all messages and dialogs in the user interface to your target languages.
You should also translate the “read me”, help, and other documentation.
Also translating web content related to the application makes sure international users find out about your localized game.
If you go the whole way of internationalization, you also “translate” metaphors in icons or symbols used.
E.g. For localizations to right-to-left languages, you must also adjust the whole flow of the UI (order of menus and buttons).
There are tools that assist you with localizing Java Swing GUIs. jME3 applications do not typically have a Swing GUI, so those tools are not of much help. Just stick to the normal Java rules about using Bundle Properties:
Preparing the Localization
The jMonkeyEngine SDK supports opening and editing Bundle.properties files. Also note the Tools > Localization menu.
To prepare the application for localization, you have to first identify all hard-coded messages.
Find every line in your jME3 game where you hard-coded message strings, e.g.
System.out.print("Hello World!"); UiText.setText("Score: " + score);
Create one file named
Bundle.propertiesin each directory where there are Java file that contain messages.
For every hard-coded message, you add one line to the
Bundle.propertiesfile: First specify a unique key that identifies this string; then an equal sign; and the literal string itself.
greeting=Hello World! score.display=Score:
In the source code, replace every occurrence of a hard-coded message with the appropriate Resource Bundle call to its unique key:
System.out.print(ResourceBundle.getBundle("Bundle").getString("greeting")); UiText.setText(ResourceBundle.getBundle("Bundle").getString("score.display") + score);
The language used in the Bundle.properties files will be the default language for your game.
Translating the Messages
Each additional language comes in a set of files that is marked with a (usually) two-letter suffix. Common locales are de for German, en for English, fr for French, ja for Japanese, pt for Portuguese, etc.
To translate the messages to another language, for example, German:
Make a copy of the
Name the copy
Bundle_de.propertiesfor German. Note the added suffix _de.
Translate all strings (text on the right side of the equal sign) in the
greeting=Hallo Welt! score.display=Spielstand:
Do not modify any of the keys (text to the left of the equal sign)!
To test the German localization, start the application from the command line with
-Duser.language=de. Note the parameter
In the jMonkeyEngine SDK, you set this VM Option in the Project properties under Run. Here you can also save individual run configurations for each language you want to test.
To get the full list of language suffixes use
Which Strings Not to Translate
In the Bundle.properties file, do not include any strings that are asset paths, node or geometry names, input mappings, or material layers.
Keep material layers:
teapot = assetManager.loadModel("Models/Teapot/Teapot.obj");
Keep geometry and node names:
Geometry thing=new Geometry("A thing", mesh); Node vehicle = new Node("Vehicle");
inputManager.addMapping("Shoot", trigger); inputManager.addListener(actionListener, "Shoot");
Only localize messages and UI text!
Common Localization Problems
Typical problems include:
Localized strings will be of vastly different lengths and will totally break your UI layout. ⇒ Test every localization.
Strings with variable text or numbers don’t work the same in different languages. ⇒ Either work in grammatical cases/numbers/gender for each language, or use gettext or ICU4J.
The localizer only sees the strings, without any context. E.g. does “Search History” mean “display” the history of searches, or “search” through the history? ⇒ Use clear key labels. Work closely with the localizers if they require extra info, and add that info as comments to the translation file.
Broken international characters ⇒ Make sure the files are saved with the same character encoding as the font file(s) you’re using. Nowadays, that usually means UTF-8 since font files tend to come for Unicode.
Missing international characters ⇒ Make sure that there’s a glyph for every needed character in your font, either by using more complete font files or by having the translation changed.