Skip to content

realitymod/pr-localization

Repository files navigation

Project Reality: BF2 Community Localization

https://github.com/realitymod/pr-localization

This repository is for openly maintaining the Project Reality: BF2 localization files for all the different languages.

For community contributions, please make a make a fork and submit a pull request.

Editing guide

We recommend contributors use Notepad++ to edit the .utxt files.

Example

It is helpful to have View > Show Symbol > Show White Space and TAB enabled in Notepad++.

Testing translations

First, run check-localization.exe which will check for some common mistakes made in localization files. Fix any errors it detects, otherwise continue to testing ingame.

To test your changes in the current version of PR:BF2, just edit the necessary files located in:

<PR Install Dir>/mods/pr/localization/<language>

Please make sure you have tested your changes both in the launcher and ingame, and have confirmed they are working correctly prior to submitting a pull request!

If there are characters missing, or your text does not display, it is most likely an issue with the font used. See below for more information regarding custom fonts.

Note: Change the language used in PRLauncher > Options > Global > Language

What not to translate

In pr.utxt:

  • HUD_TEAMNAME_ENGLISH_* should not be translated.
  • HUD_TEXT_MENU_REINFORCEMENTS should not be translated.
  • HUD_TEXT_MENU_CACHES should not be translated.
  • HUD_TEXT_MENU_ENEMY_ASSETS should not be translated.
  • HUD_TEXT_MENU_ASSETS_* should not be translated.

In prmaps.utxt:

  • HUD_LEVELNAME_* should not be translated.
  • cpname_* should not be translated.
  • This means that the only strings that should be translated are GAMEMODE_DESCRIPTION_.

prvehicles.utxt should not be translated at all, as it is an automatically generated file.

Handling updates

When a new string is added in English, it will automatically be committed to the rest of the languages in English. The contributor then translates from English to their chosen language.

If an English string is modified, it will not be updated in the other languages. It is up to the contributor to stay up to date with changes made to English to ensure they don't become out of date.

If translation starts on a currently un-translated language, it is recommended to start with the English files instead of existing translations, as they may be out of date because to the above paragraph.

Custom fonts

If you require custom font support, please make a new thread in the PR:BF2 Community Modding forum and we will guide you on what is required for your fonts to be supported in the launcher and/or ingame. You can also try for yourself with the second part of this tutorial on how to make BF2 Fonts.

Contributors