Skip to Content
DocumentationMulti-Language (i18n)

🌐 Multi-Language (i18n) System

Alya delivers full, native internationalization across 10 global languages with 100.00% key completeness, zero placeholder English, and zero disk hits after boot.


🌍 Supported Languages

CodeFlagLanguageNative NameStatus
en🇺🇸EnglishEnglish (US)Reference (4,272 keys)
id🇮🇩IndonesianBahasa Indonesia100% Native
jp🇯🇵Japanese日本語100% Native
jv🇮🇩JavaneseBasa Jawa100% Native
ko🇰🇷Korean한국어100% Native
zh🇨🇳Chinese简体中文100% Native
ru🇷🇺RussianРусский100% Native
de🇩🇪GermanDeutsch100% Native
es🇪🇸SpanishEspañol100% Native
fr🇫🇷FrenchFrançais100% Native

🔄 Setting Your Server’s Language

Server administrators can switch the server’s language using the /language command or via the web dashboard:

/language set code:id /language set code:jp /language set code:en

To view the currently active server language:

/language

⚡ High-Performance Architecture

  • In-Memory Locale Cache: All translation dictionaries are loaded into memory during client initialization. Resolving a translation key executes in sub-millisecond memory lookups with zero filesystem I/O.
  • Real-Time Dashboard Sync: When language settings are modified on the web dashboard, changes sync to the bot runtime within 15 seconds through an automated Redis bridge.
  • Fail-Safe Fallbacks: If a server selects an unsupported locale, Alya gracefully defaults to English (en) without crashing or showing blank responses.
  • Category Defense: Dynamic UI builders (such as /help) include sanitization guards that format category keys into human-readable titles, preventing internal translation paths (e.g. commands.help.categories...) from ever leaking into user chats.
Last updated on