A
1
Please make sure to read and follow all the steps in these incstructions properly. Important information can easily be missed otherwise.
2
These instructions are also available in form of a google doc, which is easier to scroll through. Click Here!
3
4
Contents
5
Initial Setup
6
Making a Translation
7
Variables (Don't touch these!)
8
Translation Symbols (How the Code Will Interpret Text)
9
Downloading the Language File and Making a Mod
10
Updating the Language File
11
Types of Changes when Updating, and How to Treat Them
12
Setting Up the Quick Search Macro
13
Updating the Sheet
14
Import Older Translation
15
Steam Workshop Images
16
17
Initial Setup
18
19
1) Create a copy of this spreadsheet through File -> Make a Copy.
20
21
2) In Death Trash, open the console with Shift + F10, and select Modding: Setup For Creating And Using Mods. Available console commands will appear once you start typing.
22
23
3) Death Trash will create a Mods folder and export some game data into it. It should then open this Mods folder.
24
25
4) In the Mods folder, navigate to the subdirectory ExportedGameData and then deeper into LanguageData. There should be a file called newLanguage.tsv.
26
27
5) Open your copy of the Localization Tool from step 1) and click on File->Import.
28
29
6) Select Upload and drag & drop newLanguage.tsv into the window.
30
31
7) After the file is uploaded, an import window is opened. Change the import location to Insert new sheet(s), set the Separator type to Tab and remove the mark from the Convert text to numbers, dates and formulas checkbox. When you're done, click on Import data.
32
33
8) Run Localization -> Detect Sheets.
34
35
8.2) At this point Google Sheets will probably ask for the permissions for the script to change data in the sheet. The script only requires access to the sheet itself, and the permission you give should reflect that. If you are ok with this, click Allow, and run step 8) again
36
37
9) When a message box appears asking you to initialize your uploaded sheet as work sheet, select Yes.
38
39
10) Your spreadsheet should now look like the image below. If so, then you're now all set up and ready to start translating.
40
41
42
43
Making a Translation
44
45
Summary:
46
Basically: Column A contains an ID, Column B contains the original, english text, Column C is for the translated text, Column D is empty, and there to keep some visual distance to the next three columns. Column E is for comments. Column F is to mark completion of a translation, and Column G contains change notes after merging and updating. If you change the order of columns, things will get messy when merging/updating/downloading, so please leave it, as it is.
47
Detailed Explanation:
48
Translating is very straight forward. Column B contains all the english terms used in the game. Write your translation of them into column C, then mark the checkbox in column F. Don't worry if during your first translation, the box is already checked. It will be unchecked once you update the language file, when changes to the original text are detected.
49
50
You can use Column E for comments, or for messages to collaborators, if you're not working on a translation alone.
51
52
Feel free to change formatting and cell sizes to fit your preferences.
53
54
Press Ctrl + Shift + Alt + 0 to jump to the next unfinished entry. If this doesn't work, read the chapter on how to set up the Macro.
55
56
57
58
Variables (Don't touch these!)
59
60
SEQUENCE (name of the sequence)
61
Marks the beginning of things like quests or dialogues.
62
63
ASSET (asset id) + Name: (asset name)
64
Unique texts found throughout the world. Can be items, abilities, description texts, etc. Do not change the asset id or the asset name. If you want to rename the asset, it should have a #_localizedName entry for this.
65
66
Translation Symbols (How the Code Will Interpret Text)
67
68
[text between square brackets]
69
These are dialogue items which will be displayed differently to the player. Translate their contents, but leave the brackets. As an example, [Leave] becomes:
70
71
72
||
73
Two vertical lines. Not lowercase 'L', nor uppercase 'i'. These are line breaks.
74
75
**variable name**
76
Words with two *-symbols on each side are considered variables, and will be replaced. E.g. **forename** will be replaced with a characters name.
77
78
<text id> or <code>
79
If a text id is between angled brackets, it will be looked up in the text manager of the game (the first block of text, without a SEQUENCE or ASSET name), and replaced with the entry there. In special cases, angled brackets also contain formatting code for text. But in all cases, it's code, and the content should not be translated.
80
81
{number} or [number]
82
These mark variables which can change depending on context.
83
84
85
Downloading the Language File and Making a Mod
86
87
1) Make sure, that the Language ID is changed to the language you have translated to. It should probably look like something from this list.
88
89
2) Go to the control sheet, and make sure, that the name of the sheet matches the field marked work sheet. Correct if necessary.
90
91
3) If everything is ready, click on the link at the bottom, which says Click This to initiate the download. Sometimes the download link doesn't work right, and says that either the file is gone, or it's downloading the wrong sheet. In this case, delete the entries for work sheet and update sheet in Control, and run Localization -> Detect Sheets again. Or type their names in manually. Just make sure, that the cells are empty before, and the download link says Missing Work Sheet, before you type it in.
92
93
4) If you have not yet done so, open the console in Death Trash with Shift + F10, and select Modding: Setup For Creating And Using Mods. Otherwise select Modding: Show Mods Directory. Available console commands will appear once you start typing.
94
95
5) If you're newly creating the mods, Death Trash will create a Mods folder and export some game data into it. It should then open this Mods folder.
96
97
6) Copy the folder called ExampleMod, and rename it to how you want your mod to be called.
98
99
6) Copy and paste the file you downloaded in step 3) into your mod folder.
100