Package net.kyori.adventure.text.format

Interface Style

All Superinterfaces:
Buildable<Style,Style.Builder>, net.kyori.examination.Examinable, StyleGetter, StyleSetter<Style>
@NonExtendable public interface Style extends Buildable<Style,Style.Builder>, net.kyori.examination.Examinable, StyleGetter, StyleSetter<Style>
A style applies visual effects or extra functionality to Components, such as TextColors, TextDecorations, ClickEvents etc.

Some examples of valid styles:

     Style myStyle = Style.style(ClickEvent.openUrl(url), NamedTextColor.RED, TextDecoration.BOLD);
     Style yourStyle = Style.style(TextColor.color(20, 30, 40), HoverEvent.showText(Component.text("Wow!"));
     Style ourStyle = Style.style().color(NamedTextColor.WHITE).build();

A note about fonts: the Key in this context represents the resource location of the font in the same way as Sounds

Since:
4.0.0

  • Field Details

    • DEFAULT_FONT

      static final Key DEFAULT_FONT
      The default font.
      Since:
      4.0.0
      Since Minecraft:
      1.16

  • Method Details

    • empty

      @NotNull static @NotNull Style empty()
      Gets an empty style.
      Returns:
      empty style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style.Builder style()
      Creates a builder.
      Returns:
      a builder
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@NotNull @NotNull Consumer<Style.Builder> consumer)
      Creates a style.
      Parameters:
      consumer - the builder consumer
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@Nullable @Nullable TextColor color)
      Creates a style with color.
      Parameters:
      color - the style
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@NotNull @NotNull TextDecoration decoration)
      Creates a style with decoration.
      Parameters:
      decoration - the decoration
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@Nullable @Nullable TextColor color, TextDecoration @NotNull ... decorations)
      Creates a style with color and decorations.
      Parameters:
      color - the style
      decorations - the decorations
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@Nullable @Nullable TextColor color, Set<TextDecoration> decorations)
      Creates a style with color and decorations.
      Parameters:
      color - the style
      decorations - the decorations
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@UnknownNullability StyleBuilderApplicable @NotNull ... applicables)
      Creates a style with applicables applied.
      Parameters:
      applicables - the applicables
      Returns:
      a style
      Since:
      4.0.0

    • style

      @NotNull static @NotNull Style style(@NotNull @NotNull Iterable<? extends StyleBuilderApplicable> applicables)
      Creates a style with applicables applied.
      Parameters:
      applicables - the applicables
      Returns:
      a style
      Since:
      4.0.0

    • edit

      @NotNull default @NotNull Style edit(@NotNull @NotNull Consumer<Style.Builder> consumer)
      Edits this style.

      The old style will be merge into the new style before consumer is called.

      Parameters:
      consumer - the consumer
      Returns:
      a new style
      Since:
      4.0.0

    • edit

      @NotNull default @NotNull Style edit(@NotNull @NotNull Consumer<Style.Builder> consumer, @NotNull Style.Merge.Strategy strategy)
      Edits this style.
      Parameters:
      consumer - the consumer
      strategy - the merge strategy
      Returns:
      a new style
      Since:
      4.0.0

    • font

      @Nullable @Nullable Key font()
      Gets the font.
      Specified by:
      font in interface StyleGetter
      Returns:
      the font
      Since:
      4.0.0
      Since Minecraft:
      1.16

    • font

      @NotNull @NotNull Style font(@Nullable @Nullable Key font)
      Sets the font.
      Specified by:
      font in interface StyleSetter<Style>
      Parameters:
      font - the font
      Returns:
      a style
      Since:
      4.0.0
      Since Minecraft:
      1.16

    • color

      @Nullable @Nullable TextColor color()
      Gets the color.
      Specified by:
      color in interface StyleGetter
      Returns:
      the color
      Since:
      4.0.0

    • color

      @NotNull @NotNull Style color(@Nullable @Nullable TextColor color)
      Sets the color.
      Specified by:
      color in interface StyleSetter<Style>
      Parameters:
      color - the color
      Returns:
      a style
      Since:
      4.0.0

    • colorIfAbsent

      @NotNull @NotNull Style colorIfAbsent(@Nullable @Nullable TextColor color)
      Sets the color if there isn't one set already.
      Specified by:
      colorIfAbsent in interface StyleSetter<Style>
      Parameters:
      color - the color
      Returns:
      this builder
      Since:
      4.0.0

    • hasDecoration

      default boolean hasDecoration(@NotNull @NotNull TextDecoration decoration)
      Tests if this style has a decoration.
      Specified by:
      hasDecoration in interface StyleGetter
      Parameters:
      decoration - the decoration
      Returns:
      true if this style has the decoration, false if this style does not have the decoration
      Since:
      4.0.0

    • decoration

      @NotNull TextDecoration.State decoration(@NotNull @NotNull TextDecoration decoration)
      Gets the state of a decoration on this style.
      Specified by:
      decoration in interface StyleGetter
      Parameters:
      decoration - the decoration
      Returns:
      TextDecoration.State.TRUE if this style has the decoration, TextDecoration.State.FALSE if this style does not have the decoration, and TextDecoration.State.NOT_SET if not set
      Since:
      4.0.0

    • decorate

      @NotNull default @NotNull Style decorate(@NotNull @NotNull TextDecoration decoration)
      Sets the state of decoration to TextDecoration.State.TRUE on this style.
      Specified by:
      decorate in interface StyleSetter<Style>
      Parameters:
      decoration - the decoration
      Returns:
      a style
      Since:
      4.0.0

    • decoration

      @NotNull default @NotNull Style decoration(@NotNull @NotNull TextDecoration decoration, boolean flag)
      Sets the state of a decoration on this style.
      Specified by:
      decoration in interface StyleSetter<Style>
      Parameters:
      decoration - the decoration
      flag - true if this style should have the decoration, false if this style should not have the decoration
      Returns:
      a style
      Since:
      4.0.0

    • decoration

      @NotNull @NotNull Style decoration(@NotNull @NotNull TextDecoration decoration, @NotNull TextDecoration.State state)
      Sets the value of a decoration on this style.
      Specified by:
      decoration in interface StyleSetter<Style>
      Parameters:
      decoration - the decoration
      state - TextDecoration.State.TRUE if this style should have the decoration, TextDecoration.State.FALSE if this style should not have the decoration, and TextDecoration.State.NOT_SET if the decoration should not have a set value
      Returns:
      a style
      Since:
      4.0.0

    • decorationIfAbsent

      @NotNull @NotNull Style decorationIfAbsent(@NotNull @NotNull TextDecoration decoration, @NotNull TextDecoration.State state)
      Sets the state of a decoration on this style to state if the current state of the decoration is TextDecoration.State.NOT_SET.
      Specified by:
      decorationIfAbsent in interface StyleSetter<Style>
      Parameters:
      decoration - the decoration
      state - the state
      Returns:
      a style
      Since:
      4.12.0

    • decorations

      @NotNull default @Unmodifiable @NotNull Map<TextDecoration,TextDecoration.State> decorations()
      Gets a map of decorations this style has.
      Specified by:
      decorations in interface StyleGetter
      Returns:
      a set of decorations this style has
      Since:
      4.0.0

    • decorations

      @NotNull @NotNull Style decorations(@NotNull @NotNull Map<TextDecoration,TextDecoration.State> decorations)
      Sets decorations for this style using the specified decorations map.

      If a given decoration does not have a value explicitly set, the value of that particular decoration is not changed.

      Specified by:
      decorations in interface StyleSetter<Style>
      Parameters:
      decorations - the decorations
      Returns:
      a style
      Since:
      4.0.0

    • clickEvent

      @Nullable @Nullable ClickEvent clickEvent()
      Gets the click event.
      Specified by:
      clickEvent in interface StyleGetter
      Returns:
      the click event
      Since:
      4.0.0

    • clickEvent

      @NotNull @NotNull Style clickEvent(@Nullable @Nullable ClickEvent event)
      Sets the click event.
      Specified by:
      clickEvent in interface StyleSetter<Style>
      Parameters:
      event - the click event
      Returns:
      a style
      Since:
      4.0.0

    • hoverEvent

      @Nullable @Nullable HoverEvent<?> hoverEvent()
      Gets the hover event.
      Specified by:
      hoverEvent in interface StyleGetter
      Returns:
      the hover event
      Since:
      4.0.0

    • hoverEvent

      @NotNull @NotNull Style hoverEvent(@Nullable @Nullable HoverEventSource<?> source)
      Sets the hover event.
      Specified by:
      hoverEvent in interface StyleSetter<Style>
      Parameters:
      source - the hover event source
      Returns:
      a style
      Since:
      4.0.0

    • insertion

      @Nullable @Nullable String insertion()
      Gets the string to be inserted when this style is shift-clicked.
      Specified by:
      insertion in interface StyleGetter
      Returns:
      the insertion string
      Since:
      4.0.0

    • insertion

      @NotNull @NotNull Style insertion(@Nullable @Nullable String insertion)
      Sets the string to be inserted when this style is shift-clicked.
      Specified by:
      insertion in interface StyleSetter<Style>
      Parameters:
      insertion - the insertion string
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that)
      Merges from another style into this style.
      Parameters:
      that - the other style
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull Style.Merge.Strategy strategy)
      Merges from another style into this style.
      Parameters:
      that - the other style
      strategy - the merge strategy
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull @NotNull Style.Merge merge)
      Merges from another style into this style.
      Parameters:
      that - the other style
      merge - the part to merge
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull Style.Merge.Strategy strategy, @NotNull @NotNull Style.Merge merge)
      Merges from another style into this style.
      Parameters:
      that - the other style
      strategy - the merge strategy
      merge - the part to merge
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull @NotNull Style.Merge @NotNull ... merges)
      Merges from another style into this style.
      Parameters:
      that - the other style
      merges - the parts to merge
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull Style.Merge.Strategy strategy, @NotNull @NotNull Style.Merge @NotNull ... merges)
      Merges from another style into this style.
      Parameters:
      that - the other style
      strategy - the merge strategy
      merges - the parts to merge
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull default @NotNull Style merge(@NotNull @NotNull Style that, @NotNull @NotNull Set<Style.Merge> merges)
      Merges from another style into this style.
      Parameters:
      that - the other style
      merges - the parts to merge
      Returns:
      a style
      Since:
      4.0.0

    • merge

      @NotNull @NotNull Style merge(@NotNull @NotNull Style that, @NotNull Style.Merge.Strategy strategy, @NotNull @NotNull Set<Style.Merge> merges)
      Merges from another style into this style.
      Parameters:
      that - the other style
      strategy - the merge strategy
      merges - the parts to merge
      Returns:
      a style
      Since:
      4.0.0

    • unmerge

      @NotNull @NotNull Style unmerge(@NotNull @NotNull Style that)
      Simplify this style to remove any information that is redundant.
      Parameters:
      that - parent to compare against
      Returns:
      a new, simplified style
      Since:
      4.12.0

    • isEmpty

      boolean isEmpty()
      Tests if this style is empty.
      Returns:
      true if this style is empty, false if this style is not empty
      Since:
      4.0.0

    • toBuilder

      @NotNull @NotNull Style.Builder toBuilder()
      Create a builder from this style.
      Specified by:
      toBuilder in interface Buildable<Style,Style.Builder>
      Returns:
      a builder