Interface Component
- All Superinterfaces:
ComponentBuilderApplicable,ComponentLike,net.kyori.examination.Examinable,HoverEventSource<Component>,StyleGetter,StyleSetter<Component>
- All Known Subinterfaces:
BlockNBTComponent,BuildableComponent<C,,B> EntityNBTComponent,KeybindComponent,NBTComponent<C,,B> ScopedComponent<C>,ScoreComponent,SelectorComponent,StorageNBTComponent,TextComponent,TranslatableComponent,VirtualComponent
- All Known Implementing Classes:
AbstractComponent
Components can be thought of as the combination of:
- The message the Component wants to display; and
- The
Styleof that message.
The most basic component is the TextComponent,
where the message is a simple String. However, other dynamic
Components are available, which are linked to from here and you
are encouraged to explore to better support your plugin/mod.
Factories and builders for all available component types are
provided via this interface.
Components can be serialized to and deserialized from other
formats via the use of component
serializers. If used within one of our natively supported platforms,
the availability of such serializers may vary, consult the documentation
or support for the given platform should this be the case.
Further information about Components, along with functional examples of how they can be used, can be found on our documentation.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final BiPredicate<? super Component,? super Component> A predicate that checks equality of twoComponents usingObjects.equals(Object, Object).static final BiPredicate<? super Component,? super Component> A predicate that checks equality of twoComponents using identity equality.A predicate that excludesempty(). -
Method Summary
Modifier and TypeMethodDescriptiondefault @NotNull Componentappend(@NotNull List<? extends ComponentLike> components) Appends a list of components to this component.default @NotNull ComponentAppends a component to this component.default @NotNull Componentappend(@NotNull ComponentBuilder<?, ?> builder) Appends a component to this component.default @NotNull Componentappend(@NotNull ComponentLike like) Appends a component to this component.default @NotNull Componentappend(@NotNull ComponentLike @NotNull ... components) Appends components to this component.default @NotNull ComponentAppends a newline to this component.default @NotNull ComponentAppends a space to this component.default @NotNull ComponentapplyFallbackStyle(@NotNull Style style) Apply a fallback style for this component and its children.default @NotNull ComponentapplyFallbackStyle(@NotNull StyleBuilderApplicable @NotNull ... style) Apply a fallback style for this component and its children.default @NotNull ComponentGets aComponentrepresentation.default @NotNull HoverEvent<Component>asHoverEvent(@NotNull UnaryOperator<Component> op) Creates a hover event with value derived from this object.static @NotNull BlockNBTComponent.BuilderblockNBT()Creates a block NBT component builder.static @NotNull BlockNBTComponentblockNBT(@NotNull String nbtPath, boolean interpret, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.static @NotNull BlockNBTComponentblockNBT(@NotNull String nbtPath, boolean interpret, @Nullable ComponentLike separator, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.static @NotNull BlockNBTComponentblockNBT(@NotNull String nbtPath, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.static @NotNull BlockNBTComponentblockNBT(@NotNull Consumer<? super BlockNBTComponent.Builder> consumer) Creates a block NBT component by applying configuration fromconsumer.children()Gets the unmodifiable list of children.@NotNull Componentchildren(@NotNull List<? extends ComponentLike> children) Sets the list of children.default @Nullable ClickEventGets the click event of this component.default @NotNull ComponentclickEvent(@Nullable ClickEvent event) Sets the click event of this component.default @Nullable TextColorcolor()Gets the color of this component.default @NotNull ComponentSets the color of this component.default @NotNull ComponentcolorIfAbsent(@Nullable TextColor color) Sets the color if there isn't one set already.default @NotNull Componentcompact()Create a new component with any redundant style elements or children removed.default voidcomponentBuilderApply(@NotNull ComponentBuilder<?, ?> component) Applies tocomponent.default booleanChecks if this component contains a component.default booleancontains(@NotNull Component that, @NotNull BiPredicate<? super Component, ? super Component> equals) Checks if this component contains a component.default @NotNull Componentdecorate(@NotNull TextDecoration decoration) Sets the state ofdecorationtoTextDecoration.State.TRUEon this component.default @NotNull TextDecoration.Statedecoration(@NotNull TextDecoration decoration) Gets the state of a decoration on this component.default @NotNull Componentdecoration(@NotNull TextDecoration decoration, boolean flag) Sets the state of a decoration on this component.default @NotNull Componentdecoration(@NotNull TextDecoration decoration, @NotNull TextDecoration.State state) Sets the value of a decoration on this component.default @NotNull ComponentdecorationIfAbsent(@NotNull TextDecoration decoration, @NotNull TextDecoration.State state) Sets the state of a decoration on this component tostateif the current state of the decoration isTextDecoration.State.NOT_SET.default @NotNull Map<TextDecoration,TextDecoration.State> Gets a set of decorations this component has.default @NotNull Componentdecorations(@NotNull Map<TextDecoration, TextDecoration.State> decorations) Sets decorations for this component's style using the specifieddecorationsmap.default voiddetectCycle(@NotNull Component that) Deprecated.static @NotNull TextComponentempty()Gets an empty component.static @NotNull EntityNBTComponent.BuilderCreates an entity NBT component builder.static @NotNull EntityNBTComponentCreates a entity NBT component with a position.static @NotNull EntityNBTComponententityNBT(@NotNull Consumer<? super EntityNBTComponent.Builder> consumer) Creates a entity NBT component by applying configuration fromconsumer.default @NotNull Stream<? extends net.kyori.examination.ExaminableProperty>default @Nullable Keyfont()Gets the font.default @NotNull ComponentSets the font.default booleanhasDecoration(@NotNull TextDecoration decoration) Tests if this component has a decoration.default booleanTests if this component has any styling.default @Nullable HoverEvent<?>Gets the hover event of this component.default @NotNull ComponenthoverEvent(@Nullable HoverEventSource<?> source) Sets the hover event of this component.default @Nullable StringGets the string to be inserted when this component is shift-clicked.default @NotNull ComponentSets the string to be inserted when this component is shift-clicked.iterable(@NotNull ComponentIteratorType type, @NotNull Set<ComponentIteratorFlag> flags) Returns an iterable view of this component.iterable(@NotNull ComponentIteratorType type, @NotNull ComponentIteratorFlag @Nullable ... flags) Returns an iterable view of this component.iterator(@NotNull ComponentIteratorType type, @NotNull Set<ComponentIteratorFlag> flags) Returns an iterator for this component.iterator(@NotNull ComponentIteratorType type, @NotNull ComponentIteratorFlag @Nullable ... flags) Returns an iterator for this component.static @NotNull TextComponentjoin(@NotNull ComponentLike separator, @NotNull ComponentLike @NotNull ... components) Deprecated.for removal since 4.9.0, usejoin(JoinConfiguration, ComponentLike...)withJoinConfiguration.separator(ComponentLike)instead.static @NotNull TextComponentjoin(@NotNull ComponentLike separator, Iterable<? extends ComponentLike> components) Deprecated.for removal since 4.9.0, usejoin(JoinConfiguration, Iterable)withJoinConfiguration.separator(ComponentLike)instead.static @NotNull Componentjoin(@NotNull JoinConfiguration.Builder configBuilder, @NotNull Iterable<? extends ComponentLike> components) Joinscomponentsusing the configuration inconfigBuilder.static @NotNull Componentjoin(@NotNull JoinConfiguration.Builder configBuilder, @NotNull ComponentLike @NotNull ... components) Joinscomponentsusing the configuration inconfigBuilder.static @NotNull Componentjoin(@NotNull JoinConfiguration config, @NotNull Iterable<? extends ComponentLike> components) Joinscomponentsusing the configuration inconfig.static @NotNull Componentjoin(@NotNull JoinConfiguration config, @NotNull ComponentLike @NotNull ... components) Joinscomponentsusing the configuration inconfig.static @NotNull KeybindComponent.Builderkeybind()Creates a keybind component builder.static @NotNull KeybindComponentCreates a keybind component with a keybind.static @NotNull KeybindComponentCreates a keybind component with a keybind and styling.static @NotNull KeybindComponentCreates a keybind component with a keybind, and optional color.static @NotNull KeybindComponentkeybind(@NotNull String keybind, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a keybind component with a keybind, and optional color and decorations.static @NotNull KeybindComponentkeybind(@NotNull String keybind, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a keybind component with a keybind, and optional color and decorations.static @NotNull KeybindComponentkeybind(@NotNull Consumer<? super KeybindComponent.Builder> consumer) Creates a keybind component by applying configuration fromconsumer.static @NotNull KeybindComponentkeybind(@NotNull KeybindComponent.KeybindLike keybind) Creates a keybind component with a keybind.static @NotNull KeybindComponentkeybind(@NotNull KeybindComponent.KeybindLike keybind, @NotNull Style style) Creates a keybind component with a keybind and styling.static @NotNull KeybindComponentkeybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable TextColor color) Creates a keybind component with a keybind, and optional color.static @NotNull KeybindComponentkeybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a keybind component with a keybind, and optional color and decorations.static @NotNull KeybindComponentkeybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a keybind component with a keybind, and optional color and decorations.default @NotNull ComponentmergeStyle(@NotNull Component that) Merges from another style into this component's style.default @NotNull ComponentmergeStyle(@NotNull Component that, @NotNull Set<Style.Merge> merges) Merges from another style into this component's style.default @NotNull ComponentmergeStyle(@NotNull Component that, @NotNull Style.Merge @NotNull ... merges) Merges from another style into this component's style.static @NotNull TextComponentnewline()Gets a text component with a new line character as the content.default @NotNull ComponentreplaceFirstText(@NotNull String search, @Nullable ComponentLike replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceFirstText(@NotNull Pattern pattern, @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull String search, @Nullable ComponentLike replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull String search, @Nullable ComponentLike replacement, int numberOfReplacements) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull String search, @Nullable ComponentLike replacement, @NotNull IntFunction2<PatternReplacementResult> fn) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull Consumer<TextReplacementConfig.Builder> configurer) Finds and replaces any text with this or childComponents using the configured options.default @NotNull ComponentreplaceText(@NotNull Pattern pattern, @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull Pattern pattern, @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement, int numberOfReplacements) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull Pattern pattern, @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement, @NotNull IntFunction2<PatternReplacementResult> fn) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.default @NotNull ComponentreplaceText(@NotNull TextReplacementConfig config) Finds and replaces any text with this or childComponents using the provided options.static @NotNull ScoreComponent.Builderscore()Creates a score component builder.static @NotNull ScoreComponentCreates a score component with a name and objective.static @NotNull ScoreComponentDeprecated.since 4.7.0, not for removal, with no replacement.static @NotNull ScoreComponentscore(@NotNull Consumer<? super ScoreComponent.Builder> consumer) Creates a score component by applying configuration fromconsumer.static @NotNull SelectorComponent.Builderselector()Creates a selector component builder.static @NotNull SelectorComponentCreates a selector component with a pattern.static @NotNull SelectorComponentselector(@NotNull String pattern, @Nullable ComponentLike separator) Creates a selector component with a pattern.static @NotNull SelectorComponentselector(@NotNull Consumer<? super SelectorComponent.Builder> consumer) Creates a selector component by applying configuration fromconsumer.default @Nullable ShadowColorGets the shadow color.default @NotNull ComponentshadowColor(@Nullable ARGBLike argb) Sets the shadow color of this component.default @NotNull ComponentshadowColorIfAbsent(@Nullable ARGBLike argb) Sets the shadow color if there isn't one set already.static @NotNull TextComponentspace()Gets a text immutable component with a single space as the content.default @NotNull Spliterator<Component>spliterator(@NotNull ComponentIteratorType type, @NotNull Set<ComponentIteratorFlag> flags) Returns a spliterator for this component.default @NotNull Spliterator<Component>spliterator(@NotNull ComponentIteratorType type, @NotNull ComponentIteratorFlag @Nullable ... flags) Returns a spliterator for this component.static @NotNull StorageNBTComponent.BuilderCreates an storage NBT component builder.static @NotNull StorageNBTComponentstorageNBT(@NotNull String nbtPath, boolean interpret, @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.static @NotNull StorageNBTComponentstorageNBT(@NotNull String nbtPath, boolean interpret, @Nullable ComponentLike separator, @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.static @NotNull StorageNBTComponentstorageNBT(@NotNull String nbtPath, @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.static @NotNull StorageNBTComponentstorageNBT(@NotNull Consumer<? super StorageNBTComponent.Builder> consumer) Creates a storage NBT component by applying configuration fromconsumer.@NotNull Stylestyle()Gets the style of this component.default @NotNull Componentstyle(@NotNull Consumer<Style.Builder> consumer) Sets the style of this component.default @NotNull Componentstyle(@NotNull Consumer<Style.Builder> consumer, @NotNull Style.Merge.Strategy strategy) Sets the style of this component.@NotNull ComponentSets the style of this component.default @NotNull Componentstyle(@NotNull Style.Builder style) Sets the style of this component.static @NotNull TextComponent.Buildertext()Creates a text component builder.static @NotNull TextComponenttext(boolean value) Creates a text component with the content ofString.valueOf(boolean).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(boolean)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(boolean), and optional color.static @NotNull TextComponenttext(boolean value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(boolean), and optional color and decorations.static @NotNull TextComponenttext(boolean value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(boolean), and optional color and decorations.static @NotNull TextComponenttext(char value) Creates a text component with the content ofString.valueOf(char).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(char)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(char), and optional color.static @NotNull TextComponenttext(char value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(char), and optional color and decorations.static @NotNull TextComponenttext(char value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(char), and optional color and decorations.static @NotNull TextComponenttext(double value) Creates a text component with the content ofString.valueOf(double).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(double)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(double), and optional color.static @NotNull TextComponenttext(double value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(double), and optional color and decorations.static @NotNull TextComponenttext(double value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(double), and optional color and decorations.static @NotNull TextComponenttext(float value) Creates a text component with the content ofString.valueOf(float).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(float)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(float), and optional color.static @NotNull TextComponenttext(float value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(float), and optional color and decorations.static @NotNull TextComponenttext(float value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(float), and optional color and decorations.static @NotNull TextComponenttext(int value) Creates a text component with the content ofString.valueOf(int).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(int)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(int), and optional color.static @NotNull TextComponenttext(int value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(int), and optional color and decorations.static @NotNull TextComponenttext(int value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(int), and optional color and decorations.static @NotNull TextComponenttext(long value) Creates a text component with the content ofString.valueOf(long).static @NotNull TextComponentCreates a text component with the content ofString.valueOf(long)and styling.static @NotNull TextComponentCreates a text component with the content ofString.valueOf(long), and optional color.static @NotNull TextComponenttext(long value, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(long), and optional color and decorations.static @NotNull TextComponenttext(long value, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(long), and optional color and decorations.static @NotNull TextComponentCreates a text component with content.static @NotNull TextComponentCreates a text component with content and styling.static @NotNull TextComponentCreates a text component with content, and optional color.static @NotNull TextComponenttext(@NotNull String content, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a text component with content, and optional color and decorations.static @NotNull TextComponenttext(@NotNull String content, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with content, and optional color and decorations.static @NotNull TextComponenttext(@NotNull Consumer<? super TextComponent.Builder> consumer) Creates a text component by applying configuration fromconsumer.static @NotNull TextComponenttextOfChildren(@NotNull ComponentLike @NotNull ... components) Creates a text component withcomponentsas the children.static @NotNull Collector<Component,? extends ComponentBuilder<?, ?>, Component> Create a collector that will join components without a separator.static @NotNull Collector<Component,? extends ComponentBuilder<?, ?>, Component> toComponent(@NotNull Component separator) Create a collector that will join components using the provided separator.static @NotNull TranslatableComponent.BuilderCreates a translatable component builder.static @NotNull TranslatableComponenttranslatable(@NotNull String key) Creates a translatable component with a translation key.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @NotNull Style style) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @NotNull Style style, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @NotNull Style style, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback) Creates a translatable component with a translation key and an optional fallback string.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull List<? extends ComponentLike> args, @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull List<? extends ComponentLike> args, @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull Style style) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull Style style, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable String fallback, @NotNull Style style, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color) Creates a translatable component with a translation key, and optional color.static TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a translatable component with a translation key, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color.static @NotNull TranslatableComponenttranslatable(@NotNull String key, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a translatable component with a translation key, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull Consumer<? super TranslatableComponent.Builder> consumer) Creates a translatable component by applying configuration fromconsumer.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable) Creates a translatable component with a translation key.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @NotNull Style style) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @NotNull Style style, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @NotNull Style style, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback) Creates a translatable component with a translation key and an optional fallback string.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull List<? extends ComponentLike> args, @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull List<? extends ComponentLike> args, @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull Style style) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull Style style, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, optional fallback string, and arguments.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable String fallback, @NotNull Style style, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and styling.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color) Creates a translatable component with a translation key, and optional color.static TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations) Creates a translatable component with a translation key, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations, @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, @NotNull Set<TextDecoration> decorations, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color and decorations.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color.static @NotNull TranslatableComponenttranslatable(@NotNull Translatable translatable, @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a translatable component with a translation key, and optional color and decorations.static <C> @NotNull VirtualComponentvirtual(@NotNull Class<C> contextType, @NotNull VirtualComponentRenderer<C> renderer) Creates a virtual component.static <C> @NotNull VirtualComponentvirtual(@NotNull Class<C> contextType, @NotNull VirtualComponentRenderer<C> renderer, @NotNull Iterable<StyleBuilderApplicable> style) Creates a virtual component with a value.static <C> @NotNull VirtualComponentvirtual(@NotNull Class<C> contextType, @NotNull VirtualComponentRenderer<C> renderer, @NotNull Style style) Creates a virtual component with a value.static <C> @NotNull VirtualComponentvirtual(@NotNull Class<C> contextType, @NotNull VirtualComponentRenderer<C> renderer, @NotNull StyleBuilderApplicable... style) Creates a virtual component with a value.Methods inherited from interface net.kyori.examination.Examinable
examinableName, examineMethods inherited from interface net.kyori.adventure.text.event.HoverEventSource
asHoverEventMethods inherited from interface net.kyori.adventure.text.format.StyleSetter
decorate, decorations
-
Field Details
-
EQUALS
A predicate that checks equality of twoComponents usingObjects.equals(Object, Object).- Since:
- 4.8.0
-
EQUALS_IDENTITY
A predicate that checks equality of twoComponents using identity equality.- Since:
- 4.8.0
-
IS_NOT_EMPTY
A predicate that excludesempty().- Since:
- 4.10.0
-
-
Method Details
-
empty
Gets an empty component.- Returns:
- an empty component
- Since:
- 4.0.0
-
newline
Gets a text component with a new line character as the content.- Returns:
- a text component with a new line character as the content
- Since:
- 4.0.0
-
space
Gets a text immutable component with a single space as the content.- Returns:
- a text component with a single space as the content
- Since:
- 4.0.0
-
join
@ScheduledForRemoval(inVersion="5.0.0") @Deprecated @Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent join(@NotNull @NotNull ComponentLike separator, @NotNull @NotNull ComponentLike @NotNull ... components) Deprecated.for removal since 4.9.0, usejoin(JoinConfiguration, ComponentLike...)withJoinConfiguration.separator(ComponentLike)instead.Joinscomponentsusingseparator.- Parameters:
separator- the separatorcomponents- the components- Returns:
- a text component
- Since:
- 4.0.0
-
join
@ScheduledForRemoval(inVersion="5.0.0") @Deprecated @Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent join(@NotNull @NotNull ComponentLike separator, Iterable<? extends ComponentLike> components) Deprecated.for removal since 4.9.0, usejoin(JoinConfiguration, Iterable)withJoinConfiguration.separator(ComponentLike)instead.Joinscomponentsusingseparator.- Parameters:
separator- the separatorcomponents- the components- Returns:
- a text component
- Since:
- 4.0.0
-
join
@Contract(pure=true) @NotNull static @NotNull Component join(@NotNull JoinConfiguration.Builder configBuilder, @NotNull @NotNull ComponentLike @NotNull ... components) Joinscomponentsusing the configuration inconfigBuilder.- Parameters:
configBuilder- the join configurationcomponents- the components- Returns:
- the resulting component
- Since:
- 4.14.0
- See Also:
-
join
@Contract(pure=true) @NotNull static @NotNull Component join(@NotNull JoinConfiguration.Builder configBuilder, @NotNull @NotNull Iterable<? extends ComponentLike> components) Joinscomponentsusing the configuration inconfigBuilder.- Parameters:
configBuilder- the join configurationcomponents- the components- Returns:
- the resulting component
- Since:
- 4.14.0
- See Also:
-
join
@Contract(pure=true) @NotNull static @NotNull Component join(@NotNull @NotNull JoinConfiguration config, @NotNull @NotNull ComponentLike @NotNull ... components) Joinscomponentsusing the configuration inconfig.- Parameters:
config- the join configurationcomponents- the components- Returns:
- the resulting component
- Since:
- 4.9.0
- See Also:
-
join
@Contract(pure=true) @NotNull static @NotNull Component join(@NotNull @NotNull JoinConfiguration config, @NotNull @NotNull Iterable<? extends ComponentLike> components) Joinscomponentsusing the configuration inconfig.- Parameters:
config- the join configurationcomponents- the components- Returns:
- the resulting component
- Since:
- 4.9.0
- See Also:
-
toComponent
@NotNull static @NotNull Collector<Component,? extends ComponentBuilder<?, toComponent()?>, Component> Create a collector that will join components without a separator.- Returns:
- a collector that can join components
- Since:
- 4.6.0
-
toComponent
@NotNull static @NotNull Collector<Component,? extends ComponentBuilder<?, toComponent?>, Component> (@NotNull @NotNull Component separator) Create a collector that will join components using the provided separator.- Parameters:
separator- the separator to join with- Returns:
- a collector that can join components
- Since:
- 4.6.0
-
blockNBT
Creates a block NBT component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
blockNBT
@Contract("_ -> new") @NotNull static @NotNull BlockNBTComponent blockNBT(@NotNull @NotNull Consumer<? super BlockNBTComponent.Builder> consumer) Creates a block NBT component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- a block NBT component
- Since:
- 4.0.0
-
blockNBT
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull BlockNBTComponent blockNBT(@NotNull @NotNull String nbtPath, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.- Parameters:
nbtPath- the nbt pathpos- the block position- Returns:
- a block NBT component
- Since:
- 4.0.0
-
blockNBT
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull BlockNBTComponent blockNBT(@NotNull @NotNull String nbtPath, boolean interpret, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.- Parameters:
nbtPath- the nbt pathinterpret- whether to interpretpos- the block position- Returns:
- a block NBT component
- Since:
- 4.0.0
-
blockNBT
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull BlockNBTComponent blockNBT(@NotNull @NotNull String nbtPath, boolean interpret, @Nullable @Nullable ComponentLike separator, @NotNull BlockNBTComponent.Pos pos) Creates a block NBT component with a position.- Parameters:
nbtPath- the nbt pathinterpret- whether to interpretseparator- the separatorpos- the block position- Returns:
- a block NBT component
- Since:
- 4.8.0
-
entityNBT
Creates an entity NBT component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
entityNBT
@Contract("_ -> new") @NotNull static @NotNull EntityNBTComponent entityNBT(@NotNull @NotNull Consumer<? super EntityNBTComponent.Builder> consumer) Creates a entity NBT component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- an entity NBT component
- Since:
- 4.0.0
-
entityNBT
@Contract("_, _ -> new") @NotNull static @NotNull EntityNBTComponent entityNBT(@NotNull @NotNull String nbtPath, @NotNull @NotNull String selector) Creates a entity NBT component with a position.- Parameters:
nbtPath- the nbt pathselector- the selector- Returns:
- an entity NBT component
- Since:
- 4.0.0
-
keybind
Creates a keybind component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
keybind
@Contract("_ -> new") @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull Consumer<? super KeybindComponent.Builder> consumer) Creates a keybind component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull String keybind) Creates a keybind component with a keybind.- Parameters:
keybind- the keybind- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull KeybindComponent.KeybindLike keybind) Creates a keybind component with a keybind.- Parameters:
keybind- the keybind- Returns:
- the keybind component
- Since:
- 4.9.0
-
keybind
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull String keybind, @NotNull @NotNull Style style) Creates a keybind component with a keybind and styling.- Parameters:
keybind- the keybindstyle- the style- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull KeybindComponent.KeybindLike keybind, @NotNull @NotNull Style style) Creates a keybind component with a keybind and styling.- Parameters:
keybind- the keybindstyle- the style- Returns:
- the keybind component
- Since:
- 4.9.0
-
keybind
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull String keybind, @Nullable @Nullable TextColor color) Creates a keybind component with a keybind, and optional color.- Parameters:
keybind- the keybindcolor- the color- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable @Nullable TextColor color) Creates a keybind component with a keybind, and optional color.- Parameters:
keybind- the keybindcolor- the color- Returns:
- the keybind component
- Since:
- 4.9.0
-
keybind
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull String keybind, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a keybind component with a keybind, and optional color and decorations.- Parameters:
keybind- the keybindcolor- the colordecorations- the decorations- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a keybind component with a keybind, and optional color and decorations.- Parameters:
keybind- the keybindcolor- the colordecorations- the decorations- Returns:
- the keybind component
- Since:
- 4.9.0
-
keybind
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull @NotNull String keybind, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a keybind component with a keybind, and optional color and decorations.- Parameters:
keybind- the keybindcolor- the colordecorations- the decorations- Returns:
- the keybind component
- Since:
- 4.0.0
-
keybind
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull KeybindComponent keybind(@NotNull KeybindComponent.KeybindLike keybind, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a keybind component with a keybind, and optional color and decorations.- Parameters:
keybind- the keybindcolor- the colordecorations- the decorations- Returns:
- the keybind component
- Since:
- 4.9.0
-
score
Creates a score component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
score
@Contract("_ -> new") @NotNull static @NotNull ScoreComponent score(@NotNull @NotNull Consumer<? super ScoreComponent.Builder> consumer) Creates a score component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- a score component
- Since:
- 4.0.0
-
score
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull ScoreComponent score(@NotNull @NotNull String name, @NotNull @NotNull String objective) Creates a score component with a name and objective.- Parameters:
name- the score nameobjective- the score objective- Returns:
- a score component
- Since:
- 4.0.0
-
score
@Contract(value="_, _, _ -> new", pure=true) @Deprecated @NotNull static @NotNull ScoreComponent score(@NotNull @NotNull String name, @NotNull @NotNull String objective, @Nullable @Nullable String value) Deprecated.since 4.7.0, not for removal, with no replacement. Thevaluefield is no longer supported in 1.16.5.Creates a score component with a name, objective, and optional value.- Parameters:
name- the score nameobjective- the score objectivevalue- the value- Returns:
- a score component
- Since:
- 4.0.0
-
selector
Creates a selector component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
selector
@Contract("_ -> new") @NotNull static @NotNull SelectorComponent selector(@NotNull @NotNull Consumer<? super SelectorComponent.Builder> consumer) Creates a selector component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- a selector component
- Since:
- 4.0.0
-
selector
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull SelectorComponent selector(@NotNull @NotNull String pattern) Creates a selector component with a pattern.- Parameters:
pattern- the selector pattern- Returns:
- a selector component
- Since:
- 4.0.0
-
selector
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull SelectorComponent selector(@NotNull @NotNull String pattern, @Nullable @Nullable ComponentLike separator) Creates a selector component with a pattern.- Parameters:
pattern- the selector patternseparator- the separator- Returns:
- a selector component
- Since:
- 4.8.0
-
storageNBT
Creates an storage NBT component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
storageNBT
@Contract("_ -> new") @NotNull static @NotNull StorageNBTComponent storageNBT(@NotNull @NotNull Consumer<? super StorageNBTComponent.Builder> consumer) Creates a storage NBT component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- a storage NBT component
- Since:
- 4.0.0
-
storageNBT
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull StorageNBTComponent storageNBT(@NotNull @NotNull String nbtPath, @NotNull @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.- Parameters:
nbtPath- the nbt pathstorage- the identifier of the storage- Returns:
- a storage NBT component
- Since:
- 4.0.0
-
storageNBT
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull StorageNBTComponent storageNBT(@NotNull @NotNull String nbtPath, boolean interpret, @NotNull @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.- Parameters:
nbtPath- the nbt pathinterpret- whether to interpretstorage- the identifier of the storage- Returns:
- a storage NBT component
- Since:
- 4.0.0
-
storageNBT
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull StorageNBTComponent storageNBT(@NotNull @NotNull String nbtPath, boolean interpret, @Nullable @Nullable ComponentLike separator, @NotNull @NotNull Key storage) Creates a storage NBT component with a path and an storage ID.- Parameters:
nbtPath- the nbt pathinterpret- whether to interpretseparator- the separatorstorage- the identifier of the storage- Returns:
- a storage NBT component
- Since:
- 4.8.0
-
text
Creates a text component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
textOfChildren
@NotNull static @NotNull TextComponent textOfChildren(@NotNull @NotNull ComponentLike @NotNull ... components) Creates a text component withcomponentsas the children.- Parameters:
components- the children- Returns:
- a text component
- Since:
- 4.10.0
-
text
@Contract("_ -> new") @NotNull static @NotNull TextComponent text(@NotNull @NotNull Consumer<? super TextComponent.Builder> consumer) Creates a text component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- the text component
- Since:
- 4.0.0
-
text
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull TextComponent text(@NotNull @NotNull String content) Creates a text component with content.- Parameters:
content- the plain text content- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(@NotNull @NotNull String content, @NotNull @NotNull Style style) Creates a text component with content and styling.- Parameters:
content- the plain text contentstyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(@NotNull @NotNull String content, @Nullable @Nullable TextColor color) Creates a text component with content, and optional color.- Parameters:
content- the plain text contentcolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(@NotNull @NotNull String content, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with content, and optional color and decorations.- Parameters:
content- the plain text contentcolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(@NotNull @NotNull String content, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with content, and optional color and decorations.- Parameters:
content- the plain text contentcolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(boolean).- Parameters:
value- the boolean value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(boolean value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(boolean)and styling.- Parameters:
value- the boolean valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(boolean value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(boolean), and optional color.- Parameters:
value- the boolean valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(boolean value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(boolean), and optional color and decorations.- Parameters:
value- the boolean valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(boolean value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(boolean), and optional color and decorations.- Parameters:
value- the boolean valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(char).- Parameters:
value- the char value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(char value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(char)and styling.- Parameters:
value- the char valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(char value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(char), and optional color.- Parameters:
value- the char valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(char value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(char), and optional color and decorations.- Parameters:
value- the char valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(char value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(char), and optional color and decorations.- Parameters:
value- the char valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(double).- Parameters:
value- the double value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(double value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(double)and styling.- Parameters:
value- the double valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(double value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(double), and optional color.- Parameters:
value- the double valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(double value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(double), and optional color and decorations.- Parameters:
value- the double valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(double value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(double), and optional color and decorations.- Parameters:
value- the double valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(float).- Parameters:
value- the float value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(float value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(float)and styling.- Parameters:
value- the float valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(float value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(float), and optional color.- Parameters:
value- the float valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(float value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(float), and optional color and decorations.- Parameters:
value- the float valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(float value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(float), and optional color and decorations.- Parameters:
value- the float valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(int).- Parameters:
value- the int value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(int value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(int)and styling.- Parameters:
value- the int valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(int value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(int), and optional color.- Parameters:
value- the int valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(int value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(int), and optional color and decorations.- Parameters:
value- the int valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(int value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(int), and optional color and decorations.- Parameters:
value- the int valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
Creates a text component with the content ofString.valueOf(long).- Parameters:
value- the long value- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(long value, @NotNull @NotNull Style style) Creates a text component with the content ofString.valueOf(long)and styling.- Parameters:
value- the long valuestyle- the style- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(long value, @Nullable @Nullable TextColor color) Creates a text component with the content ofString.valueOf(long), and optional color.- Parameters:
value- the long valuecolor- the color- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(long value, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a text component with the content ofString.valueOf(long), and optional color and decorations.- Parameters:
value- the long valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
text
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TextComponent text(long value, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a text component with the content ofString.valueOf(long), and optional color and decorations.- Parameters:
value- the long valuecolor- the colordecorations- the decorations- Returns:
- a text component
- Since:
- 4.0.0
-
virtual
@Contract(value="_, _ -> new", pure=true) @NotNull static <C> @NotNull VirtualComponent virtual(@NotNull @NotNull Class<C> contextType, @NotNull @NotNull VirtualComponentRenderer<C> renderer) Creates a virtual component.- Type Parameters:
C- the context type- Parameters:
contextType- the context typerenderer- the renderer- Returns:
- a virtual component
- Since:
- 4.18.0
-
virtual
@Contract(value="_, _, _ -> new", pure=true) @NotNull static <C> @NotNull VirtualComponent virtual(@NotNull @NotNull Class<C> contextType, @NotNull @NotNull VirtualComponentRenderer<C> renderer, @NotNull @NotNull Style style) Creates a virtual component with a value.- Type Parameters:
C- the context type- Parameters:
contextType- the context typerenderer- the rendererstyle- the style- Returns:
- a virtual component
- Since:
- 4.18.0
-
virtual
@Contract(value="_, _, _ -> new", pure=true) @NotNull static <C> @NotNull VirtualComponent virtual(@NotNull @NotNull Class<C> contextType, @NotNull @NotNull VirtualComponentRenderer<C> renderer, @NotNull @NotNull StyleBuilderApplicable... style) Creates a virtual component with a value.- Type Parameters:
C- the context type- Parameters:
contextType- the context typerenderer- the rendererstyle- the style elements- Returns:
- a virtual component
- Since:
- 4.18.0
-
virtual
@Contract(value="_, _, _ -> new", pure=true) @NotNull static <C> @NotNull VirtualComponent virtual(@NotNull @NotNull Class<C> contextType, @NotNull @NotNull VirtualComponentRenderer<C> renderer, @NotNull @NotNull Iterable<StyleBuilderApplicable> style) Creates a virtual component with a value.- Type Parameters:
C- the context type- Parameters:
contextType- the context typerenderer- the rendererstyle- the style elements- Returns:
- a virtual component
- Since:
- 4.18.0
-
translatable
Creates a translatable component builder.- Returns:
- a builder
- Since:
- 4.0.0
-
translatable
@Contract("_ -> new") @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Consumer<? super TranslatableComponent.Builder> consumer) Creates a translatable component by applying configuration fromconsumer.- Parameters:
consumer- the builder configurator- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key) Creates a translatable component with a translation key.- Parameters:
key- the translation key- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable) Creates a translatable component with a translation key.- Parameters:
translatable- the translatable object to get the key from- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback) Creates a translatable component with a translation key and an optional fallback string.- Parameters:
key- the translation keyfallback- the fallback string- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback) Creates a translatable component with a translation key and an optional fallback string.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback string- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @NotNull @NotNull Style style) Creates a translatable component with a translation key and styling.- Parameters:
key- the translation keystyle- the style- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @NotNull @NotNull Style style) Creates a translatable component with a translation key and styling.- Parameters:
translatable- the translatable object to get the key fromstyle- the style- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull Style style) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
key- the translation keyfallback- the fallback stringstyle- the style- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull Style style) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringstyle- the style- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
key- the translation keyfallback- the fallback stringstyle- the style- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringstyle- the style- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
key- the translation keyfallback- the fallback stringargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull Style style, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
key- the translation keyfallback- the fallback stringstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull Style style, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, optional fallback string, and styling.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.13.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull Style style, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
key- the translation keyfallback- the fallback stringstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull Style style, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull List<? extends ComponentLike> args, @NotNull @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
key- the translation keyfallback- the fallback stringargs- the translation argumentsstyle- the style- Returns:
- a translatable component
- Since:
- 4.0.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull List<? extends ComponentLike> args, @NotNull @NotNull Iterable<StyleBuilderApplicable> style) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringargs- the translation argumentsstyle- the style- Returns:
- a translatable component
- Since:
- 4.8.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable String fallback, @NotNull @NotNull List<? extends ComponentLike> args, @NotNull @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
key- the translation keyfallback- the fallback stringargs- the translation argumentsstyle- the style- Returns:
- a translatable component
- Since:
- 4.0.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable String fallback, @NotNull @NotNull List<? extends ComponentLike> args, @NotNull @NotNull StyleBuilderApplicable... style) Creates a translatable component with a translation key, optional fallback string, and arguments.- Parameters:
translatable- the translatable object to get the key fromfallback- the fallback stringargs- the translation argumentsstyle- the style- Returns:
- a translatable component
- Since:
- 4.8.0
- Since Minecraft:
- 1.19.4
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color) Creates a translatable component with a translation key, and optional color.- Parameters:
key- the translation keycolor- the color- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color) Creates a translatable component with a translation key, and optional color.- Parameters:
translatable- the translatable object to get the key fromcolor- the color- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a translatable component with a translation key, and optional color and decorations.- Parameters:
key- the translation keycolor- the colordecorations- the decorations- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations) Creates a translatable component with a translation key, and optional color and decorations.- Parameters:
translatable- the translatable object to get the key fromcolor- the colordecorations- the decorations- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a translatable component with a translation key, and optional color and decorations.- Parameters:
key- the translation keycolor- the colordecorations- the decorations- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations) Creates a translatable component with a translation key, and optional color and decorations.- Parameters:
translatable- the translatable object to get the key fromcolor- the colordecorations- the decorations- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and arguments.- Parameters:
key- the translation keyargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and arguments.- Parameters:
translatable- the translatable object to get the key fromargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @NotNull @NotNull Style style, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and styling.- Parameters:
key- the translation keystyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @NotNull @NotNull Style style, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key and styling.- Parameters:
translatable- the translatable object to get the key fromstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color.- Parameters:
key- the translation keycolor- the colorargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color.- Parameters:
translatable- the translatable object to get the key fromcolor- the colorargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color and decorations.- Parameters:
key- the translation keycolor- the colordecorations- the decorationsargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations, @NotNull @NotNull ComponentLike @NotNull ... args) Creates a translatable component with a translation key, arguments, and optional color and decorations.- Parameters:
translatable- the translatable object to get the key fromcolor- the colordecorations- the decorationsargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and arguments.- Parameters:
key- the translation keyargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and arguments.- Parameters:
translatable- the translatable object to get the key fromargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @NotNull @NotNull Style style, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and styling.- Parameters:
key- the translation keystyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @NotNull @NotNull Style style, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key and styling.- Parameters:
translatable- the translatable object to get the key fromstyle- the styleargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) static TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color.- Parameters:
key- the translation keycolor- the colorargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _ -> new", pure=true) static TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color.- Parameters:
translatable- the translatable object to get the key fromcolor- the colorargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull String key, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color and decorations.- Parameters:
key- the translation keycolor- the colordecorations- the decorationsargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.0.0
-
translatable
@Contract(value="_, _, _, _ -> new", pure=true) @NotNull static @NotNull TranslatableComponent translatable(@NotNull @NotNull Translatable translatable, @Nullable @Nullable TextColor color, @NotNull @NotNull Set<TextDecoration> decorations, @NotNull @NotNull List<? extends ComponentLike> args) Creates a translatable component with a translation key, arguments, and optional color and decorations.- Parameters:
translatable- the translatable object to get the key fromcolor- the colordecorations- the decorationsargs- the translation arguments- Returns:
- a translatable component
- Since:
- 4.8.0
-
children
Gets the unmodifiable list of children.- Returns:
- the unmodifiable list of children
- Since:
- 4.0.0
-
children
@Contract(pure=true) @NotNull @NotNull Component children(@NotNull @NotNull List<? extends ComponentLike> children) Sets the list of children.The contents of
childrenwill be copied.- Parameters:
children- the children- Returns:
- a component with the children set
- Since:
- 4.0.0
-
contains
Checks if this component contains a component.This method uses identity comparison when checking for contains. Use
contains(Component, BiPredicate)withEQUALSif you wish to use full equality comparison.- Parameters:
that- the other component- Returns:
trueif this component contains the provided component,falseotherwise- Since:
- 4.0.0
-
contains
default boolean contains(@NotNull @NotNull Component that, @NotNull @NotNull BiPredicate<? super Component, ? super Component> equals) Checks if this component contains a component.- Parameters:
that- the other componentequals- the equality tester- Returns:
trueif this component contains the provided component,falseotherwise- Since:
- 4.8.0
-
detectCycle
@ScheduledForRemoval(inVersion="5.0.0") @Deprecated default void detectCycle(@NotNull @NotNull Component that) Deprecated.for removal since 4.7.0, with no replacement - this method is not necessary due to the factComponents are immutablePrevents a cycle between this component and the provided component.- Parameters:
that- the other component- Since:
- 4.0.0
-
append
@Contract(pure=true) @NotNull default @NotNull Component append(@NotNull @NotNull Component component) Appends a component to this component.- Parameters:
component- the component to append- Returns:
- a component with the component added
- Since:
- 4.0.0
-
append
Appends a component to this component.- Parameters:
like- the component to append- Returns:
- a component with the component added
- Since:
- 4.0.0
-
append
@Contract(pure=true) @NotNull default @NotNull Component append(@NotNull @NotNull ComponentBuilder<?, ?> builder) Appends a component to this component.- Parameters:
builder- the component to append- Returns:
- a component with the component added
- Since:
- 4.0.0
-
appendNewline
Appends a newline to this component.- Returns:
- a component with the newline added
- Since:
- 4.12.0
-
appendSpace
Appends a space to this component.- Returns:
- a component with the space added
- Since:
- 4.12.0
-
append
@Contract(pure=true) @NotNull default @NotNull Component append(@NotNull @NotNull ComponentLike @NotNull ... components) Appends components to this component.- Parameters:
components- the children to add- Returns:
- a component with the children added to the existing children
- Since:
- 4.20.0
-
append
@Contract(pure=true) @NotNull default @NotNull Component append(@NotNull @NotNull List<? extends ComponentLike> components) Appends a list of components to this component.- Parameters:
components- the children to add- Returns:
- a component with the children added to the existing children
- Since:
- 4.20.0
-
applyFallbackStyle
@Contract(pure=true) @NotNull default @NotNull Component applyFallbackStyle(@NotNull @NotNull Style style) Apply a fallback style for this component and its children.This method can be used to set the "default" style for a component, whilst still allowing children of the component to override the style.
- Parameters:
style- style to be used as a fallback- Returns:
- the styled component
- Since:
- 4.10.0
-
applyFallbackStyle
@Contract(pure=true) @NotNull default @NotNull Component applyFallbackStyle(@NotNull @NotNull StyleBuilderApplicable @NotNull ... style) Apply a fallback style for this component and its children.This method can be used to set the "default" style for a component, whilst still allowing children of the component to override the style.
- Parameters:
style- style to be used as a fallback- Returns:
- the styled component
- Since:
- 4.10.0
-
style
Gets the style of this component.- Returns:
- the style of this component
- Since:
- 4.0.0
-
style
Sets the style of this component.- Parameters:
style- the style- Returns:
- a component
- Since:
- 4.0.0
-
style
@Contract(pure=true) @NotNull default @NotNull Component style(@NotNull @NotNull Consumer<Style.Builder> consumer) Sets the style of this component.- Parameters:
consumer- the style consumer- Returns:
- a component
- Since:
- 4.0.0
-
style
@Contract(pure=true) @NotNull default @NotNull Component style(@NotNull @NotNull Consumer<Style.Builder> consumer, @NotNull Style.Merge.Strategy strategy) Sets the style of this component.- Parameters:
consumer- the style consumerstrategy- the merge strategy- Returns:
- a component
- Since:
- 4.0.0
-
style
Sets the style of this component.- Parameters:
style- the style- Returns:
- a component
- Since:
- 4.0.0
-
mergeStyle
@Contract(pure=true) @NotNull default @NotNull Component mergeStyle(@NotNull @NotNull Component that) Merges from another style into this component's style.- Parameters:
that- the other style- Returns:
- a component
- Since:
- 4.0.0
-
mergeStyle
@Contract(pure=true) @NotNull default @NotNull Component mergeStyle(@NotNull @NotNull Component that, @NotNull Style.Merge @NotNull ... merges) Merges from another style into this component's style.- Parameters:
that- the other stylemerges- the style parts to merge- Returns:
- a component
- Since:
- 4.0.0
-
mergeStyle
@Contract(pure=true) @NotNull default @NotNull Component mergeStyle(@NotNull @NotNull Component that, @NotNull @NotNull Set<Style.Merge> merges) Merges from another style into this component's style.- Parameters:
that- the other stylemerges- the style parts to merge- Returns:
- a component
- Since:
- 4.0.0
-
font
Gets the font.- Specified by:
fontin interfaceStyleGetter- Returns:
- the font of this component
- Since:
- 4.10.0
-
font
Sets the font.- Specified by:
fontin interfaceStyleSetter<Component>- Parameters:
key- a font- Returns:
- a component
- Since:
- 4.10.0
-
color
Gets the color of this component.- Specified by:
colorin interfaceStyleGetter- Returns:
- the color of this component
- Since:
- 4.0.0
-
shadowColor
Description copied from interface:StyleGetterGets the shadow color.- Specified by:
shadowColorin interfaceStyleGetter- Returns:
- the shadow color
-
color
Sets the color of this component.- Specified by:
colorin interfaceStyleSetter<Component>- Parameters:
color- the color- Returns:
- a component
- Since:
- 4.0.0
-
colorIfAbsent
@Contract(pure=true) @NotNull default @NotNull Component colorIfAbsent(@Nullable @Nullable TextColor color) Sets the color if there isn't one set already.- Specified by:
colorIfAbsentin interfaceStyleSetter<Component>- Parameters:
color- the color- Returns:
- a component
- Since:
- 4.0.0
-
shadowColor
@Contract(pure=true) @NotNull default @NotNull Component shadowColor(@Nullable @Nullable ARGBLike argb) Sets the shadow color of this component.- Specified by:
shadowColorin interfaceStyleSetter<Component>- Parameters:
argb- the color- Returns:
- a component
- Since:
- 4.18.0
-
shadowColorIfAbsent
@Contract(pure=true) @NotNull default @NotNull Component shadowColorIfAbsent(@Nullable @Nullable ARGBLike argb) Sets the shadow color if there isn't one set already.- Specified by:
shadowColorIfAbsentin interfaceStyleSetter<Component>- Parameters:
argb- the color- Returns:
- a component
- Since:
- 4.18.0
-
hasDecoration
Tests if this component has a decoration.- Specified by:
hasDecorationin interfaceStyleGetter- Parameters:
decoration- the decoration- Returns:
trueif this component has the decoration,falseif this component does not have the decoration- Since:
- 4.0.0
-
decorate
@Contract(pure=true) @NotNull default @NotNull Component decorate(@NotNull @NotNull TextDecoration decoration) Sets the state ofdecorationtoTextDecoration.State.TRUEon this component.- Specified by:
decoratein interfaceStyleSetter<Component>- Parameters:
decoration- the decoration- Returns:
- a component
- Since:
- 4.0.0
-
decoration
Gets the state of a decoration on this component.- Specified by:
decorationin interfaceStyleGetter- Parameters:
decoration- the decoration- Returns:
TextDecoration.State.TRUEif this component has the decoration,TextDecoration.State.FALSEif this component does not have the decoration, andTextDecoration.State.NOT_SETif not set- Since:
- 4.0.0
-
decoration
@Contract(pure=true) @NotNull default @NotNull Component decoration(@NotNull @NotNull TextDecoration decoration, boolean flag) Sets the state of a decoration on this component.- Specified by:
decorationin interfaceStyleSetter<Component>- Parameters:
decoration- the decorationflag-trueif this component should have the decoration,falseif this component should not have the decoration- Returns:
- a component
- Since:
- 4.0.0
-
decoration
@Contract(pure=true) @NotNull default @NotNull Component decoration(@NotNull @NotNull TextDecoration decoration, @NotNull TextDecoration.State state) Sets the value of a decoration on this component.- Specified by:
decorationin interfaceStyleSetter<Component>- Parameters:
decoration- the decorationstate-TextDecoration.State.TRUEif this component should have the decoration,TextDecoration.State.FALSEif this component should not have the decoration, andTextDecoration.State.NOT_SETif the decoration should not have a set value- Returns:
- a component
- Since:
- 4.0.0
-
decorationIfAbsent
@NotNull default @NotNull Component decorationIfAbsent(@NotNull @NotNull TextDecoration decoration, @NotNull TextDecoration.State state) Sets the state of a decoration on this component tostateif the current state of the decoration isTextDecoration.State.NOT_SET.- Specified by:
decorationIfAbsentin interfaceStyleSetter<Component>- Parameters:
decoration- the decorationstate- the state- Returns:
- a component
- Since:
- 4.12.0
-
decorations
Gets a set of decorations this component has.- Specified by:
decorationsin interfaceStyleGetter- Returns:
- a set of decorations this component has
- Since:
- 4.0.0
-
decorations
@Contract(pure=true) @NotNull default @NotNull Component decorations(@NotNull @NotNull Map<TextDecoration, TextDecoration.State> decorations) Sets decorations for this component's style using the specifieddecorationsmap.If a given decoration does not have a value explicitly set, the value of that particular decoration is not changed.
- Specified by:
decorationsin interfaceStyleSetter<Component>- Parameters:
decorations- a set of default values- Returns:
- a component
- Since:
- 4.0.0
-
clickEvent
Gets the click event of this component.- Specified by:
clickEventin interfaceStyleGetter- Returns:
- the click event
- Since:
- 4.0.0
-
clickEvent
@Contract(pure=true) @NotNull default @NotNull Component clickEvent(@Nullable @Nullable ClickEvent event) Sets the click event of this component.- Specified by:
clickEventin interfaceStyleSetter<Component>- Parameters:
event- the click event- Returns:
- a component
- Since:
- 4.0.0
-
hoverEvent
Gets the hover event of this component.- Specified by:
hoverEventin interfaceStyleGetter- Returns:
- the hover event
- Since:
- 4.0.0
-
hoverEvent
@Contract(pure=true) @NotNull default @NotNull Component hoverEvent(@Nullable @Nullable HoverEventSource<?> source) Sets the hover event of this component.- Specified by:
hoverEventin interfaceStyleSetter<Component>- Parameters:
source- the hover event source- Returns:
- a component
- Since:
- 4.0.0
-
insertion
Gets the string to be inserted when this component is shift-clicked.- Specified by:
insertionin interfaceStyleGetter- Returns:
- the insertion string
- Since:
- 4.0.0
-
insertion
@Contract(pure=true) @NotNull default @NotNull Component insertion(@Nullable @Nullable String insertion) Sets the string to be inserted when this component is shift-clicked.- Specified by:
insertionin interfaceStyleSetter<Component>- Parameters:
insertion- the insertion string- Returns:
- a component
- Since:
- 4.0.0
-
hasStyling
default boolean hasStyling()Tests if this component has any styling.- Returns:
trueif this component has any styling,falseif this component does not have any styling- Since:
- 4.0.0
-
replaceText
@Contract(pure=true) @NotNull default @NotNull Component replaceText(@NotNull @NotNull Consumer<TextReplacementConfig.Builder> configurer) Finds and replaces any text with this or childComponents using the configured options.- Parameters:
configurer- the configurer- Returns:
- a modified copy of this component
- Since:
- 4.2.0
-
replaceText
@Contract(pure=true) @NotNull default @NotNull Component replaceText(@NotNull @NotNull TextReplacementConfig config) Finds and replaces any text with this or childComponents using the provided options.- Parameters:
config- the replacement config- Returns:
- a modified copy of this component
- Since:
- 4.2.0
-
compact
Create a new component with any redundant style elements or children removed.- Returns:
- the optimized component
- Since:
- 4.9.0
-
iterable
@NotNull default @NotNull Iterable<Component> iterable(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull ComponentIteratorFlag @Nullable ... flags) Returns an iterable view of this component.- Parameters:
type- the typeflags- the flags- Returns:
- the iterable
- Since:
- 4.9.0
-
iterable
@NotNull default @NotNull Iterable<Component> iterable(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull Set<ComponentIteratorFlag> flags) Returns an iterable view of this component.- Parameters:
type- the typeflags- the flags- Returns:
- the iterable
- Since:
- 4.9.0
-
iterator
@NotNull default @NotNull Iterator<Component> iterator(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull ComponentIteratorFlag @Nullable ... flags) Returns an iterator for this component.As components are immutable, this iterator does not support removal.
- Parameters:
type- the typeflags- the flags- Returns:
- the iterator
- Since:
- 4.9.0
-
iterator
@NotNull default @NotNull Iterator<Component> iterator(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull Set<ComponentIteratorFlag> flags) Returns an iterator for this component.As components are immutable, this iterator does not support removal.
- Parameters:
type- the typeflags- the flags- Returns:
- the iterator
- Since:
- 4.9.0
-
spliterator
@NotNull default @NotNull Spliterator<Component> spliterator(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull ComponentIteratorFlag @Nullable ... flags) Returns a spliterator for this component.The resulting spliterator has the
Spliterator.IMMUTABLE,Spliterator.NONNULLandSpliterator.ORDEREDcharacteristics.- Parameters:
type- the typeflags- the flags- Returns:
- the spliterator
- Since:
- 4.9.0
-
spliterator
@NotNull default @NotNull Spliterator<Component> spliterator(@NotNull @NotNull ComponentIteratorType type, @NotNull @NotNull Set<ComponentIteratorFlag> flags) Returns a spliterator for this component.The resulting spliterator has the
Spliterator.IMMUTABLE,Spliterator.NONNULLandSpliterator.ORDEREDcharacteristics.- Parameters:
type- the typeflags- the flags- Returns:
- the spliterator
- Since:
- 4.9.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull String search, @Nullable @Nullable ComponentLike replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replaces text within anyComponents using a string literal.- Parameters:
search- a string literalreplacement- aComponentLiketo replace each match- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull Pattern pattern, @NotNull @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replaces text within anyTextComponents using a regex pattern.- Parameters:
pattern- a regex patternreplacement- a function to replace each match- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceFirstText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceFirstText(@NotNull @NotNull String search, @Nullable @Nullable ComponentLike replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replaces the first occurrence of text within anyComponents using a string literal.- Parameters:
search- a string literalreplacement- aComponentLiketo replace the first match- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceFirstText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceFirstText(@NotNull @NotNull Pattern pattern, @NotNull @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replaces the first occurrence of text within anyTextComponents using a regex pattern.- Parameters:
pattern- a regex patternreplacement- a function to replace the first match- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull String search, @Nullable @Nullable ComponentLike replacement, int numberOfReplacements) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replacesninstances of text within anyTextComponents using a string literal.- Parameters:
search- a string literalreplacement- aComponentLiketo replace the first matchnumberOfReplacements- the amount of matches that should be replaced- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull Pattern pattern, @NotNull @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement, int numberOfReplacements) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replacesninstances of text within anyTextComponents using a regex pattern.- Parameters:
pattern- a regex patternreplacement- a function to replace each matchnumberOfReplacements- the amount of matches that should be replaced- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull String search, @Nullable @Nullable ComponentLike replacement, @NotNull @NotNull IntFunction2<PatternReplacementResult> fn) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replacesninstances of text within anyTextComponents using a string literal.Utilises an
IntFunction2to determine if each instance should be replaced.- Parameters:
search- a string literalreplacement- aComponentLiketo replace the first matchfn- a function of (index, replaced) used to determine if matches should be replaced, where "replaced" is the number of successful replacements- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
replaceText
@ScheduledForRemoval(inVersion="5.0.0") @Contract(pure=true) @Deprecated @NotNull default @NotNull Component replaceText(@NotNull @NotNull Pattern pattern, @NotNull @NotNull Function<TextComponent.Builder, @Nullable ComponentLike> replacement, @NotNull @NotNull IntFunction2<PatternReplacementResult> fn) Deprecated.for removal since 4.2.0, usereplaceText(Consumer)orreplaceText(TextReplacementConfig)instead.Finds and replaces text using a regex pattern.Utilises an
IntFunction2to determine if each instance should be replaced.- Parameters:
pattern- a regex patternreplacement- a function to replace the first matchfn- a function of (index, replaced) used to determine if matches should be replaced, where "replaced" is the number of successful replacements- Returns:
- a modified copy of this component
- Since:
- 4.0.0
-
componentBuilderApply
Description copied from interface:ComponentBuilderApplicableApplies tocomponent.- Specified by:
componentBuilderApplyin interfaceComponentBuilderApplicable- Parameters:
component- the component builder
-
asComponent
Description copied from interface:ComponentLikeGets aComponentrepresentation.- Specified by:
asComponentin interfaceComponentLike- Returns:
- a component
-
asHoverEvent
@NotNull default @NotNull HoverEvent<Component> asHoverEvent(@NotNull @NotNull UnaryOperator<Component> op) Description copied from interface:HoverEventSourceCreates a hover event with value derived from this object.The event value will be passed through the provided callback to allow transforming the original value of the event.
- Specified by:
asHoverEventin interfaceHoverEventSource<Component>- Parameters:
op- transformation on value- Returns:
- a hover event
-
examinableProperties
@NotNull default @NotNull Stream<? extends net.kyori.examination.ExaminableProperty> examinableProperties()- Specified by:
examinablePropertiesin interfacenet.kyori.examination.Examinable
-
Components are immutable