Step 2: translating the game

As announced on the jam page, the game to translate is Intergalactic Wizard Force by Powerhoof

Feel free to play it at the top of the page in order to familiarize with it

Then scroll to the bottom of the page in order to reach the Translation kit button

Download the -IWF-Web.zip file and extract it inside a folder of your computer. You will see the following files

If you have Microsoft Excel installed in your system, simply double click on the translation.csv file in order to access the game text.

If you don't have MS Excel on your system, download and install the free alternative LibreOffice.

Column E contains the original English text. Use it for reference while translating and revising but you shouldn't really change it

Column F is where you will typeyou translation. Feel free to replace the "Translated" header with the name of your language for it to display in the main menu.

When saving, Excel will ask you if you want to replace the current file format. Always maintain the original format or the text might become corrupt and unreadable

Do not rename the translation.csv file or move it into another folder or the game will no longer be able to load it.

*********

If you inadvertently saved in the wrong format, due to Excel’s numerous warning messages, download the translation kit again and follow the steps below when saving

Excel 2007:
-When closing the file or Excel, a warning message will display “Do you want to save changes to translation.csv?” Click Yes
-When saving, Excel will display a warning message saying “translation.csv may contain features that are not compatible with Unicode Text. Do you want to keep workbook in this format? To keep this format, which leaves out any incompatible features, click Yes” Click Yes
The same happens if you use “Save” while translating, just click yes. Never use “Save as” and never change file format

Excel 2013:
-Always save manually (Ctrl+S). Never use “Save as” and never change file format
-When saving, Excel will display a warning message saying “Some features in your workbook might be lost if you save it as Unicode Text. Do you want to keep using that format?” Click Yes
-When closing the file or Excel, a warning message will display “Do you want to save your changes to translation.csv?” Always click Don’t save

*********

For advanced users:

If you want to go beyond simple translation and change the very structure of the game, download the Unity source code. These are the instructions (also included in the zipfile)

OPENING THE PROJECT IN UNITY

- Use unity version 2020.3
- Download it from here https://unity3d.com/unity/qa/lts-releases
- Unzip the source folder, and open as a project in unity 2020.3

- The game was created with PowerQuest, so when testing and editing the game, you should open the PowerQuest window.
- Open the interface by clicking "Window -> PowerQuest"
- More information on powerquest is here: http://powerquest.powerhoof.com

TESTING THE GAME IN UNITY
- From the PowerQuest window, in the list of "Rooms", find the "Space" entry, and click the "Scene" button
- Press unity's "play" in unity and it should play from the start of the game. You can also start testing from other 'rooms' by opening their scenes.  

TO MAKE A BUILD

- Click File->Build Settings...
- There you can change which platform you wish to build for, and make a build.
- Refer to Unity's documentation for more information

TO CHANGE VOICE OVER

- Replace files in the "Assets\Audio\Resources\Voice" directory with your own
- Each filename has the character name, and line ID, that match the ones in the CSV
- The script is 663 lines split among two protagonists (220 lines each) and 6 NPC (50 lines at most)

TO CHANGE TITLE MUSIC

- A version of the theme song with no vocals is included in the zip

- To replace the song in-game, copy the iwf_title.mp3 file over the one in Assets\Audio\Music\ and build the project.

- Lyrics:

    Wizard Force
    Wizard Force
    Intergalactic Wizard Force 

    Keeping order throughout the galaxy
    Beyond where crystal balls can see
    On missions of stellar gravity
    Facilitating magic bureaucracy

    Intergalactic Wizard Force
    Intergalactic Wizard Force