How to Add Unsupported Language

Thank you for your initiative to contribute a translation for an unsupported language! While the application does not officially support this language, you can use a workaround to integrate it effectively.

Officially Supported Languages

Below is a list of officially supported languages. Unsupported languages require workarounds to function.

• Chinese (Simplified)
• Chinese (Traditional)
• English
• French (France)
• German (Germany)
• Italian (Italy)
• Japanese (Japan)
• Korean (South Korea)
• Polish (Poland)
• Portuguese (Brazil)
• Spanish (Latin America)
• Spanish (Spain)

For more information, see Spectrum->Star Citizen Community Localization Update.

---

Workaround for Adding an Unsupported Language

If your desired language is not listed above, directly adding it to the configuration will not work because the application defaults to English for unsupported localizations.

Instead, you can modify an existing supported language folder and configuration as follows:

Steps:

1. Choose a Similar Supported Language:
   Identify a supported language that closely resembles the unsupported language (e.g., use portuguese_(brazil) for portuguese_(portugal)).

2. Add the Translation Files:
   Place your translation files (e.g., global.ini) for the unsupported language into the folder of the chosen supported language in the application's localization directory (e.g., \data\Localization\portuguese_(brazil)).

3. Update Configuration:
   Modify the configuration file (e.g., user.cfg) to point to the supported language folder:

   g_language = portuguese_(brazil)
   

4. Test the Implementation:
   Launch the application and verify that your translations appear correctly.

---

Recommendations

• Documentation:
  Provide users with clear instructions for enabling the unsupported language using the workaround.

• Automation:
  Update installation or deployment scripts to:

  • Copy the unsupported language files into the appropriate supported language folder.
  • Automatically configure the user.cfg file.

• Pull Requests:
  To contribute to the official repository, create a pull request including:

  • A folder for your unsupported language (e.g., portuguese_(portugal)) in the localization directory.
  • A global.ini file with your translations.

---

If you have further questions or need additional help, feel free to ask or create an issue in the repository!