Skip to content

Feature guide: Playerlist Objective

NEZNAMY edited this page Dec 1, 2024 · 9 revisions

Content

About

The scoreboard objective with PLAYER_LIST display slot. On 1.20.2- it supports 2 display types:

  • yellow number
  • hearts

Since 1.20.3, it can display any text.
image

This feature can be configured in config.yml under playerlist-objective section.

Configuration

Option name Default value Description
enabled true Enables / Disables the feature
value "%ping%" [1.20.2-] Defines value displayed. You can set this to any placeholder that outputs a number. Setting value to %health%, %player_health% or %player_health_rounded% will result in the display type being changed to hearts instead of number. If you want to display health but as a number and not hearts, set value to 0%health% for example. Only visible on 1.20.2 and lower.
Note: Even if you only support 1.20.3+, you still need to configure this value to properly evaluate to a number, because the value is still sent to the client (just not displayed). You can set it to 0 for simplicity.
fancy-value "&7Ping: %ping%" [1.20.3+] Value to display for 1.20.3+ clients. Supports any text.
disable-condition %world%=disabledworld A condition that must be met for disabling the feature for players. Set to empty for not disabling the feature ever.

Limitations

At 1.20.2 and lower, only 2 display types are supported - number and hearts. The number's color is yellow and cannot be changed.

Additional info

Additional note 1 - Spectator gamemode

The feature will not be visible on players with spectator gamemode. To resolve this, check out Spectator fix feature.

Clone this wiki locally