Releases: Kruger0/Localize
Releases · Kruger0/Localize
Release list
Localize v2.0.0
Localize 2.0.0
This major update introduces a complete architectural overhaul, adding support for advanced string parsing (tags/recursion), dynamic font assets, and asynchronous file handling.
What's New
Core Features
- Multi-Page Sheet Support: The system can now load multiple individual pages (GIDs) from multiple Google Sheet URLs, allowing for better organization of large localization projects.
- Advanced String Parsing:
- Tags: Inject custom styles or values using
{tag:tag_name}. - Recursion: Reference other translation keys within a string using
{key:npc_name}.
- Tags: Inject custom styles or values using
- Plurals & Ordinals: Added native support for language-aware pluralization (e.g., "1 Coin" vs "10 Coins") and ordinal parsing (e.g., "1st", "2nd").
- Robust Fallback System: Keys with missing translations will now automatically use the translation of the fallback language. If the fallback is also missing, the raw key is returned.
Configuration & Setup
- Internal Sheet Configuration: Introduced special configuration rows within the CSV file to manage language metadata directly:
LOC_LANGNAME: Define a full display name (e.g., "English") for UI generation, replacing raw locale codes.LOC_FONTNAME: Define a custom font asset, external file path, or string name per language.LOC_PRODUCTION: Flag languages asENABLEDorDISABLEDto include/exclude them from executable builds.
- Environment-Specific Updates: Added configuration options to restrict file updates to the Development Environment only, preventing accidental overwrites in production builds.
Improvements & Tools
- New Debug Interface: A completely redesigned, functional debug overlay (ImGui) for inspecting loaded files, forcing language switches, and monitoring memory usage.
- Enhanced Customization: Added new settings for configuring trace log verbosity and CSV delimiters.
- Asynchronous I/O: File loading and saving is now fully asynchronous, preventing game freezes during file operations.
- Note: CSV parsing currently remains synchronous on the main thread, with plans for asynchronous parsing in future updates.
If you find any error or problem using this system, feel free to contact me! There are some useful links in the debug window too!
1.1.0
Localize v1.1 Release
- Complete file system overhaul
- Some macros and functions had their name changed
- Fix an critical error on creating the path for disabled sandboxed mode
- Added automatic localization according to the system region
- Added optional online mode for auto updating the lang file
- Default name changed from
langs.datatolocalize.dat - Added tag parsing system to replace tags inside the strings
- Fixed a function error in
localize_ext()