Galaxy of Pen & Paper

Galaxy of Pen & Paper

Not enough ratings
Official Guide - Using steam workshop
By RainbowMustache
This guide helps to use, create and upload a new translation language for Galaxy of Pen and Paper.
   
Award
Favorite
Favorited
Unfavorite
Subscribing to a workshop translation
Through steam of a browser:
  • Navigating the game community page on steam, you can find the workshop items and subscribe to them.

Through the game:
  • Open settings window. You’ll see a “+” button right below “community translations”. Click it.
  • The steam overlay will open in the workshop page. You can browse and subscribe there as you would in the browser.

Steam will download the subscribed items automatically for you when you open the game. If your game is open, the translation will be download and installed automatically for you. It can take an instant or a few minutes depending of your internet connection.

  • Once the translation is installed, you can see it in the settings menu. Clicking one of the flags should translate the game.

  • If a window is not properly translated when the language is changed, try closing and reopening that window.
  • When you restart the game, the game language will be the last selected language, regardless of being a community translation or official translation.
Creating your translation
  1. Download the sheet with all game text in this link[docs.google.com]
  2. You can also use this sheet[docs.google.com] with automated translations made by google translate to help you start your own translations. Just put the language-code on the first cell (A1) on the first sheet (LANGUAGE) and in a few minutes all the sheets will be auto-translated to that language. Note that this automated translation can be very innacurate, so we recommend you to just use it as a starting point to create your own.
  3. Open the sheet in a your preferred spreadsheet software, such as Microsoft Excel or Google Spreadsheet, and create a column for your language on each sheet tab.
  4. For each line, translate the text in the column you created *;
  5. There are lots of sheets on that link. Keep an eye on each tab and translate them all.
  6. Create a folder in you computer and name it whatever you like.
  7. Export each sheet separately as a csv file, and put them all in the folder you created. You can rename each file as you like, the names of the csv files are not important.
  8. Create an image for your translation. We recommend it to be as easily recognizable as possible. For instance, we use country flags for the official translations. The image should be in png format, and it's name should be identical to the column name you created in every sheet in step 2. The image size should be 15x11 pixels.
  9. Put the image file in the same folder as your csv files.

*Important:
Do not translate or modify the text inside brakets { }. For instance, the tag {$linkerName} refers to the linker name that the player created during gameplay, and will insert that custom name in the text along with your translation.


Now your translation is ready to be uploaded!
Uploading your translation
Creation steps
  1. Open the game Galaxy of Pen & Paper and go to Settings;
  2. Click the button “Create”, right below the official supported languages.
  3. You need to fill a form with the steam workshop information.

    • Title: The title of the workshop item. This is the title of the workshop item, and should be short and direct to help subscribers to find it easily. It will be publicly visible.
    • Steam ID: You normally do not need to put anything in this field, it can be used to update your translation later if you have the item ID. Do not worry about this field, we will fill that for you once you load a previously created file.
    • Description: Describe to the community any details about your translation.
    • Changelog: What is new in this translation. It’s useful to keep track of fixes when you update your translation.
    • Folder: Here you select the folder that will be uploaded, so folder you should select is the folder you created in creating your translation step 5.
  4. If you followed every step, the game should upload your files and open the steam workshop item for you in steam browser.
  5. To make it available for all players, go into “visibility” and make it public. It can take some time for steam to actually make it available.
Observations for creation:
  • The title is mandatory for the workshop item, but description is also very important and we recommend it to be filled.
  • If you are creating a new translation, make sure you didn’t write anything by mistake in the steam ID field. The game will try to update that ID if there is anything written there.
  • You can choose to recreate some of the dialogs, but you should never change the ID column. Please, specify in the Title and Description that this translation contains dialogues different from the original content.

IMPORTANT NOTICE

When uploading a new translation, you automatically agree with the terms and conditions of the Steam Workshop and the rules specified in this document. Any content updated is in your legal responsibility.The content must not have potentially offensive language, major profanities and swearing, discriminatory language (against race, religion, sex, etc), sexual expletives. In case of any of these, the content can be excluded by us or Valve Steam without your permission or approval.

Please, read also Rules and Guidelines for Steam.
Updating your translation
  1. Go through the creating steps again, updating your translation and generating the same folder structure you did before.
  2. Open the game, go in settings and click “create”. You’ll see the same form you filled to create the item.
  3. You have 2 options for steam ID:
    • Click “Load”. A list of your created steam languages should be available for you to chose.

      When you click it, the “title”, “description” and “steam ID” fields will be filled for you.

    • You can also manually put the steam ID if you want to. You can find it at the url when you open the webpage of your workshop item.
  4. Fill again the form. If Title and Description are empty, those fields will not be updated.
  5. Fill the changelog with the recent changes to your translation, so the subscribers now what is new.
  6. Choose the folder with your updated translation.
  7. Upload it. The workshop page will be open for you. Check and update the item visibility if you like.
Getting help
If you have any questions, you can ask for help at our discord channel[discord.gg]
3 Comments
Dem 14 Oct, 2022 @ 3:03pm 
Again me, there is a problem in the skills file, the line break is not executed I try several ways:
\n
/n
<n>
<\n>
</n>
\br
/br
<br>
<\br>
</br>

none of them work yet, if anyone knows what it should look like or has any ideas on how to make it work I'll be on the lookout.
Dem 2 Oct, 2022 @ 5:40pm 
I already found the solution to the problems, the sentences that go with commas go with ("), an example:

- "This sentence has commas, right?"

For color, the format is:

<color=colorName>COLORFUL TEXT</color>

I hope it helps someone.
Dem 11 Aug, 2022 @ 8:34pm 
Hello, I have been trying to translate the game for almost 1 year and I have had some problems in the testing of the translation.

- The {color=colorName}COLOREDTEXT{/color} tags appear literally like this in the game, I've left them as they are and they still stay this way.

- How do you put commas (,) inside the dialogs??? I'm very lost on that since csv files work literally with commas (,) not semicolons (;) as usual.

That's it, the solutions I have at the moment are to replace the commas with periods (.) and just remove the text color, but it hurts to do that.