💬 KNChat

An advanced, high-performance, and flexible chat management plugin for Minecraft servers. Developed specifically to handle advanced cross-network formatting using LuckPerms metadata, alongside local world isolation, custom chat triggers, and interactive components.

---

✨ Features

• 🌐 Cross-Network Prefixes: Dynamically displays player prefixes based on their origin server or network group using LuckPerms metadata triggers. Perfect for multi-server setups (like BungeeCord or Velocity networks) sharing a single chat backend.
• 🏷️ Multi-Level Priority System: Define a strict hierarchy for group prefixes within different networks. If a player belongs to multiple LuckPerms groups (e.g., Admin and VIP), KNChat ensures the highest priority prefix is displayed.
• ⚡ Interactive Reply System: Adds a sleek, clickable [Reply] button next to chat messages. Players can hover to see details and click to instantly prepare the /reply command for fast messaging.
• 🔊 Smart Mention System: Tag players using @Player Name. Mentioned players receive a customizable sound effect and a beautiful visual highlight in their chat.
• 🌍 Per-World Chat & Groups: Isolate chat between worlds or group specific worlds together (e.g., separate mini-games or lobbies while keeping standard nether/end dimensions connected).
• 🛠️ Custom Configuration Commands: Register custom commands (like /rules or /discord) directly in the configuration with support for multi-line messages, player-executed commands, and console execution.
• 🎨 Full Color & HEX Support: Complete legacy (&a) and modern HEX Color Codes (&#00C6FF) support across all formats, custom placeholders, and player messages.
• 📁 Safe Async Chat Logger: Safely logs all chat interactions into a structured chat.log file asynchronously without impacting server performance.

---

⚙️ Default Configurations

config.yml

# Global chat format template
# {PREFIX_META} -> Dynamic cross-network prefix (calculated from meta-config.yml)
# {PREFIX}      -> Standard primary prefix fetched directly from LuckPerms
# {SUFFIX}      -> Standard primary suffix fetched directly from LuckPerms
# {PLAYER}      -> Name of the message sender
# {MESSAGE}     -> The chat message itself
chat-format: "{PREFIX_META}{PREFIX}&f{PLAYER}{SUFFIX} &8» &f{MESSAGE}"

# Chat format used when a player replies to someone using the [Reply] button
# Supports all variables above + {TARGET} (name of the player being replied to)
reply-format: "{PREFIX_META}{PREFIX}&f{PLAYER}{SUFFIX} &7(replied to &a{TARGET}&7) &8» &f{MESSAGE}"

# Interactive reply button settings
reply-button:
  enabled: true
  text: " &8[&aReply&8]"
  hover-text: "&7Click to quickly reply to &a{PLAYER}"

# Per-World Chat settings
per-world-chat:
  enabled: true
  world-groups:
    overworld_group:
      - "world"
      - "world_nether"
      - "world_the_end"
    games_group:
      - "lobby"
      - "arena"

# Player mention system settings (@Player)
mention-system:
  enabled: true
  require-at-symbol: true
  highlight-format: "&e&l@{PLAYER}&r"
  sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
  volume: 1.0
  pitch: 1.0

# File logging system (Saves all chat logs safely to plugins/KNChat/logs/chat.log)
chat-logger:
  enabled: true
  timestamp-format: "yyyy-MM-dd HH:mm:ss"

# Allow players to use color codes (& and HEX) in their chat messages?
allow-chat-colors: true

# Your custom global placeholders
custom-placeholders:
  "{SERVER_IP}":
    value: "&#00C6FFplay.yourserver.com"
  "{WEBSITE}":
    value: "&aworld.yourserver.com"

# Custom commands that run directly from the configuration
custom-commands:
  rules:
    message:
      - "&7&m========================================"
      - "              &e&lSERVER RULES"
      - "&f1. &7Be respectful to all players."
      - "&f2. &7Hacking or cheating is strictly prohibited."
      - "  &6Full rules can be found here: {WEBSITE}/rules"
      - "&7&m========================================"

  discord:
    message:
      - "&7&m========================================"
      - "   &9&lDISCORD LINK: play.yourserver.com/discord"
      - "&7&m========================================"

---

meta-config.yml

# The metadata key looked up in LuckPerms to determine the player's current network/server group
meta-key: "from"

# Default network fallback if the player doesn't have any specific meta-key set
fallback-network: "survival"

networks:

  survival:
    priority:
      - "admin"
      - "moderator"
      - "vip"
      - "default"

    admin:
      prefix: "&r&#FF1B1B&lᴀᴅᴍɪɴ &r"

    moderator:
      prefix: "&r&#FF8D70&lᴍᴏᴅ &r"

    vip:
      prefix: "&r&#FFE600&lᴠɪᴘ &r"

    default:
      prefix: "&7Player &r"

  creative:
    priority:
      - "admin"
      - "builder"
      - "default"

    admin:
      prefix: "&c[Admin] &r"

    builder:
      prefix: "&a[Builder] &r"

    default:
      prefix: "&7[Guest] &r"

---

🔒 Permissions

Permission	Description
knchat.admin	Allows use of administrative commands.
knchat.chat.colors	Allows players to use color codes (&) and HEX colors in chat.

---

📜 Commands

Command	Description
/knchat reload	Reloads all configuration files without restarting the server.
/reply <player> <message>	Sends a quick reply message.
/r <player> <message>	Alias of /reply.

---

📈 Dependencies

• LuckPerms

---

✅ Compatibility

• Spigot 1.20+
• Paper 1.20+
• Purpur 1.20+

---

🚀 Perfect For

• Survival Networks
• Minigame Networks
• SMP Servers
• Community Servers
• Velocity Setups
• BungeeCord Setups
• Servers using LuckPerms Metadata

---

KNChat brings modern chat management, cross-network prefixes, smart mentions, interactive replies, world isolation, and powerful customization into one lightweight plugin.