NextLocalization

NextLocalization is a lightweight, code-friendly localization system built entirely on ScriptableObjects. It ships with a full-featured custom editor window, CSV import/export, automatic key-rename refactoring across your entire project, and an extensible mod system so you can add custom inspector fields without ever touching package code.

Key Features

1. 1
   Import the package via the Unity Package Manager or drag the NextLocalization folder into your Assets/ directory.
2. 2
   TextMeshPro is required for TextConverter, DropdownConverter, and LanguageDropdown. Install it via Window → Package Manager → TextMeshPro if not already present.
3. 3
   Open the Localization Editor from the Unity menu bar:

NextHaven Studio → Localization Editor

1. 4
   The editor will automatically create the LocalizationTable asset at:

Assets/Resources/Localization/LocalizationTable.asset

Step 1 — Add Languages

1. 1
   Open NextHaven Studio → Localization Editor.
2. 2
   In the Languages panel (left), click + to add a new entry (e.g. English).
3. 3
   Click Create Asset in the Inspector panel to generate the language's .asset file.
4. 4
   Repeat for each language (e.g. Turkish, German).

Step 2 — Add Keys

1. 1
   In the Table Sheet panel (center), click + → Add Section (e.g. menu).
2. 2
   Right-click the section → Add Key (e.g. play, quit).
3. 3
   Keys are addressed as section.key at runtime — e.g. "menu.play".

Step 3 — Enter Translations

1. 1
   Select a Language in the Languages panel.
2. 2
   The Inspector (right) shows all sections and keys with editable text fields.
3. 3
   Type the translation for each key.

Step 4 — Save

Click Save Asset in the toolbar.

Step 5 — Initialize at Runtime

Add LocalizationInitializer to a root GameObject in your first scene:

Add Component → LocalizationInitializer

Set Default Language to English.

Step 6 — Use in Code

Copy// Simple key lookup
string label = Loc.Get("menu.play");          // → "Play"

// Formatted lookup ({0} placeholder)
string round = Loc.Get("game.round", 3);      // → "Round 3"

// Change language
Loc.SetLanguage("Turkish");

Open via NextHaven Studio → Localization Editor.

Languages Panel

Table Sheet Panel

The center panel shows the shared structure — sections (folders) and keys — across all languages.

Toolbar

Loc is a static class — no instance or singleton reference needed.

Initialization

CopyLoc.Init();              // Load saved language or first available
Loc.Init("Turkish");     // Load a specific language

Getting Translations

Copy// Simple
string text = Loc.Get("menu.play");
// → "Play"            (key found)
// → "[menu.play]"     (key missing — never throws)

// Formatted  (localization value: "Round {0} of {1}")
string text = Loc.Get("game.round_of", 3, 10);
// → "Round 3 of 10"

Changing Language

CopyLoc.SetLanguage("German");
// Loads the German asset, fires OnLanguageChanged, saves preference to disk

Properties

Copystring   lang    = Loc.CurrentLanguage;     // "English" / "Turkish" / ...
string[] langs   = Loc.AvailableLanguages;  // all languages in the table
bool     ready   = Loc.IsInitialized;
bool     saved   = Loc.HasSavedLanguage;

Language Changed Event

Copy// Subscribe in OnEnable
Loc.OnLanguageChanged += RefreshMyUI;

// Always unsubscribe in OnDisable — prevents NullReferenceException
Loc.OnLanguageChanged -= RefreshMyUI;

• → Acts as a singleton — duplicates across multiple scenes self-destruct.
• → Calls DontDestroyOnLoad — persists across scene transitions.
• → If the player already has a saved language, that takes priority over Default Language.

7.1 TextConverter

Keeps a TMP_Text in sync with the current language automatically.

7.2 DropdownConverter

Localizes the option labels of a TMP_Dropdown.

7.3 LanguageDropdown

A self-configuring TMP_Dropdown that lists all available languages and switches the active language on selection.

A serializable field type that stores a key string and provides a searchable picker in the Inspector.

Copypublic class MyUI : MonoBehaviour
{
    [SerializeField] private LocalizationKey myKey;

    private void Start()
    {
        // LocalizationKey implicitly converts to string
        string value = Loc.Get(myKey);
    }
}

In the Inspector:

• • Text field — shows the current key value.
• • 🔍 button — opens a searchable dropdown listing all sections and keys.

Exported Format

CopyKey,English,Turkish,German
menu.play,Play,Oyna,Spielen
menu.quit,Quit,Çık,Beenden
game.round,Round {0},Tur {0},Runde {0}

Import Rules

• ✓ Import is additive — existing values are preserved unless the CSV cell contains a new value.
• ✓ Empty CSV cells are skipped; they do not overwrite existing translations.
• ✓ After importing, click Save Asset to commit.

When you rename a key or section in the editor and click Save Asset:

1. 1
   Changes are detected by comparing internal IDs (not names), so renames are never missed.
2. 2
   A confirmation dialog lists every detected rename.
3. 3
   All .asset, .prefab, and .unity files are scanned.
4. 4
   Every LocalizationKey referencing the old name is updated in place.
5. 5
   Modified assets are saved automatically.

Extend the Localization Editor without modifying any package files.

Creating a Mod

Copyusing UnityEditor;

[InitializeOnLoad]
public class MyMod : LocalizationEntryInspectorMod
{
    public override string ModId => "my.mod";

    static MyMod() => Register(new MyMod());

    // Return true to draw this panel for the given key
    public override bool ShouldDraw(string sectionName, string fullKey)
        => sectionName == "dialogue";

    // Draw your IMGUI UI here
    public override void DrawFields(string sectionName, string fullKey)
    {
        EditorGUILayout.LabelField("Voice Clip", EditorStyles.boldLabel);
        // ...
    }
}

Save Hook

Copy[InitializeOnLoad]
public static class MySaveHook
{
    static MySaveHook()
    {
        LocalizationEntryInspectorMods.OnCommitSave += () =>
        {
            // Save your own data alongside the localization asset
        };
    }
}

Rename Hook

CopyLocalizationEntryInspectorMods.OnCommitRename += renames =>
{
    foreach (var (oldKey, newKey) in renames)
    {
        // Update your own data structures
    }
};

Marking the Save Button Dirty

Copy// Call this whenever your mod has unsaved changes
// The Save Asset button will turn green to signal pending changes
LocalizationEntryInspectorMods.MarkModDirty();