ScoreHud is a configurable Bedrock scoreboard plugin for PocketMine-MP. This repository is the maintained, self-contained build for current Axolotl-PM API 5 servers. The bundled ScoreFactory uses the current scoreboard packet API, so no external ScoreHud library, wiki checkout or addon repository is required at runtime.
- Up to 15 configurable scoreboard lines.
- Per-world boards and disabled-world support.
- Optional flickering titles with a fixed, server-wide animation rate.
- Built-in player, server, world, health, experience, item, time and memory tags.
- Event-driven API for plugin integrations and timely tag updates.
- Self-contained PHAR build with no runtime virion dependency.
- PHPStan level max in CI and a DevTools PHAR build on every push and pull request.
- Download
ScoreHud.pharfrom the latest release. - Copy it to the
pluginsdirectory of an Axolotl-PM API 5 server. - Start the server once, then edit
plugin_data/ScoreHud/config.ymlandplugin_data/ScoreHud/scorehud.yml. - Restart the server.
ScoreHud has no mandatory dependency. Optional integrations activate when their plugin is installed and enabled.
The following example shows a simple board in plugin_data/ScoreHud/scorehud.yml:
default-board:
- ""
- "§eRank"
- "§8» §f{ppscore.rank}"
- ""
- "§ePlayers"
- "§8» §f{scorehud.online}§8/§f{scorehud.max_online}"
- ""
- "§eCoins"
- "§8» §f{simpleeconomy.balance}"
- ""See the configuration guide for per-world boards, disabled worlds, title animation and tag-factory settings.
Tags are written between braces, for example {scorehud.name}. See the
tags reference for the complete built-in catalogue, usage
examples and custom-tag guidance.
See the official integrations guide for supported plugins, tags, installation expectations and troubleshooting.
See the configuration guide.
See the Developer API reference for custom tag
resolvers, update events and ScoreTag usage.
Requirements: PHP 8.4 or newer, Composer, and an Axolotl-PM API 5 development source tree.
composer install --prefer-dist --no-interaction
composer test
composer phpstanThe GitHub Actions workflows also build the PHAR with the pinned PocketMine-MP
DevTools source and upload it as a CI artifact. A release asset is generated
from the same source set:
src, resources, plugin.yml, meta and changelogs.
Those numbers are Bedrock's score values. ScoreHud uses the score value to keep line order stable. The line text is still the configured scoreboard content.
Check the exact tag spelling and confirm the optional provider plugin is enabled.
For example, use {scorehud.online} rather than {player.online}, and
{simpleeconomy.balance} rather than a tag from another economy plugin.
That is an old ScoreFactory packet constant and indicates an outdated ScoreHud build. Use the PHAR from this repository's latest release, then remove the old ScoreHud PHAR before restarting the server.
Open a reproducible bug report or feature request in the ScoreHud issue tracker. The repository changelogs are kept with the source, so this README is the canonical user and developer documentation. No external wiki is required.
ScoreHud is distributed under the GNU General Public License v3.0. See LICENSE for the complete terms. The maintained code preserves the original ScoreHud attribution while providing a self-contained Axolotl-PM maintenance line under the AxolotlBucketLabs organization.
Authors: AxolotlBucketLabs, Ifera.