ChatTracker
Track conversations, analyze chat logs, and keep your community safe and fun — all in one lightweight plugin.

Demo Video



Description

ChatTracker keeps an eye on all chat activity across your server. It logs messages with timestamps, tracks reports, and helps staff handle problems quickly without getting in the way of normal gameplay.

The plugin comes with a Big Brother system that flags bad words/phrases, notifies online staff, and keeps a separate log so nothing slips by.

Staff also get their own private chat channel, and players can easily report messages with hoverable/clickable chat. Everything is logged so staff have a reliable history to look back on.

This plugin is built to be lightweight, simple, and effective, while still giving staff the tools they need to keep your community clean.

Features

• Tracks all player chat messages in real-time
  
  
• Color-coded chat per rank (easy to see who’s talking)
  
  
• Hoverable & clickable reports to flag messages instantly
  
  
• Automatic flagging of bad words/phrases with Big Brother alerts
  
  
• Staff Chat – fully working private staff channel with toggle
  
  
• Temporary rank override commands for testing/promotion events
  
  
• Chat logs & report logs saved with timestamps
  
  
• Lightweight and performance-friendly
  
  
• Easy setup, minimal config required

Commands

/chattracker reload - Reloads config
/chattracker logs - Shows recent chat logs in-game
/staffchat <message> - Sends to staff-only chat (toggle on/off)
/setrank <player> <group> - Temporarily change rank
/resetrank <player> - Reset a player’s rank
/report <player> <msg> - Report inappropriate message

Permissions

chattracker.view - View tracked logs
chattracker.moderate - Get flagged message alerts & reports
chattracker.staffchat - Use staff chat
chattracker.setrank - Use temp rank commands
chattracker.admin - Full access

Screenshots







Changelog

v1.3 (Latest)

• Added hoverable & clickable reports for players
  
  
• Improved chat log system with timestamp formatting
  
  
• New temporary rank override commands
  
  
• Staff Chat polished with toggle
  
  
• General cleanup & optimizations

v1.2

• Staff Chat fully implemented
  
  
• Improved log organization & alerts

v1.0 – Big Brother

• Core chat tracking
  
  
• Permissions & basic commands
  
  
• Flagged word alerts

Roadmap (Upcoming Features)

• 
  Player Monitoring
  • /check <player> → Shows info (IP, alts, punishments, reports, last login).
    
    
  • /history <player> → See all punishments and reports tied to them.
    
    
  • /seen <player> → Last online time.
    
  Staff Utilities
  • CommandSpy → View commands players are running.
    
    
  • SocialSpy → View private messages between players.
    
    
  • /freeze <player> → Temporarily freeze a player for investigation.
    
    
  • Silent Join/Leave → Staff can log in/out without alerts.
    
    
  • Staff Mode → Special gamemode with inspector tools (teleport, vanish, freeze, randomTP).
    
  Punishment Enhancements
  • Timed Punishments → e.g., /ban <player> 7d <reason>.
    
    
  • Mute System → Temporary/permanent mute with reasons.
    
    
  • Warning Escalation → X warnings = auto mute/ban.
    
    
  • Appeals Log → Optional system to mark punishments as appealed.
    
  Logs & Analytics
  • MySQL / SQLite support → Store punishments/reports in a database.
    
    
  • Web Panel support → Optional frontend for staff to review punishments/reports.
    
    
  • Export Logs → Generate staff activity reports weekly/monthly.
    
  Player Protection
  • Anti-Alt Detection → Alert staff if players with the same IP join.
    
    
  • VPN/Proxy detection → Optional alerts if suspicious connections are used.
    
    
  • Chat Filter → Block certain words with staff alerts (already partly in).
    
  Quality of Life
  • Clickable Teleports in reports (click player name to teleport).
    
    
  • Customizable GUI Menus (e.g., for punishments, staff tools).
    
    
  • Integration with LuckPerms for rank syncing.
    
    
  • Discord Integration → Send reports & punishments to a staff Discord channel.
    

Dependencies

• Runs on PaperMC (latest recommended build)
  
  
• No extra plugins required

Installation

1. Download the latest release from GitHub or Spigot
   
   
2. Drop ChatTracker.jar into your /plugins/ folder
   
   
3. Restart your server
   
   
4. Config will generate automatically

License
MIT License (do whatever you want, just credit back.)