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 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.

Vythisi

Compatibility

Minecraft: Java Edition

Tags

Creators

Details