💬 ClientChat Plugin — Full Specification

🌐 Overview

ClientChat Plugin is the server-side component of the ClientChat ecosystem.

It works alongside the ClientChat client mod to provide advanced communication features that are not possible through vanilla Minecraft chat alone.

The plugin manages player sessions, chat routing, room permissions, invitations, and synchronization between connected clients.

Without the ClientChat mod installed on the player's client, most ClientChat features are unavailable.

The plugin does not replace Minecraft's default chat system. Instead, it adds a separate communication layer that operates alongside normal server chat.

---

⚙️ Core Features

💬 Global Chat

Allows ClientChat users connected to the server to communicate through a dedicated chat channel.

👥 Private Chat Rooms

Create invite-only chat rooms for groups of players.

📩 Direct Messages

Send private messages between players.

🔐 Room Permissions

Invitation-based room access controlled by the server.

📡 Message Routing

The plugin manages message delivery between all connected ClientChat users.

🧩 Unified Command System

All features are accessible through the /chat command.

---

📋 Commands

🌍 /chat

Send a message to the current active chat channel.

Example

/chat Hello everyone!

Output

[Steve] Hello everyone!

---

🧠 /chat create

Create a private chat room.

Example

/chat create friends

---

📩 /chat invite

Invite a player to your current room.

Example

/chat invite Alex

---

🚪 /chat join

Join a room after receiving an invitation.

Example

/chat join friends

Responses

✅ Joined room

❌ You are not invited

---

🚪 /chat leave

Leave the current room.

Example

/chat leave

---

🗣️ /chat tell

Send a private message.

Example

/chat tell Alex hello

Output

[DM] Steve → Alex: hello

---

🌐 /chat global

Broadcast a message to all ClientChat users on the server.

Example

/chat global Event starts in 5 minutes!

---

🧠 System Rules

Chat States

Players can be in:

• 🌍 Global Chat

• 👥 Private Room

• 🚪 No Active Room

Permissions

• Rooms require invitations.

• Room messages are only visible to room members.

• Direct messages bypass room restrictions.

• Global messages are visible to all ClientChat users.

---

🔌 Dependency Requirement

ClientChat Plugin requires the ClientChat Mod on the player's client.

Environment

• Client: ClientChat Mod

• Server: ClientChat Plugin (Paper/Spigot)

The plugin provides server-side functionality, while the mod provides the user interface and communication features.

Neither component is intended to function fully without the other.

---

🎨 Chat Formatting

Global

[GLOBAL] Steve: Hello!

Room

[FRIENDS] Alex: Hey!

Direct Message

[DM] Steve → Alex: Hi

Announcement

[GLOBAL] Server restarting in 5 minutes!

---

🚀 Summary

ClientChat is a client-and-server communication system that extends Minecraft with:

• Global chat channels

• Private chat rooms

• Direct messaging

• Invitation management

• Server-side message routing

Together, the ClientChat Mod and ClientChat Plugin provide a lightweight social communication platform directly inside Minecraft.