Leiv’s Translation API

🌐 Leiv’s Translation API

Leiv’s Translation API is the dynamic localization engine of the Leiv Ecosystem Suite.

While Leiv’s API handles the logic and Leiv’s Network Lib handles the sync, this library ensures that every menu, tooltip, and text element is perfectly localized. It is a highly optimized language manager designed to dynamically load, cache, and apply translation files at runtime without requiring hardcoded strings. It ensures that mods like Leiv’s Config Menu and others display the correct text flawlessly.

⚠️ PLAYER NOTE: This is a required core dependency for user interface and text-driven mods within the Leiv Ecosystem. It does not add blocks or items on its own, but must be installed alongside my mods to display localized text, menus, and tooltips correctly!

✨ Key Features

• 🌐 Dynamic Namespace Registration: Automatically discovers and registers language files across all 11 Leiv ecosystem namespaces on startup.
• 🚀 DictCache Acceleration: High-speed in-memory translation cache that resolves language keys in microseconds.
• 📝 Dynamic Tooltip Resolution: Automatically pairs configuration rules and UI elements with their corresponding .desc translation keys.
• 🔄 Hot-Reload Support: Supports dynamic language switching in-game without forcing a client restart.

🛠️ Technical Highlights (For Developers & Modpack Creators)

Leiv’s Translation API provides a game-code-decoupled localization pipeline:

• 🧠 LeivTranslationEngine: The core translation scanner that dynamically loads assets/<namespace>/lang/*.json files into a unified cache.
• 🔍 DictCache Engine: Optimized key-value dictionary engine featuring instant fallback handling when a key is missing in a specific language.
• 💬 Dynamic Placeholder Injector: Supports string interpolation and runtime parameter injection for dynamic UI descriptions.
• 🎨 Formatting Abstraction: Cleanly strips or converts legacy Minecraft color codes (§) and modern Component formatting on demand.

🔗 Dependencies

This library ensures that the ecosystem’s text is as dynamic as its logic:

• Requires: Leiv’s Lib & Leiv’s API (Make sure both are installed!)
• Used By: Leiv’s GUI, Leiv’s Config Menu, ItemCuller, Keybind Profiles, EnderStash, and all other Leiv Ecosystem end-mods.

💬 Community & Support

Got questions, feedback, or need to report a bug? Join the community!

• 👥 Discord: Join Leiv’s Community
• 🐛 Issue Tracker: Report bugs via the official Discord ticket system.