🚀 Ultra Ren'Py Translator v0.06 — Full Release Report

📋 Executive Summary

This update is massive. Since v0.02 we've completely rewritten the Ren'Py translation engine, added a full Unity game translator module, integrated and then discarded an offline translation engine, and polished the UI to a professional level. Here's the full breakdown.

✨ NEW FEATURES (v0.03 → v0.06)

🎮 1. Unity Module — Complete Unity Game Translator

[BUILT FROM SCRATCH] — A fully integrated Unity game translator built right into the tool. Not a separate plugin: it's a complete tab inside Ultra Translator.

FeatureDescriptionOne-Click BepInEx + XUnity InstallSingle click installs the BepInEx modding framework (v5.4 for Mono, v6.0 for IL2CPP) and XUnity AutoTranslator v5.5.2Auto Mono/IL2CPP DetectionAutomatically detects Unity game type by analyzing GameAssembly.dll vs Managed/One-Click Full TranslationButton that runs 7 automated phases: install → extract DLLs → extract assets → read dumps → filter → translate → configure.NET String ExtractionBinary parser that reads the #US heap (User Strings) from .NET assemblies to extract ALL string literals from the game codeUnity Asset Extraction4 combined methods: UnityPy (TextAsset/MonoBehaviour), direct binary scan, loose data files (JSON/CSV/TXT), and embedded JSON in assetsHybrid Mode (Online + Offline)Configures XUnity to use pre-generated translations instantly, with live Google Translate fallback for uncaptured textsAnti-Rate-Limit Wave SystemConcurrency semaphore + progressive waves with intelligent cooldown (60s between rounds when Google blocks)"Stop Translation" ButtonControl to abort long Unity translations without crashing the appClean UninstallRemoves BepInEx/, winhttp.dll, doorstop_config.ini and changelog.txtRun GameLaunch the game directly from the tool

🔀 2. Translate from TL (Bridge Mode)

[NEW] — Allows translating a game using existing translations from another language as a base.

• Example: If a game has an English translation in tl/english/, you can use those files as source and translate them to Spanish

• Replaces translate identifiers to create an isolated language (XX_ultra)

• Preserves the original file structure and translate blocks

• Ideal for Japanese games that already have fan-made English translations
  

🔐 3. Native Ren'Py Hash System

[COMPLETELY REWRITTEN] — The dialogue translation engine now generates files in the exact format used by Ren'Py internally.

Aspectv0.02v0.06Dialogue translation methodtranslate strings only (old/new)Native translate <lang> <label>_<hash>: blocks + old/new as safety netIdentification hashDidn't existMD5 computed with encode_say_string() replicating the Ren'Py lexerRen'Py 8+ compatibilityPartialComplete — relative paths fixedNative stub detectionNoYes — launches the game to generate real engine hashesDialogue file1 file (strings)2 files: renpy_diccionario_global.rpy (UI strings) + renpy_diccionario_dialogos.rpy (hashed dialogues)

⚡ 4. Google (ULTRA) 🚀 Engine

[NEW] — Third speed tier added to the translation engine.

EngineThreadsBatch SizeDelayGoogle (ULTRA) 🚀15 threads4,800 charsNo delayGoogle (Turbo) ⚡10 threads3,500 charsNo delayGoogle (Stable) 🛡️3 threads1,500 chars0.5s between batches

🔤 5. Magic Font Injection (Fixes Tofu Bug)

[IMPROVED] — Now a user-toggleable checkbox in settings.

• Before: auto-injected only for CJK languages

• Now: user decides whether to enable it (checkbox "Magic Font Injection")

• Supports more languages: es, pt, it, fr, de, ru, ja, ko, zh-CN, zh-TW, ar, he, bn, hi, ur, vi

• Preference is saved across sessions

📦 6. Expanded Advanced Tools

ToolDescription📤 Export (.json)Exports all game texts to a human-editable JSON📥 Import (.json)Imports a manually translated JSON and injects it into the game📦 Pack (.rpa)Creates native RPA3 archives from folders (for mod distribution)✅ Verify (.rpy)Scans scripts for unclosed quotes, mismatched brackets, broken braces🔀 Translate from TLTranslates using an existing translation as a bridge🗑️ Delete TranslationSmart purge of _ultra folders, activators, and temp files

🖥️ 7. UI Improvements

• Base64-embedded icons: Ren'Py and Unity icons embedded directly in code (no external file dependencies)

• Tab navigation: Sidebar with 4 pages (Home, Tools, Unity, Console)

• Modern cards: Card-style design with borders and separators

• Bottom status bar: Shows version and current theme

• Post-translation Patreon popup: Shown after completing a successful translation

• Unity game type indicator: Shows whether it's Mono or IL2CPP

