chat.yml

The Chat System adds formatted global chat messages, private messaging commands (/msg, /tell, /r), and interactive player hovers with live stats. It replaces the vanilla Minecraft chat with a customizable format supporting colors, RGB, and hover/click actions.

All configuration is done inside:

/plugins/CrisStealCore/
 ├── chat.yml

---

⚙️ Basic Configuration Example

enabled: true

chat:
  format: "&7{displayname} &f{message}"

  permissions:
    colors: "criscore.chat.color"
    rgb: "criscore.chat.rgb"

  hover-messages:
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - "&c❤ &7Hearts: &c{hearts} &7{hearts_symbol}"
    - "&7Kills: &a{kills} &7| &cDeaths: &c{deaths}"
    - "&7K/D Ratio: &e{kd_ratio}"
    - "&7Hearts Stolen: &c{stolen} &7| &7Lost: &c{lost}"
    - "&7Level: &b{level} &7| &7Health: &c{health}/20"
    - "&8&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
    - "&eClick to send private message!"

  click-command: "msg {player} "

---

🧩 Features

💬 Custom Chat Format

• Define how player messages appear in chat.

• Uses placeholders:

  • {displayname} — Player’s formatted display name.

  • {username} — Player’s username.

  • {message} — The actual message.

  • {world} — The player’s current world.

• Supports color codes (&a, &b, &c…) and RGB hex (&#RRGGBB).

Example output:

[VIP] Steve » Hello everyone!

---

🌈 Color Permissions

Setting	Permission	Description
colors	criscore.chat.color	Allows basic color codes (&a, &b, &c, etc.).
rgb	criscore.chat.rgb	Allows RGB colors like &#FFAA00. Includes criscore.chat.color.

---

🪄 Hover Display

When players hover over a player’s name in chat, a detailed hover tooltip appears:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❤ Hearts: 16 ❤
Kills: 4 | Deaths: 1
K/D Ratio: 4.0
Hearts Stolen: 2 | Lost: 0
Level: 15 | Health: 20/20
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Click to send private message!

📘 Hover placeholders: {player}, {displayname}, {hearts}, {hearts_symbol}, {kills}, {deaths}, {stolen}, {lost}, {kd_ratio}, {world}, {level}, {health} Supports PlaceholderAPI placeholders if installed.

---

🖱️ Click Command

When clicking a player’s name, it automatically runs:

/msg {player}

You can change this to:

• "msg {player} "

• "tell {player} "

• or "none" to disable click interaction.

---

📩 Private Message System

CrisStealCore includes built-in support for:

• /msg

• /tell

• /r (reply)

---

🗨️ /msg and /tell

Field	Description
Usage	/msg <player> <message> or /tell <player> <message>
Permission	None by default (can be limited using command permissions).
Sender Format	&7[&eYou &7-> &e{receiver}&7] &f{message}
Receiver Format	&7[&e{sender} &7-> &eYou&7] &f{message}
Errors	“Player not found” / “You cannot message yourself.”

Example:

[You -> Steve] Hi!
[Alex -> You] Hey there!

---

🔁 /r – Reply Command

Field	Description
Usage	/r <message>
No-one-to-reply	"&cYou have no one to reply to."
Player-offline	"&cThat player is offline."

Example:

/r Got it!

Replies to the last person you messaged or who messaged you.