bettermodel-api/kr.toxicity.model.api.tracker/Tracker

Tracker

Represents the core controller for a specific model instance.

A Tracker manages the lifecycle, rendering, animation, and player interaction of a model. It coordinates with the RenderPipeline to update bone positions and send packets to players.

Since

1.15.2

Inheritors

DummyTracker

EntityTracker

Constructors

Tracker

constructor(@NotNull pipeline: @NotNull RenderPipeline, @NotNull modifier: @NotNull TrackerModifier)

Creates a new tracker.

Types

BundlerSet

inner class BundlerSet

Holds different types of packet bundlers for a tracker tick.

CloseReason

enum CloseReason

Reason for closing a tracker.

ScheduledPacketHandler

@FunctionalInterface

interface ScheduledPacketHandler

Functional interface for handling scheduled packets.

Properties

MINECRAFT_TICK_MULTIPLIER

val MINECRAFT_TICK_MULTIPLIER: Int = 2

The multiplier to convert tracker ticks to Minecraft ticks (50ms).

TRACKER_TICK_INTERVAL

val TRACKER_TICK_INTERVAL: Int = 25

The interval in milliseconds between tracker ticks.

Functions

animate

open fun animate(@NotNull animation: @NotNull String): Boolean

Plays an animation by name with default settings.

open fun animate(@NotNull animation: @NotNull TrackerAnimation<out Any>): Boolean

open fun animate(@NotNull animation: @NotNull TrackerAnimation<out Any>, @NotNull removeTask: @NotNull Runnable): Boolean

open fun animate(@NotNull animation: @NotNull String, @NotNull modifier: @NotNull AnimationModifier): Boolean

Plays an animation by name with a modifier.

open fun animate(@NotNull animation: @NotNull BlueprintAnimation, @NotNull modifier: @NotNull AnimationModifier): Boolean

Plays a blueprint animation with a modifier.

open fun animate(@NotNull animation: @NotNull String, @NotNull modifier: @NotNull AnimationModifier, @NotNull removeTask: @NotNull Runnable): Boolean

Plays an animation by name with a modifier and a completion task.

open fun animate(@NotNull animation: @NotNull BlueprintAnimation, @NotNull modifier: @NotNull AnimationModifier, @NotNull removeTask: @NotNull Runnable): Boolean

Plays a blueprint animation on filtered bones.

bone

@Nullable

open fun bone(@NotNull name: @NotNull String): @Nullable RenderedBone

Retrieves a bone by name string.

@Nullable

open fun bone(@NotNull predicate: @NotNull Predicate<RenderedBone>): @Nullable RenderedBone

Retrieves the first bone matching a predicate.

@Nullable

open fun bone(@NotNull name: @NotNull BoneName): @Nullable RenderedBone

Retrieves a bone by name.

bones

@NotNull

@Unmodifiable

open fun bones(): @NotNull @Unmodifiable Collection<RenderedBone>

Returns a collection of all bones in the model.

open fun close()

createHitBox

open fun createHitBox(@NotNull entity: @NotNull BaseEntity, @Nullable listener: @Nullable HitBoxListener, @NotNull predicate: @NotNull BonePredicate): Boolean

Creates a hitbox for bones matching a predicate.

createNametag

open fun createNametag(@NotNull predicate: @NotNull BonePredicate, @NotNull consumer: @NotNull BiConsumer<RenderedBone, ModelNametag>): Boolean

Creates a nametag for bones matching a predicate.

despawn

open fun despawn()

Despawns the model for all players without closing the tracker completely.

displays

@NotNull

open fun displays(): @NotNull Stream<ModelDisplay>

Returns a stream of all model displays.

equals

open fun equals(o: Any): Boolean

forceUpdate

open fun forceUpdate(force: Boolean): Boolean

Flags the tracker for a forced update on the next tick.

forRemoval

@ApiStatus.Internal

open fun forRemoval(): Boolean

Checks if the tracker is marked for removal.

@ApiStatus.Internal

open fun forRemoval(removal: Boolean)

Marks the tracker for removal.

frame

open fun frame(@NotNull handler: @NotNull Tracker.ScheduledPacketHandler)

Registers a handler to run every frame (tracker tick).

handleCloseEvent

open fun handleCloseEvent(@NotNull consumer: @NotNull BiConsumer<Tracker, Tracker.CloseReason>)

Registers a handler for the tracker close event.

hashCode

open fun hashCode(): Int

height

open fun height(): Double

Calculates the height of the model based on its head bone position.

hide

open fun hide(@NotNull player: @NotNull PlatformPlayer): Boolean

Hides the tracker from a specific player.

hitbox

@Nullable

open fun hitbox(@NotNull entity: @NotNull BaseEntity, @Nullable listener: @Nullable HitBoxListener, @NotNull predicate: @NotNull Predicate<RenderedBone>): @Nullable HitBox

Retrieves or creates a hitbox for a specific bone.

isClosed

