Class HoverEvent<V>
- java.lang.Object
-
- net.kyori.adventure.text.event.HoverEvent<V>
-
- Type Parameters:
V- the value type
- All Implemented Interfaces:
ComponentBuilderApplicable,HoverEventSource<V>,StyleBuilderApplicable,net.kyori.examination.Examinable
public final class HoverEvent<V> extends Object implements net.kyori.examination.Examinable, HoverEventSource<V>, StyleBuilderApplicable
A hover event.A hover event displays a
componentwhen hovered over by a mouse on the client.- Since:
- 4.0.0
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classHoverEvent.Action<V>An enumeration of hover event actions.static classHoverEvent.ShowEntityThe value of ashow_entityhover event.static classHoverEvent.ShowItemThe value of ashow_itemhover event.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description @NotNull HoverEvent.Action<V>action()Gets the hover event action.@NotNull HoverEvent<V>asHoverEvent()Represent this object as a hover event.@NotNull HoverEvent<V>asHoverEvent(@NotNull UnaryOperator<V> op)Creates a hover event with value derived from this object.booleanequals(@Nullable Object other)@NotNull Stream<? extends net.kyori.examination.ExaminableProperty>examinableProperties()inthashCode()static <V> @NotNull HoverEvent<V>hoverEvent(@NotNull HoverEvent.Action<V> action, V value)Creates a hover event.static @NotNull HoverEvent<HoverEvent.ShowEntity>showEntity(@NotNull Keyed type, @NotNull UUID id)Creates a hover event that show information about an entity on hover.static @NotNull HoverEvent<HoverEvent.ShowEntity>showEntity(@NotNull Keyed type, @NotNull UUID id, @Nullable Component name)Creates a hover event that show information about an entity on hover.static @NotNull HoverEvent<HoverEvent.ShowEntity>showEntity(@NotNull Key type, @NotNull UUID id)Creates a hover event that show information about an entity on hover.static @NotNull HoverEvent<HoverEvent.ShowEntity>showEntity(@NotNull Key type, @NotNull UUID id, @Nullable Component name)Creates a hover event that show information about an entity on hover.static @NotNull HoverEvent<HoverEvent.ShowEntity>showEntity(@NotNull HoverEvent.ShowEntity entity)Creates a hover event that show information about an entity on hover.static @NotNull HoverEvent<HoverEvent.ShowItem>showItem(@NotNull Keyed item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count)Creates a hover event that shows an item on hover.static @NotNull HoverEvent<HoverEvent.ShowItem>showItem(@NotNull Keyed item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count, @Nullable BinaryTagHolder nbt)Creates a hover event that shows an item on hover.static @NotNull HoverEvent<HoverEvent.ShowItem>showItem(@NotNull Key item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count)Creates a hover event that shows an item on hover.static @NotNull HoverEvent<HoverEvent.ShowItem>showItem(@NotNull Key item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count, @Nullable BinaryTagHolder nbt)Creates a hover event that shows an item on hover.static @NotNull HoverEvent<HoverEvent.ShowItem>showItem(@NotNull HoverEvent.ShowItem item)Creates a hover event that shows an item on hover.static @NotNull HoverEvent<Component>showText(@NotNull Component text)Creates a hover event that shows text on hover.static @NotNull HoverEvent<Component>showText(@NotNull ComponentLike text)Creates a hover event that shows text on hover.voidstyleApply(@NotNull Style.Builder style)Applies tostyle.StringtoString()Vvalue()Gets the hover event value.@NotNull HoverEvent<V>value(V value)Sets the hover event value.<C> @NotNull HoverEvent<V>withRenderedValue(@NotNull ComponentRenderer<C> renderer, C context)Returns a hover event with the value rendered usingrendererwhen possible.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface net.kyori.adventure.text.format.StyleBuilderApplicable
componentBuilderApply
-
-
-
-
Method Detail
-
showText
@NotNull public static @NotNull HoverEvent<Component> showText(@NotNull @NotNull ComponentLike text)
Creates a hover event that shows text on hover.- Parameters:
text- the text to show on hover- Returns:
- a hover event
- Since:
- 4.2.0
-
showText
@NotNull public static @NotNull HoverEvent<Component> showText(@NotNull @NotNull Component text)
Creates a hover event that shows text on hover.- Parameters:
text- the text to show on hover- Returns:
- a hover event
- Since:
- 4.0.0
-
showItem
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowItem> showItem(@NotNull @NotNull Key item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count)
Creates a hover event that shows an item on hover.- Parameters:
item- the itemcount- the count- Returns:
- a hover event
- Since:
- 4.0.0
-
showItem
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowItem> showItem(@NotNull @NotNull Keyed item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count)
Creates a hover event that shows an item on hover.- Parameters:
item- the itemcount- the count- Returns:
- a hover event
- Since:
- 4.6.0
-
showItem
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowItem> showItem(@NotNull @NotNull Key item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count, @Nullable @Nullable BinaryTagHolder nbt)
Creates a hover event that shows an item on hover.- Parameters:
item- the itemcount- the countnbt- the nbt- Returns:
- a hover event
- Since:
- 4.0.0
-
showItem
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowItem> showItem(@NotNull @NotNull Keyed item, @org.jetbrains.annotations.Range(from=0L, to=2147483647L) int count, @Nullable @Nullable BinaryTagHolder nbt)
Creates a hover event that shows an item on hover.- Parameters:
item- the itemcount- the countnbt- the nbt- Returns:
- a hover event
- Since:
- 4.6.0
-
showItem
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowItem> showItem(@NotNull @NotNull HoverEvent.ShowItem item)
Creates a hover event that shows an item on hover.- Parameters:
item- the item to show on hover- Returns:
- a hover event
- Since:
- 4.0.0
-
showEntity
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowEntity> showEntity(@NotNull @NotNull Key type, @NotNull @NotNull UUID id)
Creates a hover event that show information about an entity on hover.In the official Minecraft: Java Edition client, no information will be shown unless the "Advanced tooltips" debug option is enabled.
- Parameters:
type- the typeid- the id- Returns:
- a
ShowEntity - Since:
- 4.0.0
-
showEntity
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowEntity> showEntity(@NotNull @NotNull Keyed type, @NotNull @NotNull UUID id)
Creates a hover event that show information about an entity on hover.In the official Minecraft: Java Edition client, no information will be shown unless the "Advanced tooltips" debug option is enabled.
- Parameters:
type- the typeid- the id- Returns:
- a
ShowEntity - Since:
- 4.6.0
-
showEntity
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowEntity> showEntity(@NotNull @NotNull Key type, @NotNull @NotNull UUID id, @Nullable @Nullable Component name)
Creates a hover event that show information about an entity on hover.In the official Minecraft: Java Edition client, no information will be shown unless the "Advanced tooltips" debug option is enabled.
- Parameters:
type- the typeid- the idname- the name- Returns:
- a
ShowEntity - Since:
- 4.0.0
-
showEntity
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowEntity> showEntity(@NotNull @NotNull Keyed type, @NotNull @NotNull UUID id, @Nullable @Nullable Component name)
Creates a hover event that show information about an entity on hover.In the official Minecraft: Java Edition client, no information will be shown unless the "Advanced tooltips" debug option is enabled.
- Parameters:
type- the typeid- the idname- the name- Returns:
- a
ShowEntity - Since:
- 4.6.0
-
showEntity
@NotNull public static @NotNull HoverEvent<HoverEvent.ShowEntity> showEntity(@NotNull @NotNull HoverEvent.ShowEntity entity)
Creates a hover event that show information about an entity on hover.In the official Minecraft: Java Edition client, no information will be shown unless the "Advanced tooltips" debug option is enabled.
- Parameters:
entity- the entity to show on hover- Returns:
- a hover event
- Since:
- 4.0.0
-
hoverEvent
@NotNull public static <V> @NotNull HoverEvent<V> hoverEvent(@NotNull @NotNull HoverEvent.Action<V> action, @NotNull V value)
Creates a hover event.- Type Parameters:
V- the value type- Parameters:
action- the actionvalue- the value- Returns:
- a click event
- Since:
- 4.0.0
-
action
@NotNull public @NotNull HoverEvent.Action<V> action()
Gets the hover event action.- Returns:
- the hover event action
- Since:
- 4.0.0
-
value
@NotNull public V value()
Gets the hover event value.- Returns:
- the hover event value
- Since:
- 4.0.0
-
value
@NotNull public @NotNull HoverEvent<V> value(@NotNull V value)
Sets the hover event value.- Parameters:
value- the hover event value- Returns:
- a hover event
- Since:
- 4.0.0
-
withRenderedValue
@NotNull public <C> @NotNull HoverEvent<V> withRenderedValue(@NotNull @NotNull ComponentRenderer<C> renderer, @NotNull C context)
Returns a hover event with the value rendered usingrendererwhen possible.- Type Parameters:
C- the context type- Parameters:
renderer- the renderercontext- the render context- Returns:
- a hover event
- Since:
- 4.0.0
-
asHoverEvent
@NotNull public @NotNull HoverEvent<V> asHoverEvent()
Description copied from interface:HoverEventSourceRepresent this object as a hover event.- Specified by:
asHoverEventin interfaceHoverEventSource<V>- Returns:
- a hover event
-
asHoverEvent
@NotNull public @NotNull HoverEvent<V> asHoverEvent(@NotNull @NotNull UnaryOperator<V> 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<V>- Parameters:
op- transformation on value- Returns:
- a hover event
-
styleApply
public void styleApply(@NotNull Style.Builder style)
Description copied from interface:StyleBuilderApplicableApplies tostyle.- Specified by:
styleApplyin interfaceStyleBuilderApplicable- Parameters:
style- the style builder
-
examinableProperties
@NotNull public @NotNull Stream<? extends net.kyori.examination.ExaminableProperty> examinableProperties()
- Specified by:
examinablePropertiesin interfacenet.kyori.examination.Examinable
-
-