Unity-Translator

📘 Unity Translator V1.0

Web-based Localization Toolkit & Game Mod Translation Studio

English Version | Deutsche Version

🔧 Overview

Unity Translator is a lightweight, web-based localization toolkit engineered for game modders, translators, and developers working with Unity Engine localization files (CSV).

The project was born out of a real-world need: when playing games like 7 Days to Die or downloading mods from Nexus Mods, localization packages are often only available in English. Unity Translator eliminates the hassle of manual line-by-line translation or clunky external tools by providing a fast, browser-based workflow with zero dependencies.

Note for Reviewers: Designed as a clean, single-file HTML/JS web application, this tool demonstrates zero-dependency client-side architecture, dynamic REST API abstraction, and responsive UI performance without requiring heavy build steps or server backends.

✨ Features

🎨 Table & Translation Engine

• Dynamic Column Mapping: Flexible auto-assignment and custom mapping for Keys, Source Text, and Target Languages regardless of file structure.
• Granular Editing: Translate entire columns in bulk, batch-process missing entries, or manually edit individual table cells.
• Instant Preview & Search: Filter, search, and review translated entries in real-time before exporting.

🌐 Multi-Provider API Abstraction

Integrate with your translation provider of choice seamlessly:

• DeepL API: Native support for DeepL Free and Pro endpoints.
• Google Translate: Quick integration for unofficial translation endpoints.
• Custom REST Endpoints: Full control with custom URL/body templates ({text}, {target}, {source}) and JSON-path response mapping (e.g., for self-hosted LibreTranslate instances).

🛡️ Client-Side & Privacy First

• Offline Capable: Runs entirely inside your local browser. No backend server required.
• Data Protection: Your files stay local; API calls are sent directly from your browser to your configured endpoint.
• Multilingual UI: Built-in internationalization (i18n) supporting 🇬🇧 English and 🇩🇪 German.

🧱 Architecture & Engineering

The application is structured for maximum portability and maintainability:

• Decoupled API Handler: Unified abstraction layer (translateTextViaProvider) handling rate limits, error catching, and custom REST parsing independently of UI logic.
• Reactive UI Pipeline: Dynamic rendering of heavy localization tables without blocking the main browser thread during batch operations.
• Zero-Dependency Core: Implemented using modern Vanilla JavaScript (ES6+), HTML5, and CSS3.

📂 File Formats Supported

• .csv (Comma/Semicolon Separated Values)

🚀 Deployment & Usage

Unity Translator is a 100% client-side application.

Installation:

git clone https://github.com/dtechniker/unity-translator.git

Run: Simply open index.html in any modern web browser or deploy it via GitHub Pages.

---

🔧 Überblick

Der Unity Translator ist ein webbasiertes Lokalisierungs-Toolkit für Gamer, Modder und Entwickler, die Sprachdateien von Unity-Spielen (CSV) schnell und unkompliziert übersetzen möchten.

Das Projekt entstand aus der Praxis heraus: Bei Spielen wie 7 Days to Die oder Modifikationen auf Nexus Mods sind Sprachpakete häufig nur auf Englisch verfügbar. Der Unity Translator nimmt die Hürde vor unübersichtlichen Tabellen und ermöglicht das einfache Übersetzen von Mod-Dateien für den eigenen Bedarf oder gemeinsame Spieleabende.

Hinweis zur Architektur: Die Anwendung ist als schlanke, abhängigkeitsfreie Web-Applikation (Single-File Architecture) konzipiert. Sie demonstriert die Kapselung externer REST-Schnittstellen, effiziente DOM-Manipulation großer Datensätze und volle Client-Side-Ausführung ohne Node.js-Backend.

✨ Hauptfunktionen

🎨 Tabellen- & Übersetzungs-Workshop

• Dynamisches Spalten-Mapping: Zuordnung von Schlüsselspalten (Keys), Quell- und Zielsprachen unabhängig vom Dateiaufbau.
• Flexible Übersetzung: Ganze Spalten automatisch übersetzen, fehlende Zeilen im Batch nachfahren oder einzelne Zellen manuell editieren.
• Echtzeit-Filtern & Suche: Schnelle Durchsuchbarkeit großer Sprachdateien vor dem Re-Export.

🌐 Schnittstellen-Integration (Multi-Provider API)

• DeepL API: Integrierte Anbindung für DeepL Free & Pro API-Schlüssel.
• Google Translate: Unterstützung für Standard-Übersetzungsschnittstellen.
• Custom REST API: Vollständige Freiheit durch Platzhalter-Anpassung ({text}, {target}, {source}) sowie JSON-Pfad-Extraktion (z. B. für lokale LibreTranslate-Server).

🛡️ Datenschutz & Performance

• 100% Lokal: Sämtliche Tabellendaten verbleiben im Browser.
• Keine Server-Abhängigkeit: Läuft ohne Installation oder Backend.
• Zweisprachige Oberfläche: Nahtloser Wechsel zwischen 🇩🇪 Deutsch und 🇬🇧 Englisch (i18n).

🧱 Architektur & Design Patterns

• Gekapselter API-Provider: Die Funktion translateTextViaProvider trennt die Netzwerkanfragen, Error-Handling und Response-Parsing strikt von der UI-Logik.
• Performantes Rendering: Optimierte Tabellendarstellung für ruckelfreie Interaktion selbst bei tausenden Lokalisierungszeilen.
• Zero-Dependencies: Reine Standard-Webtechnologien (Vanilla ES6+ JS, HTML5, CSS3) ohne externe Frameworks.

📂 Unterstützte Formate

• .csv (Komma- und Semikolon-getrennte Tabellen)

📜 Lizenz & Credits

Lizenz: AGPL-3.0

Copyright: (c) 2026 DTechniker

Autor: DTechniker