Objects and Tags

PlayerTag

Represents a player entity. This is a base Denizen tag object for a player.

  • Tags:

    • <PlayerTag.limb>: Returns the MapTag of the player’s limb animation data. Example: map@[animation_name=roll;loop_mode=loop;default_loop_mode=play_once]

    • <PlayerTag.limb_bones[<model_name>]>: Returns the MapTag of all player limb bones.

BMEntityTag

Represents an entity that has one or more BetterModel models attached.

  • Prefix: bmentity

  • Format: UUID of the base entity (e.g., bmentity@dfc67056-b15d-45dd-b239-482d92e482e5).

  • Tags:

    • <EntityTag.bm_entity>: Returns the BMEntityTag if the entity has BetterModel models (null if none).

    • <BMEntityTag.base_entity>: Returns the base Bukkit entity as an EntityTag.

    • <BMEntityTag.model[(<model_name>)]>: Returns the BMModelTag for the specified model name; if none provided, returns the first model loaded on the entity.

BMModelTag

Represents a specific model instance attached to an entity.

  • Prefix: bmmodel

  • Format: <uuid>,<model_name> (e.g., bmmodel@dfc67056-b15d-45dd-b239-482d92e482e5,dummy).

  • Tags:

    • <BMModelTag.name>: Returns the model name.

    • <BMModelTag.bm_entity>: Returns the parent BMEntityTag.

    • <BMModelTag.bones>: Returns a MapTag of all bones in the model (bone name => BMBoneTag).

    • <BMModelTag.bone[<name>]>: Returns the BMBoneTag for the specified bone name.

    • <BMModelTag.get_animation_duration[<name>]>: Returns total duration of the specified animation.

    • <BMModelTag.animations>: Returns a ListTag of all available animation names.

  • Mechanisms:

    • force_update: Forces an immediate visual update of the model for all viewers.

BMBoneTag

Represents a single bone within a specific model instance on an entity.

  • Prefix: bmbone

  • Format: <uuid>,<model_name>,<bone_name> (e.g., bmbone@dfc67056-b15d-45dd-b239-482d92e482e5,dummy,head)

  • Tags:

    • <BMBoneTag.name>: Bone's name (ElementTag).

    • <BMBoneTag.world_location>: Bone's world position (LocationTag).

    • <BMBoneTag.world_rotation>: Bone's real-time rotation in world space as a Quaternion (QuaternionTag).

    • <BMBoneTag.is_visible>: Whether the bone is visible (ElementTag(Boolean)).

    • <BMBoneTag.bm_model>: Parent model (BMModelTag).

  • Mechanisms:

    • tint:<ElementTag(Integer)> — Applies RGB color tint to the bone's item. (<ColorTag.rgb_integer>)

    • scale:<LocationTag> — Sets the scale vector of the bone.

    • visible:<ElementTag(Boolean)> or ListTag — Sets visibility for all or specific players.

    • item:<ItemTag> — Sets the item displayed by the bone.

    • offset:<LocationTag> — Sets the local offset of the bone's item.

    • rotate:<QuaternionTag> — Applies an additional rotation to the bone.

    • view_range:<ElementTag(Decimal)> — Sets the render distance for the bone in blocks.

    • interpolation_duration:<DurationTag> — Sets movement interpolation duration for the bone.

    • glow:<ElementTag(Boolean)> — Enables/disables glowing effect for the bone.

    • glow_color:<ElementTag(Integer)> — Sets the RGB glow color.

    • brightness:<ElementTag(Integer)> — Sets the brightness level for the bone.

PreviousEventsNextContact

Last updated