ScoreHub - PMMPCore Plugin

ScoreHud Plugin (Click for More)

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

1. Download ScoreHud from CurseForge (comes as .mcpack file)
2. Change file extension: Rename ScoreHud.mcpack to ScoreHud.zip
3. Extract the archive: Unzip the file to access the contents
4. Locate PMMPCore: Find your PMMPCore Framework installation folder
5. Copy plugin files: From the extracted folder, copy the ScoreHud folder from scripts/plugins/
6. Paste to plugins: Paste the folder into scripts/plugins/ within PMMPCore
7. Register plugins: Open scripts/plugins.js and add the import:

// Add this line to your plugins.js file
import "./plugins/ScoreHud/main.js";

1. Restart server: Restart Minecraft Bedrock to load the plugin
2. Verify installation: Use /plugins to confirm plugin is loaded

Getting Started

1. Install PMMPCore Framework first (required dependency)
2. For best results, also install PlaceholderAPI, EconomyAPI, and PurePerms
3. Follow the installation steps above to add ScoreHud
4. Restart your server to initialize the plugin
5. Use /scorehud to toggle your scoreboard visibility
6. 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.