ChatTracker

ChatTracker FAQ

General Questions

Q: What is ChatTracker? A: ChatTracker is a chat monitoring plugin for Minecraft servers that logs chat messages, flags inappropriate content, allows staff to communicate privately via Staff Chat, and lets players report messages in-game. It’s designed to keep communities safe and organized while providing clear moderation tools.

Q: Why should I use ChatTracker over other chat plugins? A:

• Built-in Big Brother system flags banned words automatically.
• Staff Chat allows private communication for moderators.
• Hoverable and clickable messages let players report messages instantly.
• Color-coded chat per rank, making messages visually clear.
• Temporary rank overrides for testing or promotions.
• Fully configurable through config.yml.
• Lightweight and optimized for performance.

Installation & Setup

Q: How do I install ChatTracker? A:

1. Download the latest release from GitHub Releases.
2. Place the ChatTracker.jar file in your server’s /plugins folder.
3. Restart your server.
4. Configuration files will generate automatically.

Q: How do I configure banned words? A:

• Open config.yml.
• Add or remove words from the banned-words list.
• Save the file and reload the plugin with /chattracker reload or by restarting the server.

Q: How do I set up ranks and colors? A:

• Edit config.yml under the ranks section.
• Each rank can have a prefix, suffix, name color, and message color.
• You can also temporarily override ranks with /setrank <player> <group> and reset them with /resetrank <player>.

Commands

Q: What commands are available? A:

• /chattracker reload – Reloads the plugin configuration.
• /chattracker logs – Displays recent chat logs in-game.
• /staffchat <message> – Sends a message to all online staff; you can also toggle it on/off.
• /setrank <player> <group> – Temporarily sets a player’s rank.
• /resetrank <player> – Resets a player’s rank to their default.
• /report <player> <message> – Report a message directly by clicking on it in chat or manually typing it.

Reporting & Moderation

Q: How does reporting work? A:

• Players can hover over chat messages flagged by ChatTracker and click to report.
• Reports are sent directly to online staff with chattracker.moderate permission.
• Reports are logged in plugins/ChatTracker/reports/ with timestamps for review.

Q: How are flagged messages handled? A:

• Messages containing banned words trigger an alert to staff.
• These messages are logged separately in the chatlogs/flags-YYYY-MM-DD.txt file for auditing.

Q: Can staff communicate privately? A:

• Yes! Staff can use Staff Chat.
• Use /staffchat to toggle or send messages.
• Only players with chattracker.staffchat permission will see these messages.

Permissions

Troubleshooting

Q: I clicked “Report” in chat, but it says “unrecognizable command.” A:

• Ensure /report command is registered in plugin.yml.
• Ensure players have permission to run the command if needed.
• Make sure no typos exist in the command definition.

Q: My chat colors or prefixes aren’t showing correctly. A:

• Make sure you use & color codes in config.yml.
• Double-check your rank group names match exactly in the config and temporary overrides.

Q: Staff Chat messages appear in public chat. A:

• Staff Chat is only visible to those with chattracker.staffchat permission.
• Ensure staff have the correct permission node.