Solasta Unofficial Translation

• This Mod allows additional text translations to be easily added to the Solasta cRPG game.
• I expect the community to step in, work as a team, and provide better translations files than the ones I got from Google API.
• Current translations
  • Brazilian Portuguese (pt-BR)
  • Spanish (es)
  • Italian (it)
• You need Unity Mod Manager 0.23.4 or higher installed in your game folder.

How to export official languages

1. Press Ctrl-F10 to Open UMM Window
2. Expand Solasta Unofficial Translation options
3. Press the Export #Language# button (text files are exported to Mods/SolastaUnofficialTranslations/Export-#code#)

How to fix bad translations

1. ALWAYS KEEP A TAB OF YOUR CORRECTIONS!!!

   • The translation process is fully automated to support future game versions
     1. Uses Google API to translate all 17,000+ game terms beforehand using the Python script
     2. Mod reads a Corrections file with FIXES COMMUNITY WILL SHARE WITH ME

   Correction Files

   • stored as $SOLASTA_HOME/Mods/SolastaUnofficialTranslations/Corrections-#LANGUAGE-CODE#.txt
   • corrections are case sensitive
   • corrections are applied to all terms
   • corrections are TAB separated
   • check Corrections-PT.txt as a guide

How to create new translations

• Install Python 3.*
• Install Python deep_translator library
  • pip3 install deep_translator
• Export EN official language
• Run batch translator
  • py Scripts\translate.py $SOLASTA_HOME/Mods/SolastaUnofficialTranslations/Export-en -c LANGUAGE_CODE

How to compile

1. Download and install Unity Mod Manager (UMM)
2. Execute UMM, Select Solasta, and Install
3. Download and install SolastaModApi using UMM
4. Create the environment variable SolastaInstallDir and point it to your Solasta game home folder
   • tip: search for "edit the system environment variables" on windows search bar
5. Use "Install Release" or "Install Debug" to have the Mod installed directly to your Game Mods folder

Unity Mod Manager and this mod template make use of Harmony

How to debug

1. Open Solasta game folder
   • Rename Solasta.exe to Solasta.exe.original
   • Rename UnityPlayer.dll to UnityPlayer.dll.original
   • Add below entries to Solasta_Data\boot.config:

      wait-for-managed-debugger=1
      player-connection-debug=1
     

2. Download and install 7zip
3. Download Unity Editor 2019.4.19
4. Open Downloads folder
   • Right-click UnitySetup64-2019.4.1f1.exe, 7Zip -> Extract Here
   • Navigate to Editor\Data\PlaybackEngines\windowsstandalonesupport\Variations\win64_development_mono
     • Copy UnityPlayer.dll and WinPixEventRuntime.dll to clipboard
   • Navigate to the Solasta game folder
     • Rename UnityPlayer.dll to UnityPlayer.dll.original
     • Paste UnityPlayer.dll and WinPixEventRuntime.dll from clipboard
5. You can now attach the Unity Debugger from Visual Studio 2019, Debug -> Attach Unity Debug