Skip to content

Player Attributes Placeholder Document

TRCStudioDean edited this page Nov 26, 2024 · 5 revisions

Description

This is the player attributes placeholder document for this plugin. Based on BukkitAPI/Minecraft version 1.16.5, some placeholders may not be effective. (This feature will continue to be expanded and optimized in the future)
For the purpose and explanation of built-in placeholders, please refer to: Built in placeholder document
You can view the format and functional description of each placeholder here.

Placeholder List

Placeholders for fixed usage

Format Result
{player:[Name]:name} Target player's name
{player:[Name]:uuid} Target player's UUID
{player:[Name]:custom_name} Target player's custom name
{player:[Name]:display_name} Target player's display name
{player:[Name]:locale} Target player's locale
{player:[Name]:player_list_footer} Currently displayed player list footer for this player
{player:[Name]:player_list_header} Currently displayed player list header for this player
{player:[Name]:player_list_name} Currently displayed player list name for this player
{player:[Name]:address} Target player's address
{player:[Name]:allow_flight} Whether the target player can fly
{player:[Name]:arrow_cooldown} Target player's arrow cooldown
{player:[Name]:arrows_in_body} Target player's arrows in body
{player:[Name]:attack_cooldown} Target player's attack cooldown
{player:[Name]:can_pickup_items} Whether the target player can pickup items
{player:[Name]:client_view_distance} Target player's client view distance
{player:[Name]:exhaustion} Target player's exhaustion
{player:[Name]:exp} Target player's exp
{player:[Name]:exp_to_level} Target player's exp to level
{player:[Name]:fall_distance} Target player's fall distance
{player:[Name]:fire_ticks} Target player's fire ticks
{player:[Name]:first_played} Target player's first played time
{player:[Name]:fly_speed} Target player's fly speed
{player:[Name]:food_level} Target player's food level
{player:[Name]:gamemode} Target player's gamemode
{player:[Name]:health} Target player's health
{player:[Name]:health_scale} Target player's health scale
{player:[Name]:last_damage} Target player's last damage
{player:[Name]:last_played} Target player's last played time
{player:[Name]:level} Target player's level
{player:[Name]:main_hand} Target player's main hand item
{player:[Name]:max_fire_ticks} Target player's max fire ticks
{player:[Name]:max_health} Target player's max health
{player:[Name]:maximum_air} Target player's maximum air
{player:[Name]:maximum_no_damage_ticks} Target player's maximum no damage ticks
{player:[Name]:no_damage_ticks} Target player's no damage ticks
{player:[Name]:ping} Target player's ping
{player:[Name]:player_time} Target player's time
{player:[Name]:player_time_offset} Target player's time offset
{player:[Name]:player_weather} Target player's weather
{player:[Name]:portal_cooldown} Target player's portal cooldown
{player:[Name]:remaining_air} Target player's remaining air
{player:[Name]:saturated_regen_rate} Target player's saturated regen rate
{player:[Name]:saturation} Target player's saturation
{player:[Name]:sleep_ticks} Target player's sleep ticks
{player:[Name]:starvation_rate} Target player's starvation rate
{player:[Name]:ticks_lived} Target player's ticks lived
{player:[Name]:total_experience} Target player's total experience
{player:[Name]:unsaturated_regen_rate} Target player's unsaturated regen rate
{player:[Name]:walk_speed} Target player's walk speed
{player:[Name]:has_gravity} Whether the target player has gravity
{player:[Name]:has_played_before} Whether the target player has played before
{player:[Name]:blocking} Whether the target player is blocking
{player:[Name]:collidable} Whether the target player collidable
{player:[Name]:conversing} Whether the target player is conversing
{player:[Name]:custom_name_visible} Whether the target player's custom name visible
{player:[Name]:dead} Whether the target player is dead
{player:[Name]:flying} Whether the target player is flying
{player:[Name]:gilding} Whether the target player is gilding
{player:[Name]:glowing} Whether the target player is glowing
{player:[Name]:hand_raised} Whether the target player's hand raised
{player:[Name]:health_scaled} Whether the target player is health scaled
{player:[Name]:in_water} Whether the target player in water
{player:[Name]:inside_vehicle} Whether the target player inside vehicle
{player:[Name]:invisible} Whether the target player is invisible
{player:[Name]:is_op} Whether the target player is OP
{player:[Name]:player_time_relative} Whether the target player time relative
{player:[Name]:riptiding} Whether the target player is riptiding
{player:[Name]:sleeping} Whether the target player is sleeping
{player:[Name]:silent} Whether the target player is silent
{player:[Name]:sneaking} Whether the target player is sneaking
{player:[Name]:sprinting} Whether the target player is sprinting
{player:[Name]:swimming} Whether the target player is swimming
{player:[Name]:whitelisted} Whether the target player is whitelisted

