Skip to content

Feature guide: Playerlist Objective

NEZNAMY edited this page Apr 1, 2025 · 13 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. 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.
title "Java Edition is better" Title to send. Only visible on Bedrock Edition.
render-type INTEGER Render type of the value. Supported values are INTEGER and HEARTS
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

  • [1.5 - 1.20.2] Only 2 display types are supported - yellow number and hearts.
  • [1.5 - 1.20.2] A yellow 0 will appear on all tablist entries that aren't actual players (such as NPCs and layout entries) and it cannot be removed.

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