SGChat
A lightweight, configurable, and secure chat plugin for your Minecraft server.
----------------------------------------
✨ Main Features

• Forbidden word filtering with automatic warnings
• Configurable automute system (temporary mute with duration and reason)
• Anti-spam and duplicate message blocking
• Customizable chat formats (global and per group)
• Configurable messages in
  Code (Text):

  messages.yml
• Join/Quit/MOTD messages configurable in
  Code (Text):

  config.yml
• Commands:
  Code (Text):

  /msg
  ,
  Code (Text):

  /r
  ,
  Code (Text):

  /mute
  ,
  Code (Text):

  /unmute
  ,
  Code (Text):

  /clear
  ,
  Code (Text):

  /sgchat
  (reload)
• PlaceholderAPI support (if installed)
• Optimized and compatible with Paper/Spigot

----------------------------------------
Installation

1. Copy the
   Code (Text):

   .jar
   file into your
   Code (Text):

   plugins
   folder
2. Start (or restart) your server
3. Edit
   Code (Text):

   config.yml
   and
   Code (Text):

   messages.yml
   according to your needs
4. Use
   Code (Text):

   /sgchat reload
   to apply changes without restarting

----------------------------------------
⚙️ Configuration
config.yml

• Code (Text):

  chat.enable-format
  — boolean
• Code (Text):

  chat.format
  — default format; placeholders: {nivel}, {player}, {displayname}, {message}
• Code (Text):

  chat.enable-group-formats
  — enable per-group formats
• Code (Text):

  chat.group-formats
  — map role → format (uses default if group not specified)
• Code (Text):

  join.enabled
  /
  Code (Text):

  join.message
  — public join message
• Code (Text):

  quit.enabled
  /
  Code (Text):

  quit.message
  — public quit message
• Code (Text):

  motd.message
  — sent only to joining player
• Code (Text):

  chat.blocked-words
  ,
  Code (Text):

  chat.warnings-before-mute
  , etc.

messages.yml

• System messages: warnings, errors, confirmations, command outputs
• Does not include chat, join/quit, or MOTD formats
• If
  Code (Text):

  enable-mute: false
  , only blocks forbidden words, no warnings/mutes

----------------------------------------
Commands & Permissions

• Code (Text):

  /sgchat
  —
  Code (Text):

  sgchat.admin
  — Displays help and subcommands
• Code (Text):

  /sgchat reload
  —
  Code (Text):

  sgchat.reload
  — Reloads config.yml and messages.yml
• Code (Text):

  /msg <player> <message>
  —
  Code (Text):

  sgchat.msg
  — Sends private message
• Code (Text):

  /r <message>
  —
  Code (Text):

  sgchat.msg
  — Reply to last /msg
• Code (Text):

  /mute <player> [time] [reason]
  —
  Code (Text):

  sgchat.mute
  — Temporarily mute a player
• Code (Text):

  /unmute <player>
  —
  Code (Text):

  sgchat.unmute
  — Unmute a player
• Code (Text):

  /clear
  —
  Code (Text):

  sgchat.clear
  — Clears chat

----------------------------------------
Behavior & Technical Details

• ASCII banner in console on startup (version, author, support link)
• Main class SGChatPlugin extends JavaPlugin
• Uses ConfigUtil / ConfigManager to avoid duplicate events
• MOTD sent only to joining player
• Group formats can be disabled with
  Code (Text):

  chat.enable-group-formats: false
• System messages configured in messages.yml

----------------------------------------
✅ Quick Testing & Recommendations

• Edit config.yml for formats, join/quit, MOTD
• Edit messages.yml for warnings, errors, confirmations, commands
• Test commands:
  • Code (Text):

    /sgchat
    — without permission shows “no-permission”; with sgchat.admin shows subcommands
  • Code (Text):

    /mute player 5m Troll
    — staff sees duration and reason; player notified
  • Code (Text):

    /unmute player
    — both player and staff notified
  • Code (Text):

    /clear
    — clears chat with message

----------------------------------------
Compatibility

• Works with Paper, Spigot, and compatible forks
• Java 17+ recommended

----------------------------------------
SGChat — Keep your server chat clean, safe, and professional with a plugin that’s easy to configure and fully optimized.