ChatTracker Logo

Track conversations, analyze chat logs, and keep your server community safe and fun.

# Description ----------------------------------- **ChatTracker** monitors all chat activity on your server, logging messages with timestamps and player names so you always have a record. Its **Big Brother** feature checks messages for banned words or phrases, flags them, and notifies online moderators automatically. **Staff Chat** lets moderators communicate privately without interfering with public chat. **Hoverable and clickable reports** allow players to report inappropriate messages in-game directly to staff.

**New in v1.3**: Staff can now issue **clickable punishments (Warn, Kick, Ban)** directly from reports, with all punishments logged for transparency. ChatTracker helps staff stay on top of rule-breaking behavior efficiently and reliably, with enhanced message formatting to make chat clear and readable.

# Features ----------------------------------- - Tracks all player chat messages in real time. - Color-coded chat for ranks, messages stand out according to group. - Hoverable and clickable reports to quickly flag inappropriate messages. - **Clickable punishments** (Warn, Kick, Ban) with full logging. - Logs all messages, reports, and punishments with timestamps for staff review. - Flags inappropriate messages automatically using the Big Brother system. - **Staff Chat** – private channel for moderators, fully implemented with toggle functionality. - Temporary rank overrides with commands for testing or promotions. - Lightweight and optimized for performance. - Easy setup with minimal configuration required.

# Roadmap ----------------------------------- ### (Upcoming Features) Player Monitoring * /check → Shows info (IP, alts, punishments, reports, last login). * /history → See all punishments and reports tied to them. * /seen → Last online time. ----------------------- Staff Utilities * CommandSpy → View commands players are running. * SocialSpy → View private messages between players. * /freeze → 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 7d . * 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.

# Screenshots & Demo ----------------------------------- ### Video Showcase ----------------------------------- [![ChatTracker Demo](https://img.youtube.com/vi/9yy0CFVh4Mc/0.jpg)](https://www.youtube.com/watch?v=9yy0CFVh4Mc) *Click to watch ChatTracker in action — see staff chat, hoverable reports, and flagged message alerts in-game.* --- ### Screenshots -----------------------------------

Examples of Staff Chat, hoverable clickable reports, and flagged message notifications in-game.

# Installation ----------------------------------- 1. Download the latest release from [GitHub Releases](https://github.com/Mikeym41/Chattracker/releases). 2. Place the `ChatTracker.jar` file into your server's `/plugins` folder. 3. Restart your server. 4. Configuration files will be generated automatically on first run.

# Permissions ----------------------------------- - `chattracker.view` – Allows viewing tracked chat logs. - `chattracker.moderate` – Allows receiving flagged message alerts, reports, and issuing punishments. - `chattracker.staffchat` – Access to the completed Staff Chat channel. - `chattracker.setrank` – Allows temporary rank changes. - `chattracker.admin` – Full access to ChatTracker commands.

# Commands ----------------------------------- - `/chattracker reload` – Reloads the configuration. - `/chattracker logs` – Displays recent chat logs in-game. - `/staffchat ` – Sends a message to all online staff (toggle functionality included). - `/setrank ` – Temporarily sets a player's rank. - `/resetrank ` – Resets a player to their config-defined rank. - `/report ` – Report a message in-game (clickable through hoverable chat). - `/punish ` – Issue punishments (clickable buttons also available).

# Changelog ----------------------------------- ### v1.3 (Current Release) - **Clickable punishments (Warn, Kick, Ban)** added. - Full punishment logging implemented. - Expanded logging system for chat, reports, and punishments. - UX improvements for staff workflow. ### v1.2 - Hoverable and clickable message reporting implemented. - Color-coded chat messages per rank. - Enhanced chat logging and report logging system. - Temporary rank override commands for quick testing or promotions. - Improved Staff Chat toggle functionality. ### v1.1 - Staff Chat feature fully implemented for moderators. - Improved flagged message notifications. - Enhanced log formatting and organization. ### v1.0-BigBrother - Core chat tracking system. - Permissions system added. - Commands for reloading and viewing logs. - Big Brother flagged word alerts to staff.

# Dependencies ----------------------------------- **PaperMC** (latest recommended build). No additional plugins required.

# License This project is licensed under the MIT License.

ChatTracker

Documentation

Pages