exo/game-engine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Refactor Localization Service

Browse Source 
- Updated LocalizationService interface to load localization data from a Path instead of InputStream.
- Enhanced LocalizationServiceImpl to handle loading and saving of localization data from directories.
- Introduced LocalizationLanguage and LocalizationMetadata classes to encapsulate language entries and metadata.
- Refactored Localizations class to manage language files and metadata more effectively.
- Added unit tests for loading localizations from directory and verifying language translations.
- Created YAML files for English and German languages along with a metadata file for localization information.
This commit is contained in:
extio-de
2026-05-15 16:32:18 +02:00
parent 99cbee4515
commit f54e07b984
14 changed files with 470 additions and 313 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
README.md
View File

@@ -1016,7 +1016,7 @@ Requires `StaticResourceService` and `StorageService` to be available.
### Internationalization (i18n)
#### Purpose and Overview
A YAML-based localization system supporting multiple languages. Localizations are loaded from a structured YAML file containing translation entries organized by language code. The system supports both integer and string-based translation keys and provides fallback to default text when translations are missing.
A YAML-based localization system supporting multiple languages. Localizations are loaded from a directory bundle with one metadata file and one file per language, allowing metadata and translation entries to evolve independently. The system supports both integer and string-based translation keys and provides fallback to default text when translations are missing.
Includes an integrated `LocalizationEditor` - a Swing-based GUI tool for managing translations, adding new languages, and editing localization entries during development.
@@ -1026,7 +1026,7 @@ Includes an integrated `LocalizationEditor` - a Swing-based GUI tool for managin
**Properties**:
- `game-engine.i18n.enabled` (default: `true`)
- `game-engine.i18n.load-on-start` (default: `true`) - Auto-load localizations on startup
- `game-engine.i18n.resource` (default: `i18n/i18n.yaml`) - Path to localization resource
- `game-engine.i18n.resource` (default: `i18n/metadata.yaml`) - Path to the localization metadata resource; sibling `*.yaml` files are loaded as individual languages
#### Exposed Spring Beans
- **`LocalizationService`**: Main interface for translation, language management, and localization editing