ScoreHud is a dynamic scoreboard plugin for PMMPCore Framework that brings customizable HUD displays to Minecraft Bedrock. Display player information, server statistics, economy data, and rank information on the sidebar with full PlaceholderAPI support.


What Does This Plugin Do?
ScoreHud provides a fully customizable sidebar scoreboard that can display any information through PlaceholderAPI placeholders. It supports auto-refreshing intervals, per-player visibility toggles, and works with EconomyAPI, PurePerms, and EssentialsTP for rich data displays.
⚠️ Requirements
| Requirement |
Status |
Details |
| ❌ PMMPCore Framework |
Required |
This plugin cannot work without PMMPCore Framework installed. |
| ✅ Server Owner |
Recommended |
Designed for server administrators configuring HUD displays. |
Key Features
- ✅ Customizable Sidebar: Fully configurable scoreboard lines with placeholders.
- ✅ Auto-Refreshing: Configurable update interval for real-time data display.
- ✅ PlaceholderAPI Support: Use any placeholder in scoreboard lines.
- ✅ Per-Player Toggle: Players can enable/disable their scoreboard.
- ✅ Color Code Support: Full Minecraft color code formatting (§ or &).
- ✅ Config Reload: Reload configuration without server restart.
- ✅ Migration System: Automatic config migration between versions.
- ✅ Player Leave Handling: Automatically refreshes display when players leave.
🛠️ Available Commands
| Command |
Syntax |
Description |
| scorehud |
/scorehud |
Toggle ScoreHud visibility preference |
| scorehudreload |
/scorehudreload |
Reload ScoreHud configuration from database |
| scorehuddebug |
/scorehuddebug |
Print debug info about current configuration |
| scorehudmigrate |
/scorehudmigrate |
Force configuration migration |
| scorehudreset |
/scorehudreset |
Reset ScoreHud config to defaults |
Example Usage
# Toggle your scoreboard
/scorehud
# Reload configuration
/scorehudreload
# Reset to defaults
/scorehudreset
Default Configuration
const SCOREHUD_DEFAULTS = {
enabled: true,
updateIntervalTicks: 20, // Refresh every 1 second (20 ticks)
objectiveId: "pmmpcore_sh",
title: "§eMineHUB UHC",
maxLineLength: 128,
maxLines: 15,
lines: [
"§7---------------",
"§3Player: %player_name%",
"§5Online: %server_online_players%",
"§eMoney: %economy_money%",
"§6Rank: %pureperms_rank%",
"§5Coords %player_x%, %player_y%, %player_z%",
"§7--------------",
"§fTPS: §e%server_tps% §8·§r §fLoad §e%server_load%%§r",
"§eIP: §6%server_ip%",
"§7--------------"
]
};
Available Placeholders for Scoreboard
| Category |
Placeholder |
Source |
| Player |
%player_name%, %player_x%, %player_y%, %player_z%, %player_dimension%, %player_health%, %player_level%, %player_ping% |
PlaceholderAPI |
| Server |
%server_online_players%, %server_max_players%, %server_tps%, %server_load%, %server_ip%, %server_motd% |
PlaceholderAPI |
| Time |
%time_date%, %time_time% |
PlaceholderAPI |
| Economy |
%economy_money%, %economy_bank%, %economy_debt% |
EconomyAPI |
| Rank |
%pureperms_rank%, %pureperms_prefix%, %pureperms_suffix%, %pureperms_group% |
PurePerms |
Configuration Options
| Option |
Type |
Default |
Description |
enabled |
boolean |
true |
Enable or disable ScoreHud |
updateIntervalTicks |
number |
20 |
Ticks between sidebar refreshes (20 ticks = 1 second) |
objectiveId |
string |
pmmpcore_sh |
Internal scoreboard objective identifier |
title |
string |
§eMineHUB UHC |
Scoreboard title (supports color codes) |
maxLineLength |
number |
128 |
Maximum characters per line |
maxLines |
number |
15 |
Maximum number of scoreboard lines |
Permission System
| Permission Node |
Feature |
Default Group |
scorehud.use |
Toggle scoreboard visibility |
Guest |
scorehud.admin.reload |
Reload and manage ScoreHud configuration |
Admin |
Compatibility & Requirements
- ⚠️ Requires PMMPCore Framework: This plugin is part of the PMMPCore ecosystem and cannot function independently.
- ✅ Version: Optimized for Minecraft Bedrock 1.21.70+ (Release).
- ✅ Multiplayer: Fully tested on Realms and Dedicated Servers.
- ✅ Cross-Plugin: Works with EconomyAPI, PurePerms, PlaceholderAPI, and EssentialsTP.
- ✅ License: GPL-3.0 - Free to use, modify, and distribute under the same terms.
Installation
- Download ScoreHud from CurseForge (comes as .mcpack file)
- Change file extension: Rename
ScoreHud.mcpack to ScoreHud.zip
- Extract the archive: Unzip the file to access the contents
- Locate PMMPCore: Find your PMMPCore Framework installation folder
- Copy plugin files: From the extracted folder, copy the
ScoreHud folder from scripts/plugins/
- Paste to plugins: Paste the folder into
scripts/plugins/ within PMMPCore
- Register plugins: Open
scripts/plugins.js and add the import:
// Add this line to your plugins.js file
import "./plugins/ScoreHud/main.js";
- Restart server: Restart Minecraft Bedrock to load the plugin
- Verify installation: Use
/plugins to confirm plugin is loaded
Getting Started
- Install PMMPCore Framework first (required dependency)
- For best results, also install PlaceholderAPI, EconomyAPI, and PurePerms
- Follow the installation steps above to add ScoreHud
- Restart your server to initialize the plugin
- Use
/scorehud to toggle your scoreboard visibility
- Customize the scoreboard lines and title in the plugin config
Need help configuring your scoreboard? Join our Discord Server for support!
⚠️ Important Notice: This plugin requires PMMPCore Framework and is designed for server administrators with technical knowledge of server management.