Package net.kyori.adventure.translation

Interface GlobalTranslator

All Superinterfaces:

net.kyori.examination.Examinable, Translator

public interface GlobalTranslator
extends Translator, net.kyori.examination.Examinable

A global source of translations. The global source is the default source used by adventure platforms when rendering a TranslatableComponent to an Audience.

To add your translations to this source, use GlobalTranslator#get()#addSource(Translator) with a TranslationRegistry or your own implementation of a Translator.

Since:

4.0.0

Method Summary

Modifier and Type	Method	Description
boolean	addSource(@NonNull Translator source)	Adds a translation source.
static @NonNull GlobalTranslator	get()	Gets the global translation source.
boolean	removeSource(@NonNull Translator source)	Removes a translation source.
static @NonNull Component	render(@NonNull Component component, @NonNull Locale locale)	Renders a component using the global renderer.
static @NonNull TranslatableComponentRenderer<Locale>	renderer()	Gets a renderer which uses the global source for translating.
@NonNull Iterable<? extends Translator>	sources()	Gets the sources.

Methods inherited from interface net.kyori.examination.Examinable

examinableName, examinableProperties, examine

Methods inherited from interface net.kyori.adventure.translation.Translator

name, translate

Method Detail

get

static @NonNull GlobalTranslator get()

Gets the global translation source.

Returns:

the source

Since:

4.0.0

renderer

static @NonNull TranslatableComponentRenderer<Locale> renderer()

Gets a renderer which uses the global source for translating.

Returns:

a renderer

Since:

4.0.0

render

static @NonNull Component render(@NonNull Component component,
                                 @NonNull Locale locale)

Renders a component using the global renderer.

Parameters:

component - the component to render

locale - the locale to use when rendering

Returns:

the rendered component

Since:

4.0.0

sources

@NonNull Iterable<? extends Translator> sources()

Gets the sources.

Returns:

the sources

Since:

4.0.0

addSource

boolean addSource(@NonNull Translator source)

Adds a translation source.

Duplicate sources will be ignored.

Parameters:

source - the source

Returns:

true if registered, false otherwise

Throws:

IllegalArgumentException - if source is GlobalTranslator

Since:

4.0.0

removeSource

boolean removeSource(@NonNull Translator source)

Removes a translation source.

Parameters:

source - the source to unregister

Returns:

true if unregistered, false otherwise

Since:

4.0.0