Placeholders with special usage

  • {player:[Name]:can_see_[TargetPlayer]} - Whether the player can see the target player

  • Potion Effects:

    Format Result
    {player:[Name]:active_potion_effects_[Number]_[Options]} Get a certain parameter for the Nth potion effect on the player status
    {player:[Name]:potion_effects_[EffectName]_[Options]} Get a certain parameter for the specified potion effect on the player status
    Option Result
    amplifier Potion amplifier
    duration Potion duration
    name Effect name
    Example Result
    {player:Steve:active_potion_effects_1_duration} The duration of Steve's first potion effect
    {player:Steve:potion_effects_SPEED_duration} The duration of the speed potion effect on Steve's status
  • Location:

    Format Result
    {player:[Name]:location_[Options]} Get a parameter for the player's current location
    {player:[Name]:bed_location_[Options]} Get a parameter for the player's current bed location
    {player:[Name]:bed_spawn_location_[Options]} Get a parameter for the player's current bed spawn location
    {player:[Name]:compass_target_[Options]} Get a parameter for the player's current compass target
    Option Result
    x X-axis value
    y Y-axis value
    z Z-axis value
    block_x X-axis block value
    block_y Y-axis block value
    block_z Z-axis block value
    pitch Pitch value
    yaw Yaw value
    world World name
    Example Result
    {player:Steve:location_x} Get Steve's X-axis value
    {player:Steve:bed_location_block_x} Get Steve's bed location's block X-axis value
    {player:Steve:bed_spawn_location_block_z} Get Steve's bed spawn location's block Z-axis value
    {player:Steve:compass_target_pitch} Get Steve's compass target location's pitch value
  • Items:

    Format Result
    {player:[Name]:inventory_[Slot]_[Options]} Get a certain parameter for the item in the Nth slot of the player's inventory
    {player:[Name]:ender_chest_[Slot]_[Options]} Get a certain parameter for the item in the Nth slot of the player's ender chest

    Explanation: 0-8 is the slot from left to right in the bottom item column; 9-35 is the slot in the item list from top to bottom and from left to right; 36-39 is the slot from the helmet to the boots; 40 is the player's backhand item slot.

    Option Result
    amount Item's amount
    durability Item's durability
    max_stack_size Item's max stack size
    type Item's ID
    data Item's data (1.12.2 Below)
    custom_model_data Item's custom model data
    display_name Item's display name
    name Item's name
    has_item_meta Whether the item has ItemMeta
    has_custom_model_data Whether the item has custom model data
    has_display_name Whether the item has display name
    has_name Whether the item has name
    has_lore Whether the item has lore
    has_enchants Whether the item has enchants
    has_enchants_[Enchantment] Whether the item have a designated enchantment
    enchantments_level_[Enchantment] Enchantment level for the specified enchantment
    lore_[Line] Lore text for the specified number of lines
    Example Result
    {player:Steve:inventory_1_amount} Get the amount of the item in the first slot of Steve's inventory
    {player:Steve:inventory_1_type} Get the ID of the item in the first slot of Steve's inventory
    {player:Steve:inventory_1_lore_2} Get the second line of lore for the item in the first slot of Steve's inventory

Clone this wiki locally