> For the complete documentation index, see [llms.txt](https://glitch9.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://glitch9.gitbook.io/docs/unity-assets/ai-dev-kit-spreadsheets/getting-started.md).

# Getting Started

### Requirements

**Smart Localization** requires the 'AI Development Kit' asset to function. Please ensure this asset is installed before using **Smart Localization**. If you do not have 'AI Development Kit' installed yet, you can download it from the Unity Asset Store [here.](https://assetstore.unity.com/packages/tools/ai-ml-integration/ai-toolkit-for-unity-281225)[ ](https://assetstore.unity.com/preview/281225/917274)

### Getting Started

Smart Localization settings are managed through the Unity Preferences window. Follow these steps to configure your localization settings:

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXfvxAoImCwn8X43k6o7qfsPu4jqaq7HHRxhoU3J1F0ihTPpg3resnbtfb-SxH-043YuZuc-bU2F7blEjpq2hVezKMTmBEq9N1vDYzKhacrBaB4U1KDypMm71mHmMN_hkKFZl2vRRiV-JcuziytZVMDJCX4?key=IWkPO0by-aExi5LMhzB8_w" alt=""><figcaption></figcaption></figure>

**1. Open Preferences:**

* In Unity, navigate to Edit > Preferences... (on macOS, Unity > Preferences...).
* In the Preferences window, select Glitch9 > Smart Localization.

**2. General Settings:**

* Default Locale: Set the default language for your project.
* Localization Source: Choose the source for your localization data (e.g., Addressables).
* Addressable Group: Specify the addressable group that contains the localization tables.

**5. Contributors:**

* Manage the list of contributors to your localization data.

**6. Locales:**

* Available Locales: Configure the default set of locales available for use in the localization system.
* Supported Locales: Specify the locales included in the current version of the project.

### Basic Usage

**1. Set the Current Locale:**

First, set the locale that your application will use for localization. This can be done using the `LocalizationManager.CurrentLocale` property.

```csharp
// Set the current locale to French
LocalizationManager.CurrentLocale = new Locale(SystemLanguage.French);
```

**2. Localize Strings:**

Use the provided extension methods to localize strings based on the current locale. The Localize extension method can be used to fetch the localized version of a string.

```csharp
// Localize a string key using the default table
string localizedText = "hello_world".Localize();

// Localize a string key using a specified table
string localizedTextFromTable = "greeting".Localize("myCustomTable");
```

**3. Localize DateTime:**

The Localize extension method for `DateTime` allows you to format dates and times according to the current locale.

```csharp
DateTime currentDate = DateTime.Now;

// Localize DateTime to the current locale with default format
string localizedDate = currentDate.Localize();

// Localize DateTime to the current locale with a specific format
string localizedDateWithFormat = currentDate.Localize(DateTimeFormat.FullDateWithDay);
```

**4. Localize Enums:**

To localize enums, you need to use the `LocalizedEnumAttribute` to specify the table name for the enum values. Then, you can use the Localize extension method for enums.

```csharp
// Define the enum with the LocalizedEnum attribute
[LocalizedEnum("DaysTable")]
public enum DaysOfWeek
{
    Monday,
    Tuesday,
    Wednesday,
    Thursday,
    Friday,
    Saturday,
    Sunday
}

// Localize an enum value
string localizedDay = DaysOfWeek.Monday.Localize();
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://glitch9.gitbook.io/docs/unity-assets/ai-dev-kit-spreadsheets/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.