UnityGameTranslator Website

Community platform for sharing Unity game translation files with API for mod synchronization.

Live site: unitygametranslator.asymptomatikgames.com

Features

Web Platform

• Browse translations by game, language, and popularity
• Upload translation files with automatic game detection
• Fork translations to improve existing work
• Merge contributions for translation owners to consolidate branches
• Vote system to highlight quality translations
• Report system for moderation
• Profile management with GDPR data export
• Multi-language UI (19 languages)
• Admin dashboard with analytics and moderation tools

Collaboration Model (Main/Branch/Fork)

The website uses a Main/Branch model for collaborative translation:

Term	Description
Main	The original translation. First uploader becomes the Main owner.
Branch	A contributor's version, linked to the Main.
Fork	The action of copying a translation to create your own Branch.

Workflow:

1. User A uploads → becomes Main owner
2. User B downloads, improves, uploads → forks and creates a Branch
3. User A sees all Branches on their translation page
4. User A can review and merge contributions from Branches into Main

Constraints:

• One Main per UUID (first uploader wins)
• One Branch per user per UUID (updating replaces your Branch)
• Languages locked after first upload (source/target immutable)
• UUID links all translations in a "lineage" (Main + all Branches)

Translation Quality System (H/V/A Tags)

Each translation entry has a quality tag stored in the JSON:

{
  "Hello": { "v": "Bonjour", "t": "H" },
  "Play": { "v": "Jouer", "t": "A" }
}

Tag	Name	Score	Description
H	Human	3 pts	Written by a human
V	Validated	2 pts	AI translation approved by human
A	AI	1 pt	Translated by Ollama

Note: Entries with tag H but empty value are displayed as "C" (Capture) and count as 0 pts until translated.

Additional tags (excluded from quality score):

Tag	Name	Description
S	Skip	Text intentionally not translated (alien language, Klingon, etc.). AI decides. Experimental.
M	Mod	Mod UI translations. Internal use.

Quality Score (0-3): (H×3 + V×2 + A×1) / (H + V + A)

Score	Label
2.5+	Excellent
2.0+	Good
1.5+	Fair
1.0+	Basic
<1.0	Raw AI

Editing on the website:

• Translation owners can edit entries online → tag becomes H
• Owners can validate AI translations → tag becomes V
• Bulk validation available for reviewing multiple entries

The website displays H/V/A counts and quality score on each translation card.

API for Unity Mod

• Search translations by Steam ID, game name, or language
• Download translations with ETag caching
• Check for updates without downloading full file
• Upload translations with authentication
• Device Flow authentication (enter code on website to link mod)
• Rate limiting per endpoint

Tech Stack

• Framework: Laravel 12
• Database: SQLite (dev) / MySQL (prod)
• Auth: Laravel Socialite (Steam, Epic Games, Google, GitHub, Discord, Twitch)
• Frontend: Tailwind CSS 4, Alpine.js, Font Awesome

Requirements

• PHP 8.2+
• Composer
• Node.js 18+
• SQLite or MySQL

Installation

composer setup

The composer setup command handles everything: dependencies, environment file, database migration, and asset building.

Manual installation

composer install
npm install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate
npm run build

Configuration

OAuth Providers

Configure in .env:

# Google
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# GitHub
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=

# Discord
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=

# Twitch
TWITCH_CLIENT_ID=
TWITCH_CLIENT_SECRET=

# Steam (Web API key only)
STEAM_API_KEY=

# Epic Games
EPICGAMES_CLIENT_ID=
EPICGAMES_CLIENT_SECRET=

Where to get credentials

Provider	Console
Google	Google Cloud Console
GitHub	GitHub Developer Settings
Discord	Discord Developer Portal
Twitch	Twitch Developer Console
Steam	Steam Web API Key
Epic Games	Epic Games Developer Portal

Development

# Start dev server (runs server, queue, logs, and Vite)
composer dev

# Or start individually
php artisan serve
npm run dev

Commands

# Run tests
composer test

# Clear caches
php artisan cache:clear
php artisan view:clear
php artisan config:clear

# Fresh database
php artisan migrate:fresh

Related

• Unity Mod: github.com/djethino/UnityGameTranslator

Acknowledgments

Backend

• Laravel - PHP framework
• Laravel Socialite - OAuth authentication
• SocialiteProviders - Community OAuth providers

Frontend

• Tailwind CSS - Utility-first CSS framework
• Alpine.js - Lightweight JavaScript framework
• Font Awesome - Icon library

License

This project is dual-licensed:

• Open Source: AGPL-3.0 - Free for open source use
• Commercial: Contact us for proprietary/commercial use

See LICENSING.md for details.