PlaceholderAPI - PMMPCore Plugin

PlaceholderAPI Plugin (Click for More)

PlaceholderAPI is a placeholder expansion system for PMMPCore Framework that brings dynamic text replacement to Minecraft Bedrock. Parse placeholders in chat messages, scoreboards, nametags, and any custom text with support for multiple expansion modules.

What Does This Plugin Do?

PlaceholderAPI provides a centralized placeholder parsing engine that allows other plugins to register expansion modules. Text containing placeholders like %player_name% or %server_tps% is automatically replaced with live values. Built-in expansions cover player data, server metrics, time, and general information.

⚠️ Requirements

Requirement	Status	Details
❌ PMMPCore Framework	Required	This plugin cannot work without PMMPCore Framework installed.
✅ Server Owner	Recommended	Foundation for dynamic text display across plugins.

Key Features

• ✅ Dynamic Placeholder Parsing: Replace %placeholder% patterns with live server and player data.
• ✅ Modular Expansions: Register/unregister expansion modules from any plugin.
• ✅ Built-in Expansions: Player, Server, Time, and General expansions pre-included.
• ✅ Third-Party Expansions: EconomyAPI, PurePerms, and EssentialsTP register their own placeholders.
• ✅ Caching System: Configurable TTL-based caching for frequently accessed placeholders.
• ✅ Command Interface: Parse, test, list, and reload placeholders through commands.
• ✅ Player Context: Placeholders can resolve per-player values dynamically.
• PurePerms: %pureperms_rank%, %pureperms_prefix%, %pureperms_suffix%, %pureperms_group%, %pureperms_groups%

🛠️ Available Commands

Command	Syntax	Description
papi	/papi reload	Reload placeholder configuration
papi	/papi list	List all registered expansions
papi	/papi parse <text>	Parse placeholder text and see result
papi	/papi test <expansion> <key>	Test a specific placeholder

Example Usage

# List all loaded expansions
/papi list

# Parse a placeholder string
/papi parse "Hello %player_name%, you have %economy_money% coins!"

# Test a specific placeholder
/papi test server tps

# Reload configuration
/papi reload

Built-in Placeholders

Expansion	Placeholder	Description
General	%general_motd%	Server MOTD
Player	%player_name%	Player's display name
Player	%player_x%, %player_y%, %player_z%	Player coordinates
Player	%player_dimension%	Current dimension ID
Player	%player_health%	Current health
Player	%player_max_health%	Maximum health
Player	%player_level%	Experience level
Player	%player_gamemode%	Current game mode
Player	%player_ping%	Player latency/ms
Server	%server_online_players%	Online player count
Server	%server_max_players%	Maximum player slots
Server	%server_tps%	Server ticks per second
Server	%server_load%	Server load percentage
Server	%server_ip%	Server IP address
Server	%server_motd%	Server MOTD
Server	%server_version%	Server version
Time	%time_date%	Current date
Time	%time_time%	Current time
Time	%time_unix%	Unix timestamp

Third-Party Placeholders

These plugins register their own placeholders through PlaceholderAPI:

Plugin	Placeholder	Description
EconomyAPI	%economy_money%	Player's wallet balance
EconomyAPI	%economy_bank%	Player's bank balance
EconomyAPI	%economy_debt%	Player's current debt
PurePerms	%pureperms_rank%	Player's rank/group
PurePerms	%pureperms_prefix%	Player's prefix
PurePerms	%pureperms_suffix%	Player's suffix
EssentialsTP	%essentialstp_home_count%	Player's home count

Configuration Options

const PLACEHOLDER_CONFIG = {
  debug: false,
  maxParseInputLength: 240,
  cacheTtl: {
    generalMs: 1000,
    serverMs: 1000,
    timeMs: 1000,
    playerMs: 250
  },
  enabledExpansions: {
    general: true,
    player: true,
    server: true,
    time: true
  }
};

Developer API

Plugins can register custom expansions:

// Register a custom expansion
placeholderPlugin.runtime.registerExpansion({
  identifier: "myplugin",
  version: "1.0.0",
  author: "You",
  onPlaceholderRequest: (player, key) => {
    if (key === "custom_value") return "42";
    return null;
  }
});

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, PureChat, ScoreHud, and EssentialsTP.
• ✅ License: GPL-3.0 - Free to use, modify, and distribute under the same terms.

Installation

1. Download PlaceholderAPI from CurseForge (comes as .mcpack file)
2. Change file extension: Rename PlaceholderAPI.mcpack to PlaceholderAPI.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 PlaceholderAPI 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/PlaceholderAPI/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. Follow the installation steps above to add PlaceholderAPI
3. Restart your server to initialize the plugin
4. Use /papi list to verify expansions are loaded
5. Use /papi parse "Hello %player_name%!" to test parsing
6. Other plugins (EconomyAPI, PurePerms, etc.) will auto-register their expansions

Need help with placeholders? 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.