i18n - Unbound

What is i18n?

i18n is Unbound’s localization layer. It loads string tables for the user’s active Discord locale and falls back to en-US. It gives you a Messages proxy and a format function for rendering those strings. Your addon shows text in the user’s language without any locale detection code of your own.

The Messages proxy

Messages is a proxy over the loaded string tables. When you read a key, it checks three places in order:

The active locale.
en-US.
The key itself, so a missing translation shows something readable instead of undefined.

import { i18n } from '@unbound-app/api';

i18n.Messages.SETTINGS; // → "Settings" in the user's language

Formatting

Use format for strings with placeholders. It resolves the key through Messages, then fills in your variables using ICU MessageFormat. Plurals, selects, and named slots all work.

import { i18n } from '@unbound-app/api';

// string: "Deleted {count, plural, one {# message} other {# messages}}"
i18n.format('MESSAGES_DELETED', { count: 3 }); // → "Deleted 3 messages"

Addon localizations

defineLocalizations gives your addon its own Messages/format pair over a string table you provide. It shares the active locale with core, so your strings change language along with Discord. Your keys stay separate from core’s.

import { i18n } from '@unbound-app/api';

const { Messages, format } = i18n.defineLocalizations({
	'en-US': { GREETING: 'Hello, {name}!' },
	'fr':    { GREETING: 'Bonjour, {name} !' },
});

format('GREETING', { name: 'Mario' });

Always include an en-US table. Every other locale falls back to it when a key is missing.