ChatHistoryEnhanced

ChatHistoryEnhanced is a lightweight, efficient chat logging and moderation tool built for modern Paper servers. It seamlessly tracks player chat history and features an automated flagging system with an intuitive in-game GUI for staff review.

Features

• Persistent Chat Logging: Automatically saves the last X messages (configurable, default 50) per player. Data is stored cleanly by UUID, meaning logs are safe even if a player changes their username.
• Automated Word Flagging: Intercepts and cancels messages containing blacklisted words defined in your badwords.yml file.
• Staff Review GUI: Admins can easily review flagged messages in an interactive chest menu. Simply Left-click to confirm the violation, or Right-click to dismiss it as a false alarm.
• Smart Notifications: Staff are notified in-game when a message is flagged and receive helpful reminders of pending reviews upon logging in. (These notifications are fully toggleable).
• Bypass System: Easily exempt specific players or permission groups from being logged or flagged.
• Rich Text Support: Fully supports MiniMessage formatting for all plugin messages, allowing for beautiful, modern text formatting, hover events, and colors.

Commands & Permissions

Note: Players with the chathistory.bypass permission (or those explicitly listed in config.yml) will bypass chat logging and the bad-word filter.

Configuration

ChatHistoryEnhanced is highly customizable. Upon first load, it generates four intuitive configuration files in your plugins folder:

• config.yml: Set your global prefix, maximum messages to log per player, bypass settings, and toggle staff notification behaviors.
• messages.yml: Completely customize every message the plugin sends using MiniMessage tags.
• badwords.yml: Define the trigger words for the automated flagging system.
• flagged.yml: (System file) Safely stores pending flagged messages, ensuring flags persist across server restarts.

Built for PaperMC. Requires an up-to-date server environment to support the Adventure/MiniMessage APIs.