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.ymlfile. - 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
| Command | Description | Permission |
|---|---|---|
/chatlog <player> |
View a player's recent chat history. | chathistory.admin |
/chatlog review |
Open the GUI to review flagged messages. | chathistory.admin |
/chatlog unflag <id> |
Manually remove a specific flagged message by ID. | chathistory.admin |
/chatlog reload |
Reload all plugin configurations. | chathistory.reload |
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.