open fun isClosed(): Boolean

Checks if the tracker has been closed.

isHide

open fun isHide(@NotNull player: @NotNull PlatformPlayer): Boolean

Checks if the tracker is hidden from a specific player.

isScheduled

open fun isScheduled(): Boolean

Checks if the tracker's update task is currently scheduled.

isSpawned

open fun isSpawned(@NotNull uuid: @NotNull UUID): Boolean

Checks if the model is spawned for a player (by UUID).

open fun isSpawned(@NotNull player: @NotNull PlatformPlayer): Boolean

Checks if the model is spawned for a player.

listenHitBox

open fun listenHitBox(@NotNull function: @NotNull BiFunction<RenderedBone, HitBoxListener.Builder, HitBoxListener.Builder>)

Registers a hitbox-listener builder hook that is applied when hitboxes are created.

open fun <T : HitBoxEvent?> listenHitBox(@NotNull eventClass: @NotNull Class<T>, @NotNull consumer: @NotNull Consumer<T>)

Registers a hitbox event listener for newly created hitboxes.

location

@NotNull

abstract fun location(): @NotNull PlatformLocation

Returns the current location of the model.

modifier

@NotNull

open fun modifier(): @NotNull TrackerModifier

Returns the tracker modifier.

name

@NotNull

open fun name(): @NotNull String

Returns the name of the model being tracked.

pause

open fun pause(pause: Boolean): Boolean

Pauses or resumes the tracker's ticking.

perPlayerTick

open fun perPlayerTick(@NotNull perPlayerHandler: @NotNull BiConsumer<Tracker, PlatformPlayer>)

Registers a handler to run every tick for each visible player.

playerCount

open fun playerCount(): Int

Returns the number of players currently viewing the model.

remove

open fun remove(@NotNull player: @NotNull PlatformPlayer): Boolean

Removes the model for a specific player.

renderer

@NotNull

open fun renderer(): @NotNull ModelRenderer

Returns the renderer associated with this tracker.

replace

open fun replace(@NotNull target: @NotNull String, @NotNull animation: @NotNull String, @NotNull modifier: @NotNull AnimationModifier): Boolean

Replaces a running animation on filtered bones.

open fun replace(@NotNull target: @NotNull String, @NotNull animation: @NotNull BlueprintAnimation, @NotNull modifier: @NotNull AnimationModifier): Boolean

Replaces a running animation on filtered bones with a blueprint animation.

rotation

@NotNull

open fun rotation(): @NotNull ModelRotation

Returns the current rotation of the model.

fun rotation(@NotNull supplier: @NotNull Supplier<ModelRotation>)

Sets the supplier for the base model rotation.

rotator

fun rotator(@NotNull rotator: @NotNull ModelRotator)

Sets the model rotator strategy.

scaler

@NotNull

open fun scaler(): @NotNull ModelScaler

Returns the model scaler.

open fun scaler(@NotNull scaler: @NotNull ModelScaler)

Sets the model scaler.

schedule

open fun schedule(period: Long, @NotNull handler: @NotNull Tracker.ScheduledPacketHandler)

Schedules a handler to run periodically.

show

open fun show(@NotNull player: @NotNull PlatformPlayer): Boolean

Shows the tracker to a specific player.

stopAnimation

open fun stopAnimation(@NotNull animation: @NotNull String): Boolean

Stops an animation by name.

open fun stopAnimation(@NotNull filter: @NotNull Predicate<RenderedBone>, @NotNull animation: @NotNull String): Boolean

Stops an animation on filtered bones.

open fun stopAnimation(@NotNull filter: @NotNull Predicate<RenderedBone>, @NotNull animation: @NotNull String, @Nullable player: @Nullable PlatformPlayer): Boolean

Stops an animation on filtered bones for a specific player (optional).

task

open fun task(@NotNull runnable: @NotNull Runnable)

Schedules a task to run on the next tracker tick.

tick

open fun tick(@NotNull handler: @NotNull Tracker.ScheduledPacketHandler)

Registers a handler to run every Minecraft tick (50ms).

open fun tick(tick: Long, @NotNull handler: @NotNull Tracker.ScheduledPacketHandler)

Registers a handler to run every N Minecraft ticks.

toString

open fun toString(): String

tryUpdate

open fun tryUpdate(@NotNull action: @NotNull BiPredicate<RenderedBone, BonePredicate>, @NotNull predicate: @NotNull BonePredicate): Boolean

Tries to apply an update action to bones matching a predicate.

update

open fun <T : TrackerUpdateAction?> update(@NotNull action: @NotNull T)

Forces an update action on all bones.

open fun <T : TrackerUpdateAction?> update(@NotNull action: @NotNull T, @NotNull predicate: @NotNull Predicate<RenderedBone>)

open fun <T : TrackerUpdateAction?> update(@NotNull action: @NotNull T, @NotNull predicate: @NotNull BonePredicate)

Forces an update action on filtered bones.