Package mcp.mobius.waila.api

Interface IEntityComponentProvider

@ClientOnly
@OverrideOnly
public interface IEntityComponentProvider

Used to provide Entity tooltip information to Waila.

All methods in this interface shouldn't to be called by the implementing mod. An instance of the class is to be registered via the IClientRegistrar instance provided in IWailaClientPlugin.

See Also:

• IWailaClientPlugin
• IClientRegistrar

Field Summary

Fields

Modifier and Type	Field	Description
static final Entity	EMPTY_ENTITY	An "empty" entity to be used with getOverride(mcp.mobius.waila.api.IEntityAccessor, mcp.mobius.waila.api.IPluginConfig), effectively disabling the tooltip to be displayed.

Method Summary

Modifier and Type	Method	Description
default void	appendBody(ITooltip tooltip, IEntityAccessor accessor, IPluginConfig config)	Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).
default void	appendDataContext(IDataWriter ctx, IEntityAccessor accessor, IPluginConfig config)	Callback used to send additional context to IDataProviders.
default void	appendHead(ITooltip tooltip, IEntityAccessor accessor, IPluginConfig config)	Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).
default void	appendTail(ITooltip tooltip, IEntityAccessor accessor, IPluginConfig config)	Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).
default @Nullable ITooltipComponent	getIcon(IEntityAccessor accessor, IPluginConfig config)	Callback used to set an icon to display in the tooltip.
default @Nullable Entity	getOverride(IEntityAccessor accessor, IPluginConfig config)	Callback used to override the default Waila lookup system.
default ITargetRedirector.Result	redirect(ITargetRedirector redirect, IEntityAccessor accessor, IPluginConfig config)	Redirect the ray cast hit result to target other object.

Field Details

EMPTY_ENTITY

static final Entity EMPTY_ENTITY

An "empty" entity to be used with getOverride(mcp.mobius.waila.api.IEntityAccessor, mcp.mobius.waila.api.IPluginConfig), effectively disabling the tooltip to be displayed.

Note: Waila will use == instead of Object.equals(java.lang.Object) to check for this.

Method Details

redirect

@Nullable
@Experimental
default ITargetRedirector.Result redirect(ITargetRedirector redirect,
 IEntityAccessor accessor,
 IPluginConfig config)

Redirect the ray cast hit result to target other object.

Parameters:

redirect - the redirector

accessor - contains most of the relevant information about the current environment. Note that IEntityAccessor.getData() will always be empty at this time

config - current plugin configuration

Returns:

null if this method doesn't redirect to anything, any result from one of ITargetRedirector's methods otherwise

See Also:

• IClientRegistrar.redirect(IEntityComponentProvider, Class)

appendDataContext

default void appendDataContext(IDataWriter ctx,
 IEntityAccessor accessor,
 IPluginConfig config)

Callback used to send additional context to IDataProviders.

Parameters:

ctx - the context writer

accessor - contains most of the relevant information about the current environment. Note that IEntityAccessor.getData() will always be empty at this time

config - current plugin configuration

See Also:

• IClientRegistrar.dataContext(IEntityComponentProvider, Class)

getOverride

@Nullable
default @Nullable Entity getOverride(IEntityAccessor accessor,
 IPluginConfig config)

Callback used to override the default Waila lookup system.

Parameters:

accessor - contains most of the relevant information about the current environment

config - current plugin configuration

Returns:

null if override is not required, an Entity otherwise

See Also:

• IClientRegistrar.override(IEntityComponentProvider, Class, int)
• EMPTY_ENTITY

getIcon

@Nullable
default @Nullable ITooltipComponent getIcon(IEntityAccessor accessor,
 IPluginConfig config)

Callback used to set an icon to display in the tooltip.

This method is only called on the client side. If you require data from the server, you should also implement IDataProvider and add the data there, which can then be read back using IEntityAccessor.getData(). If you rely on the client knowing the data you need, you are not guaranteed to have the proper values.

Parameters:

accessor - contains most of the relevant information about the current environment

config - current plugin configuration

Returns:

the component to render or null if this provider doesn't decide it

See Also:

• IClientRegistrar.icon(IEntityComponentProvider, Class, int)

appendHead

default void appendHead(ITooltip tooltip,
 IEntityAccessor accessor,
 IPluginConfig config)

Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).

This method is only called on the client side. If you require data from the server, you should also implement IDataProvider and add the data there, which can then be read back using IEntityAccessor.getData(). If you rely on the client knowing the data you need, you are not guaranteed to have the proper values.

Parameters:

tooltip - current list of tooltip lines (might have been processed by other providers and might be processed by other providers), use ITooltip.setLine(net.minecraft.resources.ResourceLocation) with tags from WailaConstants to override built-in values

accessor - contains most of the relevant information about the current environment

config - current plugin configuration

See Also:

• IClientRegistrar.head(IEntityComponentProvider, Class, int)

appendBody

default void appendBody(ITooltip tooltip,
 IEntityAccessor accessor,
 IPluginConfig config)

Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).

This method is only called on the client side. If you require data from the server, you should also implement IDataProvider and add the data there, which can then be read back using IEntityAccessor.getData(). If you rely on the client knowing the data you need, you are not guaranteed to have the proper values.

Parameters:

tooltip - current list of tooltip lines (might have been processed by other providers and might be processed by other providers), use ITooltip.setLine(net.minecraft.resources.ResourceLocation) with tags from WailaConstants to override built-in values

accessor - contains most of the relevant information about the current environment

config - current plugin configuration

See Also:

• IClientRegistrar.body(IEntityComponentProvider, Class, int)

appendTail

default void appendTail(ITooltip tooltip,
 IEntityAccessor accessor,
 IPluginConfig config)

Callback used to add lines to one of the three sections of the tooltip (Head, Body, Tail).

This method is only called on the client side. If you require data from the server, you should also implement IDataProvider and add the data there, which can then be read back using IEntityAccessor.getData(). If you rely on the client knowing the data you need, you are not guaranteed to have the proper values.

Parameters:

tooltip - current list of tooltip lines (might have been processed by other providers and might be processed by other providers), use ITooltip.setLine(net.minecraft.resources.ResourceLocation) with tags from WailaConstants to override built-in values

accessor - contains most of the relevant information about the current environment

config - current plugin configuration

See Also:

• IClientRegistrar.tail(IEntityComponentProvider, Class, int)