PureChat - PMMPCore Plugin

PureChat Plugin (Click for More)

PureChat is a comprehensive chat formatting plugin for PMMPCore Framework that brings fully customizable chat and nametag formatting to Minecraft Bedrock. Integrates with PurePerms and PlaceholderAPI for dynamic, group-based chat displays.

What Does This Plugin Do?

PureChat intercepts chat messages and applies custom formatting based on the player's PurePerms group. It supports prefixes, suffixes, custom chat formats, nametag updates, per-world formatting, and full PlaceholderAPI integration for dynamic content in chat messages and player nametags.

⚠️ Requirements

Requirement	Status	Details
❌ PMMPCore Framework	Required	This plugin cannot work without PMMPCore Framework installed.
❌ PurePerms	Required	Permission system for group-based chat formatting.
❌ PlaceholderAPI	Required	Placeholder parsing for dynamic chat content.
❌ Beta APIs	Required	Uses experimental Bedrock Script APIs (disables Xbox Achievements).
✅ Server Owner	Recommended	Designed for server administrators configuring chat displays.

Key Features

• ✅ Group-Based Chat Formatting: Each PurePerms group has its own chat and nametag format.
• ✅ Prefix/Suffix System: Set custom prefixes and suffixes per player.
• ✅ Dynamic Nametags: Automatically update player nametags with group formatting.
• ✅ Per-World Formatting: Different chat formats for different worlds.
• ✅ PlaceholderAPI Integration: Full placeholder support in all chat and nametag templates.
• ✅ Chat Interception: Intercepts and reformats all chat messages in real-time.
• ✅ Preview Command: Preview how your chat and nametag will appear.
• ✅ MultiWorld Support: Works with MultiWorld plugin for cross-world chat formatting.

🛠️ Available Commands

Command	Syntax	Description
pchat	/pchat setprefix <player> <prefix>	Set a player's prefix
pchat	/pchat setsuffix <player> <suffix>	Set a player's suffix
pchat	/pchat setformat <group> <world> <format>	Set group chat format
pchat	/pchat setnametag <group> <world> <format>	Set group nametag format
pchat	/pchat preview	Preview your chat and nametag display
setprefix	/setprefix <player> <prefix>	Legacy command to set prefix
setsuffix	/setsuffix <player> <suffix>	Legacy command to set suffix
setformat	/setformat <group> <world> <format>	Legacy command to set format
setnametag	/setnametag <group> <world> <format>	Legacy command to set nametag

Example Usage

# Preview your chat display
/pchat preview

# Set prefix for a player
/setprefix Steve "&b[VIP]"

# Set chat format for Admin group
/setformat Admin global "&3{prefix}&c[Admin]&f {display_name} &7> {msg}"

Configuration Options

Configure PureChat formatting in the plugin config:

const PURECHAT_DEFAULTS = {
  enableMultiworldChat: false,
  groups: {
    Guest: {
      chat: "&3{prefix}&e[Guest]&f {display_name} &7> {msg}",
      nametag: "&3{prefix}&e[Guest]&f {display_name}",
      worlds: {}
    },
    Admin: {
      chat: "&3{prefix}&c[Admin]&f {display_name} &7> {msg}",
      nametag: "&3{prefix}&c[Admin]&f {display_name}",
      worlds: {}
    },
    Owner: {
      chat: "&3{prefix}&a[Owner]&f {display_name} &7> {msg}",
      nametag: "&3{prefix}&a[Owner]&f {display_name}",
      worlds: {}
    }
  }
};

Available Format Tags

Tag	Description
{prefix}	Player's prefix (from PurePerms)
{suffix}	Player's suffix (from PurePerms)
{display_name}	Player's display name
{msg}	The chat message content
{group}	Player's group name
{world}	Current world/dimension name
%placeholders%	Any PlaceholderAPI placeholders

Permission System

Permission Node	Feature	Default Group
pchat	Use PureChat features	Guest
pchat.coloredMessages	Use color codes in messages	Guest
pchat.command	Use /pchat command	Admin
pchat.command.setprefix	Set player prefixes	Admin
pchat.command.setsuffix	Set player suffixes	Admin
pchat.command.setnametag	Set group nametag formats	Admin
pchat.command.setformat	Set group chat formats	Admin

Compatibility & Requirements

• ⚠️ Requires PMMPCore Framework: This plugin is part of the PMMPCore ecosystem and cannot function independently.
• ⚠️ Requires PurePerms: Group system is required for group-based formatting.
• ⚠️ Requires PlaceholderAPI: Placeholder parsing is required for dynamic content.
• ⚠️ Requires Beta APIs: Uses experimental Bedrock Script APIs and disables Xbox Achievements.
• ✅ Version: Optimized for Minecraft Bedrock Preview 26.20.26.
• ✅ Multiplayer: Fully tested on Realms and Dedicated Servers.
• ✅ License: GPL-3.0 - Free to use, modify, and distribute under the same terms.

Installation

1. Download PureChat from CurseForge (comes as .mcpack file)
2. Change file extension: Rename PureChat.mcpack to PureChat.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 PureChat 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/PureChat/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, PurePerms, and PlaceholderAPI first
2. Follow the installation steps above to add PureChat
3. Restart your server to initialize the plugin
4. Use /pchat preview to see your current chat format
5. Configure group formats in the plugin config
6. Set prefixes and suffixes for players as needed

Need help with chat formatting? Join our Discord Server for support!

---

⚠️ Important Notice: This plugin requires PMMPCore Framework, PurePerms, and PlaceholderAPI. It uses experimental Bedrock APIs that disable Xbox Achievements and requires technical knowledge of server management.