Module net.kyori.adventure.api
Package net.kyori.adventure.text

Interface TranslatableComponent

All Superinterfaces:
Buildable<TranslatableComponent.Builder>, BuildableComponent<TranslatableComponent,TranslatableComponent.Builder>, Component, ComponentBuilderApplicable, ComponentLike, HoverEventSource<Component>, ScopedComponent<TranslatableComponent>, StyleGetter, StyleSetter<Component>
public sealed interface TranslatableComponent extends ScopedComponent<TranslatableComponent>, BuildableComponent<TranslatableComponent,TranslatableComponent.Builder>
A component that can display translated text.

This component consists of:

key
a translation key used together with the viewer locale to fetch a translated string.
args(optional)
components that can be used as arguments in the translated string.

(e.g "You picked up {0}." -> "You picked up Carrot.")

Displaying this component through an Audience will run it through the GlobalTranslator by default, rendering the key as translated text if a translation with a key matching this components key is found in the viewers locale, optionally switching arguments with any placeholders in the discovered translation. If no translation is registered for the viewers locale adventure will first try to find similar locales that has a valid translation, and then find a translation in the default language(relevant method).

In addition to the initial attempts, if no translation is found in the serverside registry, the translation key and arguments will be passed through to the client which will perform translation using any keys defined in an active resource pack. (Hint: vanilla Minecraft is also considered a resource pack)

Since:
4.0.0
See Also: