GEL (Godot Easy Localization) is a powerful and flexible translation addon for the Godot Engine. Unlike traditional translation systems that rely on Project Settings, external tools or CSVs, GET is entirely node-based, allowing for dynamic and intuitive text localization directly in the scene.
- π Node-Based Translation: Manage translations directly in your scene tree.
- π Multi-Language Support: Easily switch between different languages at runtime.
- π Dynamic Text Formatting: Support for formatted text using properties from other nodes.
- β Conditional Translations: Change translations based on in-game conditions.
- π― Targeted Property Translation: Apply translations to any property of any node.
- Download or Clone the repository.
- Place the
addons/
folder inside your Godot project. - Enable the plugin in
Project > Project Settings > Plugins
.
- Go to
Project > Project Settings > Godot Easy > Localization
. - Customize the addon's behaviour as you like.
- You're all set! β π
- Add a
Translator
node to your scene. - Assign a
StringData
resource containing translations. - Define
NodeTargets
for the properties to be translated. - Run the project, and the text will update automatically!
- Add a ConditionalTranslator node.
- Assign two StringData resources (one for each condition outcome).
- Create TranslationConditions to determine which translation should be applied
For full documentation, visit the Wiki.
We welcome contributions! Feel free to open issues or submit pull requests.
This project is licensed under the MIT License.
Make translations easier and more powerful with GEL - Godot Easy Localization! ππ