One Click Localization

Quick Start Video Tutorial

Survival Shooter Localized in 2 Minutes

Playable WebGL Demo

Test language switching, audio localization, and dynamic parameter replacement live in your browser:

Data Storage (`OCLSetup.asset`)

OCL persists all configuration and runtime translations in a single ScriptableObject asset: Assets/OneClickLocalization/Resources/OCLSetup.asset.

Automatic Setup Settings

• Add OCL Component: Automatically attaches OCLComponentAdapter to GameObjects holding supported UI components.
• Extract Data: Extracts current text, sprite, texture, and audio values into the localization database.
• Includes / Excludes: Filter which component types to parse. By default: UnityEngine.UI.Text, UnityEngine.UI.Image, UnityEngine.UI.RawImage, UnityEngine.TextMesh, UnityEngine.AudioSource, and NGUI UILabel.
• Parse Prefabs & ScriptableObjects: Scan project assets recursively with customizable folder filters.

Microsoft Azure Translator

Translate all extracted strings automatically via Azure Cognitive Services. Add your Azure API Key in the Setup window, then click Translate All in the Localization window.

Import & Export (XML and CSV)

You can export your translations to send to professional translators, and re-import them with a single click:

<?xml version="1.0" encoding="UTF-8"?>
<localization>
  <strings>
    <string stringId="Start Game">
      <value lang="French">Commencer la partie</value>
      <value lang="German">Spiel starten</value>
    </string>
  </strings>
</localization>

StringId,French,German
"Start Game","Commencer la partie","Spiel starten"
"Quit","Quitter","Beenden"

`OCLComponentAdapter`

The adapter handles automatic runtime updates when the language changes. Supported components include:

• UnityEngine.UI.Text (Strings)
• UnityEngine.TextMesh (Strings)
• UnityEngine.UI.Image (Sprites)
• UnityEngine.UI.RawImage (Textures)
• UnityEngine.AudioSource (AudioClips)
• UILabel (NGUI)

Delegates & Events

Key Methods

1. Translating a String in Code

// Simple translation for current language
string translated = OCL.GetLocalization("Game Over");

// Translation for a specific language
string frenchText = OCL.GetLocalization("Game Over", SystemLanguage.French);

2. Dynamic String Parameters

OCL automatically substitutes dynamic parameters defined with ${0}, ${1}:

// Original text: "Player ${0} scored ${1} points!"
string scoreMessage = OCL.GetLocalization("Player ${0} scored ${1} points!", "Alex", 1500);

3. Language Switcher Dropdown (uGUI)

using System;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using OneClickLocalization;

public class LanguageDropdownController : MonoBehaviour
{
    [SerializeField] private Dropdown _dropdown;

    private void Start()
    {
        // Populate dropdown with all supported languages
        List<string> options = new List<string>();
        foreach (SystemLanguage lang in OCL.GetLanguages())
        {
            options.Add(lang.ToString());
        }
        _dropdown.ClearOptions();
        _dropdown.AddOptions(options);

        // Select current language
        _dropdown.value = options.IndexOf(OCL.GetLanguage().ToString());
        _dropdown.onValueChanged.AddListener(OnLanguageSelected);
    }

    private void OnLanguageSelected(int index)
    {
        string selected = _dropdown.options[index].text;
        SystemLanguage newLang = (SystemLanguage)Enum.Parse(typeof(SystemLanguage), selected);
        OCL.SetLanguage(newLang);
    }
}

4. Adding Languages Dynamically

SystemLanguage targetLang = SystemLanguage.Japanese;

if (!OCL.GetLanguages().Contains(targetLang))
{
    OCL.AddLanguage(targetLang);
    OCL.SetLocalization("Welcome", targetLang, "ようこそ");
}