Text Localization

Text localization allows texts to be localized based on player's Sonolus language.

Basic Localization

When a key is used, it will be replaced with the key's localized text.

For example #TITLE will be replaced with Title if player's Sonolus language is set to English.

Basic Interpolation

When a key followed by : is used, it will be replaced with the key's localized text with {0} interpolated with argument.

For example #DAY_PAST:42 will be replaced with interpolate(#DAY_PAST, "42"). If player's Sonolus language is set to English, #DAY_PAST's localized text is {0}d ago, and interpolate(#DAY_PAST, "42") evaluates to 42d ago.

Interpolation Fallback

When a key's localized text does not contain {0} for interpolation, argument will instead be appended at the end.

For example #PREFIX_LIST:Hello World. will be replaced with interpolate(#PREFIX_LIST, "Hello World."). If player's Sonolus language is set to English, #PREFIX_LIST's localized text is - , and interpolate(#PREFIX_LIST, "Hello World.") evaluates to - Hello World..

Nested Interpolation

Interpolation can be nested.

For example #PUBLISHED:#SEPARATOR_COLON:#DAY_PAST:42 will be replaced with interpolate(#PUBLISHED, interpolate(#SEPARATOR_COLON, interpolate(#DAY_PAST, "42"))). If player's Sonolus language is set to English, #PUBLISHED, #SEPARATOR_COLON, and #DAY_PAST's localized texts are Published, : , and {0}d ago respectively, and interpolate(#PUBLISHED, interpolate(#SEPARATOR_COLON, interpolate(#DAY_PAST, "42"))) evaluates to Published: 42d ago.

Interpolation Functions

Special interpolation functions can be used:

• ##: Escapes argument. For example ##:#TITLE evaluates to #TITLE (instead of #TITLE's localized text).
• ##TIME_FULL: Formatted full time. For example ##TIME_FULL:1767225600000 evaluates to 00:00 Jan 1st 2026, displayed using player's timezone and datetime formatting.
• ##TIME_RELATIVE: Formatted relative time. For example ##TIME_FULL:1767225600000 evaluates to 00:00 Jan 1st 2026, displayed relative to current time using localized texts such as #DAY_PAST and #DAY_FUTURE.
• ##LOCALIZE: Localize text based on language. For example ##LOCALIZE:{"en": "Hello!","zhs": "你好！"} evaluates to Hello! for players with English selected as their language. For players with language not included in the argument, it evaluates to the first language.

Multiline Interpolation

For multiline texts, interpolation will be applied to each line individually.