# Heroine — Advanced Server Security & Moderation

Heroine is an all-in-one security and moderation plugin designed to help Minecraft server owners protect their communities against suspicious connections, automated bot attacks, chat abuse, and exploit-related activity.

Built with configurable protection systems and practical moderation tools, Heroine gives server administrators greater control over server access, player behavior, and security monitoring — all through a single plugin.

✨ Features

🛡️ Advanced AntiBot Protection

• Per-IP and global connection rate limiting.
• Automatic temporary IP blocking based on suspicious connection patterns.
• IP and CIDR allowlist and blocklist management.
• Connection burst control and adaptive rate limiting.
• Reconnection queue for periods of heavy connection traffic.
• Emergency lockdown mode with configurable player access.
• Per-IP account and concurrent connection limits.

🔍 Suspicious Connection Detection

• Heuristic risk scoring to identify potentially abusive behavior.
• Connection pattern analysis and suspicious activity monitoring.
• In-game tools to review suspicious connections.
• Configurable thresholds and automatic protection responses.

🔐 Anti-Exploit Protection

• Detects unusually high inventory click and drag activity.
• Validates oversized or suspicious book payloads.
• Helps identify abnormal interaction patterns.
• Records relevant security events for administrator review.

💬 Chat Filter & Anti-Spam

• Configurable message cooldowns.
• Repeated-message detection.
• Advertising and blocked-word filtering.
• Excessive capitalization and character-flood detection.
• Heuristic chat risk analysis.

⛏️ X-Ray & Inventory Dupe Auditing

• Monitors suspicious valuable-ore mining patterns.
• Audits unexplained inventory item-count increases.
• Configurable detection thresholds and audit cooldowns.
• Designed to support staff investigations rather than automatically punish every flagged player.

⚖️ Player Moderation System

• Permanent and temporary bans.
• Permanent and temporary mutes.
• Player warnings and kicks.
• Ban, mute, and warning history.
• Active punishment status checks.
• Customizable punishment reasons and expiration durations.

📋 Security Logs & Webhooks

• File-based security audit logging.
• Configurable log rotation and retention.
• Optional webhook notifications for selected security events.
• Separate configuration files for language, messages, menus, and protection settings.

🌐 Optional Anti-VPN Integration

• Supports an external connection-reputation provider.
• Configurable VPN, proxy, hosting, and datacenter filtering.
• Configurable cache, timeout, and provider-failure behavior.
• Requires a compatible external provider and endpoint configuration.

🌍 Language Support

• English and Indonesian language files included.
• Configurable messages and language selection.

⚙️ Configuration

Heroine provides configurable protection thresholds, connection limits, detection windows, audit settings, IP rules, and moderation messages.

Administrators can adjust its behavior to suit their server's needs.

📦 Compatibility

• Minecraft Java Edition
• Plugin API version: 1.20
• Designed for compatible Spigot/Paper-based servers
• Floodgate soft-dependency support

Check your server software and Minecraft version for compatibility before installation.

🚀 Installation

1. Download the Heroine plugin JAR.
2. Place it inside your server's plugins folder.
3. Start or restart your server.
4. Review the generated configuration files.
5. Adjust the protection settings to fit your environment.

⚠️ Important Notes

Heroine focuses on application-level connection protection and security monitoring. It is not a replacement for network-level DDoS mitigation, a firewall, or appropriate proxy infrastructure.

Anti-VPN functionality requires a compatible external provider and is disabled by default. Detection and audit systems should be configured and reviewed carefully to minimize false positives.

Heroine — One plugin. Multiple layers of server protection.