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 Detail

      • translator

        @NotNull
        static @NotNull GlobalTranslator translator()
        Gets the global translation source.
        Returns:
        the source
        Since:
        4.10.0
      • get

        @Deprecated
        @ScheduledForRemoval(inVersion="5.0.0")
        @NotNull
        static @NotNull GlobalTranslator get()
        Deprecated.
        for removal since 4.10.0, use translator() instead.
        Gets the global translation source.
        Returns:
        the source
        Since:
        4.0.0
      • renderer

        @NotNull
        static @NotNull TranslatableComponentRenderer<java.util.Locale> renderer()
        Gets a renderer which uses the global source for translating.
        Returns:
        a renderer
        Since:
        4.0.0
      • render

        @NotNull
        static @NotNull Component render​(@NotNull
                                         @NotNull Component component,
                                         @NotNull
                                         @NotNull java.util.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

        @NotNull
        @NotNull java.lang.Iterable<? extends Translator> sources()
        Gets the sources.
        Returns:
        the sources
        Since:
        4.0.0
      • addSource

        boolean addSource​(@NotNull
                          @NotNull Translator source)
        Adds a translation source.

        Duplicate sources will be ignored.

        Parameters:
        source - the source
        Returns:
        true if registered, false otherwise
        Throws:
        java.lang.IllegalArgumentException - if source is GlobalTranslator
        Since:
        4.0.0
      • removeSource

        boolean removeSource​(@NotNull
                             @NotNull Translator source)
        Removes a translation source.
        Parameters:
        source - the source to unregister
        Returns:
        true if unregistered, false otherwise
        Since:
        4.0.0