This plugin facilitates the integration of Unity's Localization package with Gridly, enabling seamless management and translation of in-game text. Below are the steps to install, configure, and use the plugin.
-
Install Unity Localization Package
- Download and install the Unity Localization package from the Unity Documentation.
- Follow the instructions to add target languages and manage strings in your application.
-
Copy Plugin Folder
- Extract the plugin folder and copy it into your
Assets
folder for exampleMy project\Assets\Gridly-loc-package
.
- Extract the plugin folder and copy it into your
-
Add Target Languages
- Go to
Edit -> Project Settings -> Localization
and add your target languages.
- Go to
-
Add String Tables
- Navigate to
Window -> Asset Management -> Localization Tables
and create your string tables.
- Navigate to
-
Configure CSV Path
- Set the path in which the plugin will generate CSV files.
-
Set View ID
- Enter your Gridly View ID.
-
Set API Key
- Provide your Gridly API key for authentication.
-
Add Localization Tables
- Ensure your localization tables are set up in Unity.
-
Select Languages for Gridly
- Choose the languages you want to send to Gridly from the Localization table.
-
Use separate views for push and pull
- If you check the option "Use different View for Import", you can define a separate View ID and Password for importing from Gridly to Unity."
-
Smart strings
- You can set the string type you would like to send or receive using the plugin. In the Unity localization package, you can set strings as smart strings. Using the import/export type selection, you can define whether you want to send/receive only smart/non-smart or all types of strings.
-
Keep your View in synch with your Unity records
- If desired, you can use the "Delete removed records from Gridly" setting. This results in strings being removed from Gridly if they have been removed from Unity.
- In Gridly, ensure that the column name and ID match the language code used in Unity (e.g.,
enUS
,frFR
,esES
).
- After configuring the settings, you can send your content to Gridly.
-
Open the Plugin
- Ensure the plugin is open in Unity.
-
Verify View ID and API Key
- Confirm that the correct View ID and API key are configured.
-
Fetch Data from Gridly
- Click on
Get View Data from Gridly
.
- Click on
-
Select Files and Languages
- Choose the file(s) and language(s) you want to import.
-
Import Data
- Click on
Import Selected Data
to pull the translations back to Unity.
- Click on
For further assistance about the Unity Localization package, consult the Unity Localization Documentation.