• Multi-line dialogue support: Parser for multi-line dialogues (speaker "text that\n continues on the next line")

• centered dialogue detection: Correctly translates centered "text" statements
  

🐛 BUGS FIXED (v0.03 → v0.06)

BugImpactFixDialogues not translated (Ravenous Arc 2, etc.)Critical — games showed original textComplete engine rewrite with native Ren'Py MD5 hashesencode_say_string not replicatedCritical — hashes didn't match the engine'sExact implementation of Ren'Py's encode_say_string() and renpy_normalize_text()Double translationMedium — re-translated existing tl/ folderstl/ excluded from original script scanningIncorrect relative paths for Ren'Py 8+Medium — stubs didn't match at runtimeNormalized game/xxx.rpy path builderUI strings not capturedMedium — menu choices stayed in EnglishImproved regex to capture UI strings in non-dialogue linesMulti-line dialogue ignoredMedium — speakers with text split across 2+ linesNew parser that accumulates lines until closing quote is foundOrphaned folders on deleteLow — ultra and standard folder weren't cleaned togetherSmart scan of ultra folders + activators in game/Crash on GUI language toggleLow — exception when switching ES/ENProper dictionary rebuild with ISO selection preservation.rpyc cache prevents re-translationLow — game used cached version ignoring changesAutomatic .rpyc cleanup after each translation

❌ EXPERIMENTAL FEATURES — ATTEMPTED & DISCARDED

🧪 Argos Translate (Offline NMT Engine) — DISCARDED

Status: Fully implemented → Tested → Completely removed

What was it?

We integrated Argos Translate, a neural machine translation engine (OpenNMT) that worked 100% offline using the user's CPU.

What was built?

• Complete "Local NMT (💻)" tab with its own sidebar icon

• One-click engine installer: Ran pip install argostranslate ctranslate2 in background threads

• Language package manager: .argosmodel downloader with source/target language selector

• Aggressive integration: Added "Argos Translate (Offline) 💻" as an engine option in both Ren'Py and Unity

• Speed configuration: 15+ threads with 5000-char batches, no API semaphore (unlimited local speed)

• Smart detection: If the user selected Argos without installing it, a handler showed a friendly message

Why was it discarded?

1. Unacceptable translation quality: Argos quality for Asian languages (Japanese, Chinese, Korean) was far inferior to Google Translate

2. Package weight: CTranslate2 + language models added ~500MB+ to the distribution size

3. Installation complexity: Required end-users to install heavy dependencies

4. Maintenance burden: Duplicated the entire translation logic to support a second engine

5. PyInstaller/cx_Freeze conflicts: AI models didn't package well

What remains?

Absolutely nothing. The UI tab, installation buttons, engine options, offline translation logic, and argostranslate imports were all removed. The current codebase contains zero references to Argos.


📈 FULL DEVELOPMENT TIMELINE

PhaseVersionKey ChangesGenesisv0.01First prototype. PyInstaller + deep_translator. Ren'Py only. Spanish only. Basic CustomTkinter GUI.Clean Distributionv0.02Migrated to cx_Freeze (0/73 AV detections). Added CJK support + Tofu Fix. Delete button. Anti-rate-limit.Engine Rewritev0.03-v0.04Native MD5 hash system. Bridge Mode (TL). Export/Import JSON. RPA Packer. Syntax Verifier. Multi-line dialogue parser.Unity Modulev0.05Full Unity translator: BepInEx + XUnity. .NET string extraction. Asset scanning (4 methods). One-click translate. Wave system.Argos Experimentv0.05.x🧪 Built complete offline NMT engine with Argos Translate. Fully tested. Discarded due to poor quality.Stable Releasev0.06Complete Argos removal. Dead code cleanup. Google ULTRA mode. UI polish. Final stable build.

Translation Engines:

• ✅ Google (ULTRA) 🚀 — 15 threads, 0 delay, massive batches

• ✅ Google (Turbo) ⚡ — 10 threads, 0 delay, medium batches

• ✅ Google (Stable) 🛡️ — 3 threads, 0.5s delay, conservative batches

• ❌ Argos Translate (Offline) 💻 — Removed

Supported Platforms:

• ✅ Ren'Py — Full translation (dialogues + UI + menus)

• ✅ Unity (Mono) — BepInEx 5.4 + XUnity AutoTranslator

• ✅ Unity (IL2CPP) — BepInEx 6.0 + XUnity AutoTranslator

🎯 WHAT'S NEXT (Roadmap)

1. Improve Unity text extraction with support for more asset formats

2. Consider integration with new translation engines (DeepL API free?)

3. Translation cache system to avoid re-translating already processed texts

4. Possible RPG Maker support in future versions