Minecraft plugin AntiSpam

🔌 About AntiSpam

AntiSpam is a Minecraft plugin that monitors chat activity and helps keep server chat clean by detecting repeated or similar messages, flooding, blocked words, and other unwanted chat behaviour. It is modular (features can be enabled or disabled) and provides both local storage (SQLite) and MySQL support for larger setups and web integration.

🎯 Purpose

AntiSpam is designed for server administrators and moderation teams who need automated detection and handling of chat abuse: spam, repeated characters, fast message flooding, and blacklisted words. It also provides tools for gathering reports and reviewing punishment history.

⚙️ Features

• Detection of repeated or very similar messages.
• Anti-flood protection (message rate limits and excessive character repetition checks).
• Fully configurable blocked-words blacklist.
• Automatic punishment system with configurable triggers and custom commands for punishments.
• Unique punishment IDs for tracking and lookup of actions.
• Smart chat reporting system that saves recent messages for staff review.
• Optional web panel integration (requires MySQL) to view punishments, logs and reports.
• Multi-language support (English, Czech, German) and configurable messages.
• Discord webhook support for notifications.

🧩 Who It Is For

• Survival / SMP servers wanting automated chat moderation.
• Public servers with active communities where spam and advertising are issues.
• Servers that want a web-accessible audit of chat punishments and reports.

🏗️ Example Use Cases

• Automatically mute or run a punishment command after a player repeats blocked words multiple times.
• Staff members open a report created through the plugin and view the saved recent chat for context.
• Administrators search punishment history by unique ID to verify or revert actions.

⌨️ Commands

Note: Only commands confirmed in official project sources are listed above.

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official plugin JAR and place it in your server plugins/ directory.
• Restart the server and confirm the plugin loads in console logs.
• For web panel features, configure a MySQL database and enable the web integration in the plugin configuration.

📦 Dependencies

• No required external plugin dependencies are documented. MySQL is required only for the web panel; SQLite is supported out of the box.

🧾 Configuration

• The plugin uses a config.yml for settings (feature toggles, limits, delays, punishments, database settings).
• Language files are provided and can be edited.

🧠 Technical Notes

• Storage: built-in SQLite for single servers; MySQL supported and required for the web panel.
• Modular design: individual protections (spam, flood, blocked words, reports, web panel, Discord webhooks) can be enabled/disabled.
• Unique punishment IDs are generated for each recorded action to aid searching and auditing.

🤝 When This Plugin Is Useful

If you need automated, configurable chat moderation with recordable punishments and optional web access for logs and reports, AntiSpam provides a modular system suitable for small servers and larger networks that require MySQL-backed data and a remote web interface.