Skip to content

GET (Godot Easy Translations) is a node-based translation system for the Godot Engine that simplifies localization by allowing direct text management within the scene. Easily switch languages, format text dynamically, and apply conditional translations effortlessly! πŸŒπŸ“πŸš€

License

Notifications You must be signed in to change notification settings

IsItLucas/godot_easy_localization

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GEL - Godot Easy Localization πŸŒπŸ“πŸš€

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.

🌟 Features

  • πŸ“Œ 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.

πŸ“₯ Installation

  1. Download or Clone the repository.
  2. Place the addons/ folder inside your Godot project.
  3. Enable the plugin in Project > Project Settings > Plugins.

βš™οΈ Configuration

  1. Go to Project > Project Settings > Godot Easy > Localization.
  2. Customize the addon's behaviour as you like.
  3. You're all set! βœ…πŸŽ‰

πŸš€ Getting Started

Basic Translation Setup

  1. Add a translator Translator node to your scene.
  2. Assign a string_data StringData resource containing translations.
  3. Define target NodeTargets for the properties to be translated.
  4. Run the project, and the text will update automatically!

Using Conditional Translations

  1. Add a ConditionalTranslator node.
  2. Assign two StringData resources (one for each condition outcome).
  3. Create TranslationConditions to determine which translation should be applied

πŸ“– Documentation

For full documentation, visit the Wiki.

🀝 Contributing

We welcome contributions! Feel free to open issues or submit pull requests.

πŸ“œ License

This project is licensed under the MIT License.


Make translations easier and more powerful with GEL - Godot Easy Localization! πŸŒπŸš€

About

GET (Godot Easy Translations) is a node-based translation system for the Godot Engine that simplifies localization by allowing direct text management within the scene. Easily switch languages, format text dynamically, and apply conditional translations effortlessly! πŸŒπŸ“πŸš€

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published