Localization Settings
The central configuration asset for the localization system
Overview
Localization Settings is a ScriptableObject that acts as the brain of the system. It stores references to all your languages, tables, and global configuration options.
You can access your settings file via the project window, or by navigating to Tools -> Evo Localization -> Open Localization Settings (if you have created one).
Configuration
Languages
This list defines the languages available in your application. Each entry links to a LocalizationLanguage asset. You can add, remove, and create new language assets directly from this list.
| Property | Description |
|---|---|
| ID | Unique identifier (e.g., "en-US", "ja"). |
| Name | Display name (e.g., "English"). |
| Localized Name | Native name (e.g., "日本語"). |
| Icon | Optional flag or icon texture. |
Tables
This list defines the categorization of your localized content (e.g., UI, Dialog, Items). Each entry links to a LocalizationTable asset.
| Property | Description |
|---|---|
| ID | Unique identifier for the table (e.g., "Subtitles"). |
| Sheet GID | Unique numeric Google Sheet tab ID (0 is valid). Leave empty to exclude the table from Google Sheets sync. |
Settings
Global behaviors for the localization system.
| Property | Description |
|---|---|
| Default Language | The language used when the game starts for the first time or if a key is missing. |
| Get System Language | If no saved selection is used, matches Application.systemLanguage to a language's languageName without regard to case. If no match is found, uses the default language. |
| Save Language Selection | Automatically saves the selected language to PlayerPrefs and loads it on the next session. |
| Enable Logs | Prints debug information to the console when keys are missing or events occur. |
Google Sheets
In the Integrations section, enable Google Sheets to configure:
| Property | Description |
|---|---|
| Spreadsheet ID | The spreadsheet ID or full HTTPS Google Sheets edit URL. |
| Update Mode | Manual, Once (default), or Continuous runtime pulls. |
| Update Interval (sec) | Unscaled delay after each Continuous pull completes; defaults to 300 seconds, minimum 30 seconds. |
| Pull | Imports into project assets outside Play Mode; downloads into memory in Play Mode. |
| Push | Opens the authenticated editor push workflow outside Play Mode. |
Enable the integration before the runtime manager initializes. Runtime pulls do not save changes to project assets.
See the Google Sheets page for details.
CSV Import / Export
You can bulk edit data by exporting tables to CSV.
Expand a Table entry in the list
Click Export CSV to save the current data
Edit the file in Excel or Google Sheets
Click Import CSV to merge changes back into the asset
Scripting API
While you rarely need to fetch settings at runtime, you can access them via the LocalizationManager.
using UnityEngine;
using Evo.Localization;
public class AccessingSettings : MonoBehaviour
{
void Start()
{
// Get the singleton settings
var settings = LocalizationManager.GetSettings();
if (settings != null)
{
Debug.Log($"Default Language: {settings.defaultLanguageID}");
Debug.Log($"Total Tables: {settings.tables.Count}");
}
// You can also load default settings statically
var staticSettings = LocalizationSettings.GetDefault();
}
}