Skip to content

BestPracticeForTyranoEN

Jump to bottom
neavo edited this page Nov 6, 2026 · 5 revisions

🎯 What You Will Do

Translate a Tyrano engine game and embed the translation into the game. After that, the game runs without any translation tool.

flowchart LR
  A(["Copy the game"]) --> B("Create a project")
  B --> C("Translate with AGENT")
  C --> D("Generate Translation")
  D --> E(["Copy back into the game"])
Loading

🧰 Before You Start

  • You completed the [Basic Tutorial] one time
  • A clean copy of the game: not translated
  • Games made with TyranoScript and TyranoBuilder are supported. Both .exe games with an app.asar archive and game folders with loose resources can be used directly

⚠️ We recommend that you make a full copy of the game folder and work on the copy

⚠️ Games with built-in language switching (language tables in data/others/lang/) are not supported. An .exe that only loads a verified archive is not supported

🚀 Steps

1. Create a Project

  1. Open AGENT and click Create Project
  2. Drag the game folder or .exe into the dialog
  3. Click Create Project, confirm the Project Languages, and select where to save the .lg project file

The app identifies the resources/app.asar archive or the loose data and tyrano folders automatically. Do not select an archive or a .ks script file directly.

✅ Result: for games with an archive, resources/app.asar is extracted into the resources/app folder. For games with loose resources, the folder does not change

⚠️ Before the project is created, the app asks you to back up the game folder. The app changes the game files only after you confirm

💡 After extraction, the game reads the files in resources/app directly. You can start the game one time to make sure that it still runs correctly

💡 If the app says that an update patch is pending, start the original game one time, then create the project again

2. Translate with AGENT

After the project is created, the app opens AGENT with these steps already in the input box. Press Enter:

Step Instruction Purpose
① Extract terminology Keeps character, place, and item names consistent
② Translate the full text Translates the game text
③ Review the translation Finds errors and code problems

💡 AGENT loads the tyrano skill automatically and processes text by the engine rules. No extra setup is necessary

💡 After terminology extraction, check the character names and genders

💡 The character names above the dialog box are often linked to character images and voices, so they are not translated by default. To translate them, tell AGENT: Help me translate the character names and update every place that refers to them

3. Generate and Embed the Translation

  1. Click Generate Translation
  2. Open the {project name}_Translated/{game folder name}/ folder
  3. Copy all of its contents into the game folder and overwrite files with the same names
  4. Start the game

✅ Result: the game shows the translation and runs correctly

🔤 Extra Step: Change the Font

  1. Prepare the font. For Chinese, download [LGBaseFont_20261029.zip] and extract LGBaseFont.ttf. For other languages, use your own .ttf font
  2. Open Toolbox - Modify Game Font
  3. Drag in the game folder or .exe, then the font file, and click Modify
  4. Start the game

✅ Result: the game shows the translation with the new font

💡 LGBaseFont is a Chinese font. It contains only English and CJK characters. For other target languages, find a .ttf font that supports your language

💡 Only the font of the dialog box, text layers, and choice buttons changes. Text in images and text that plugins draw themselves do not change

💡 Changing the font and generating the translation do not affect each other. You can do them in any order

🔧 Troubleshooting

For any problem that you see in the game, give AGENT a screenshot:

Problem What to say
Text is not translated This UI text is not translated, here is the screenshot, find it and translate it
The game shows an error or a function stops working The game shows an error, here is the screenshot, help me find the translations that cause it
Text shows as boxes The text in the game shows as boxes, here is the screenshot, how do I fix it

After AGENT corrects the problem, do step 3 again. You do not need to change the font again.

💡 In Tyrano games, character names, voices, and macro parameters can refer to each other. Some translated text can cause character images or voices to stop showing or playing, or branches to stop working. You can also give AGENT a screenshot of these problems

💡 Text that shows as boxes usually means that the game font does not support the target language. Do the extra step

💡 To restore the original game, copy your backup of the game folder back over it

❓ FAQ

How do I know if a game is Tyrano?

  • An .exe game folder usually has resources/app.asar, or resources/app has the data and tyrano folders
  • A web or loose game folder has the data and tyrano folders directly
  • Drag the game folder into the Create Project dialog. If the app identifies it, it is Tyrano
  • You can also give AGENT a screenshot of the game folder: This is the game folder, tell me which engine it uses and which tutorial to read

The game has more than one language. Can it be translated?

  • Not at this time. These games find their language tables by the original text, so language switching stops working after the original text changes

Which content is not translated?

  • Text in images, and text that Canvas or plugins draw themselves
  • Files outside the data folder, and text that the game builds from variables when it runs

Does the translated game still need LinguaGacha?

  • No. The translation is written into the game files

📚 Related Tutorials

Clone this wiki locally