EpicBans 🔨 Punishments System 1.4.4

🌟 Why Choose EpicBans?

EpicBans is the most advanced and feature-rich punishment system available for Minecraft servers. Whether you're running a small community server or a large network, EpicBans provides everything you need to maintain order and create a safe environment for your players.

✨ Key Highlights

• 🎯 Multi-Platform Support - Works seamlessly on Bukkit, Spigot, Paper, BungeeCord, and Velocity
• 🌎 Multi-Language - Full support for English and Italian (more languages coming soon)
• 💾 5 Database Types - H2, SQLite, MySQL, PostgreSQL, MariaDB with seamless conversion between any types
• 🎨 MiniMessage Support - Beautiful gradients and advanced text formatting
• 🤖 Discord Integration - Real-time punishment notifications with staff channels
• 🌐 Web Panel - Complete remote management interface accessible from anywhere
• 📊 Import System - Easy migration from MaxBans and Vanilla
• 🔄 Auto-Update Checker - Automatic notifications when new versions are available
• 🛡️ Advanced Security - Country detection, AntiVPN, duplicate account detection, and immunity system
• 👻 Universal Vanish Support - Works with SuperVanish, PremiumVanish, Essentials, and all Bukkit-compatible vanish plugins
• 🚫 Smart Moderation - AntiCAPS module with configurable thresholds and staff notifications
• 🔧 99% Customizable - Every message, feature, and behavior can be configured

🚀 Features

📋 Complete Punishment System

• Permanent Bans - Ban players permanently from your server
• Temporary Bans - Time-based bans with automatic expiration
• IP Bans - Block entire IP addresses (permanent & temporary)
• Muting System - Silence players permanently or temporarily
• IP Muting - Mute entire IP addresses
• Warning System - Issue warnings with automatic expiration
• Kick System - Remove players from the server instantly
• IP Kick - Kick all players from an IP address
• Offline IP Bans - Ban IP addresses of players who never joined
• Punishment Bypass Protection - Prevent players from bypassing punishments based on UUID

🔐 Commands & Permissions

Complete list of all commands with their required permissions:

🛡️ Special Permissions

• epicbans.bypass - Bypass all punishment checks and restrictions
• epicbans.notify - Receive staff notifications (admin permission)
• epicbans.* - Grant access to all EpicBans commands (admin permission)

> 💡 Tip: Use epicbans.* for full administrative access.

🛡️ Protection & Moderation Modules

🌍 Advanced Security Features

• Country Detection - Automatically detect and display player's country on join
• Country Blacklist - Block players from specific countries
• AntiVPN System - Detect and block VPN/Proxy connections
• Duplicate Account Detection - Identify players with multiple accounts
• Staff Alert System - Notify online staff when banned/muted players try to join or chat

🚫 AntiCAPS Module

• Automatic detection of excessive capital letters
• Configurable caps percentage threshold
• Auto-warn or mute players for caps abuse
• Whitelist for trusted players

📊 Staff Management Tools

• Offline Event Notifications - Staff get updates about what happened while offline
• Real-time Alerts - Instant notifications when banned players try to join
• Punishment History - Complete tracking of all moderation actions
• Database Conversion - Convert current database to any other type with simple commands

🌐 Multi-Platform Excellence

🔧 Bukkit/Spigot/Paper

• Full feature support for single servers
• Adventure API integration for modern text formatting
• Legacy version support (1.7+)
• Async operations for optimal performance

🌉 BungeeCord

• Cross-server punishment synchronization
• Network-wide ban management
• Server-specific punishments
• Real-time player tracking

⚡ Velocity

• Modern proxy support
• High-performance async operations
• Advanced plugin compatibility
• Future-proof architecture

💾 Flexible Database Support

Choose the database that fits your server needs and seamlessly convert between any of them:

🔄 Database Conversion: Use /epicbans convert <to_database> to seamlessly migrate your data. The system automatically detects your current database from config and converts to the target database without losing any information.

🤖 Discord Integration

Transform your moderation workflow with our Discord bot:

• 📢 Real-time Notifications - Instant punishment alerts
• 👮 Staff Channels - Separate channels for staff actions
• 🔕 Silent Punishments - Private notifications for staff
• 🎭 Custom Bot Status - Configurable activity display
• 🔔 Offline Event Alerts - Get notified about missed events
• 🌐 Multi-Language Support - Discord messages in your preferred language

Setup Guide: Follow our Discord Integration Tutorial for easy bot configuration.

🌐 Web Panel Management

Control your server from anywhere with our advanced web interface:

• 🖥️ Remote Access - Manage punishments from anywhere
• 📊 Real-time Statistics - Live server and punishment data
• 🔍 Advanced Search - Find players and punishments instantly
• 📋 Punishment History - Complete audit trail
• 📱 Mobile Responsive - Works on all devices

🔗 Live (Real) Demo: web.crystalfury.it/epicbans

Beautiful Interface

EpicBans uses MiniMessage for stunning visual effects:

# Beautiful gradient messages
Prefix: "<gradient:#FFEA00:#FFB800><bold>EpicBans</bold></gradient> <dark_gray>»</dark_gray><white> "

# Rich ban messages with gradients
Ban_Message: |-
  <gradient:#ff0000:#ff8800>You have been banned</gradient>

  <gray>Banned by:</gray> <gradient:#00ffff:#0099ff>%banner%</gradient>
  <gray>Reason:</gray> <gradient:#ff00ff:#ff99ff>%reason%</gradient>
  <gray>Type:</gray> <gradient:#ff4444:#990000>Permanent</gradient>

🔧 Advanced Configuration

🌍 Internationalization

• Full English and Italian language support
• Easy translation system

⏰ Time & Date Management

• Custom timezone support
• Flexible date formatting
• Automatic expiration handling

🛡️ Security Features

• Permission-based command access
• Immune system for protected players
• IP-based punishments
• Silent punishment mode
• Audit logging

📊 Import & Export

Migrate easily from other plugins:

• MaxBans Import - Seamless data migration
• Vanilla Import - Import from vanilla ban lists

📱 Screenshots

Example Ban

Discord Integration

Admin Panel

⚙️ Installation

📋 Requirements

• 🖥️ Java 9+
• 🗄️ Minecraft 1.7+ server

🔧 Quick Setup

1. 📥 Download EpicBans.jar
2. 📁 Place in your /plugins folder
3. ⚡ Start your server (auto-generates config files)
4. ⚙️ Configure config.yml with your preferences
5. 🌐 Customize messages.yml
6. 🔄 Restart and enjoy full protection!

🌐 Network Setup

For BungeeCord/Velocity networks:

1. 🌉 Install EpicBans on your proxy server (BungeeCord/Velocity)
2. ⚙️ Configure config.yml with your preferences
3. 🌐 Customize messages.yml
4. ✅ Restart proxy - Network ready!

🤝 Support & Community

📞 Get Help

• 💬 Discord Support - Join our community server: discord.com/invite/PNz7N6rmAK
• 📚 Documentation - Comprehensive guides and tutorials
• 📱 Telegram - Quick support via t.me/Nxtor2

🚀 Development Builds

• 🔄 Early Access - Test upcoming features before release
• 👑 Buyer Role - Exclusive access to development builds
• 🆕 Latest Features - Be the first to try new functionality
• 📋 Feedback - Help shape the future of EpicBans

Join our Discord and contact Nxtor2 to get the Buyer role and access to development builds!

🌟 TODO LIST

• 🌍 More Languages - French, German, Spanish
• 🔗 GUI Interface - Admin controls through interactive menus

🎮 Developer

• Author: Nxtor2
• Experience: 8+ years Minecraft development

• Specialty: High-performance server plugins

• Contact: Telegram

📖 User Guide

📥 Importing from Other Plugins

Already using another punishment plugin? No problem! EpicBans supports importing data from:

🔄 Supported Import Sources

• Vanilla Minecraft - Import default server bans and IP bans
• MaxBans - Import bans and IP bans from MaxBans plugin

📋 Import Steps

1. Run the import command:

   /epicbans import Vanilla    # For Vanilla Minecraft
   /epicbans import MaxBans    # For MaxBans plugin
   

2. Wait a few seconds for the import process to complete
3. Done! All your existing punishments are now in EpicBans

📅 Coming Soon: Support for more plugins is in development!

🌍 Language Configuration

EpicBans supports multiple languages out of the box:

🗣️ Available Languages

• 🇺🇸 English (EN)
• 🇮🇹 Italian (IT)

⚙️ How to Change Language

1. Open your config.yml file
2. Find the Lang: section
3. Set the value to your preferred language:

   Lang: "EN"  # For English
   Lang: "IT"  # For Italian
   

4. Restart your server or reload the plugin

💾 Database Configuration

🐬 Setting Up MySQL

To enable MySQL support:

1. Open your config.yml file
2. Find the MySQL: section
3. Configure your database connection:

   MySQL:
     Enabled: true
     Host: "localhost"
     Port: 3306
     Database: "epicbans"
     Username: "your_username"
     Password: "your_password"
   

4. Restart your server

🔄 Database Conversion

EpicBans allows seamless conversion between any database types:

Steps to Convert:

1. Configure your target database in config.yml (enable the new database you want to switch to)
2. Reload the server to load the new database configuration
3. Run the conversion command:

   /epicbans convert mysql        # Convert current database to MySQL
   /epicbans convert sqlite       # Convert current database to SQLite
   /epicbans convert h2           # Convert current database to H2
   /epicbans convert postgresql   # Convert current database to PostgreSQL
   /epicbans convert mariadb      # Convert current database to MariaDB
   

4. Wait for the conversion to complete
5. Update your config.yml to use the new database as primary
6. Done! Your data is now in the new database format

🛠️ Common Issues & Solutions

🛡️ Staff Protection

Problem: Need to prevent yourself from being banned

Solution: Use the immunity system:

/immune <yourname>

This makes you immune to all punishments.

🤖 Discord Bot Setup

Transform your moderation with Discord integration!

📋 Requirements

• JDA plugin installed on your server
• Discord Developer Application

🔧 Step-by-Step Setup

1. Install JDA Plugin on your server

2. Create Discord Application:

   • Go to Discord Developer Applications
   • Click "New Application"
   • Choose a name for your bot

3. Get Bot Token:

   • Go to "Bot" section
   • Click "Add Bot" → confirm
   • Copy the bot token
   • Put it in your discord.yml file

4. Get Client ID:

   • Go to "General Information"
   • Copy the "Client ID"

5. Invite Bot to Server:

   • Visit: https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=10240
   • Replace YOUR_CLIENT_ID with your actual Client ID
   • Select your server and authorize

6. Configure Channels:

   • Create a channel for notifications
   • Enable Developer Mode in Discord (Settings → Appearance)
   • Right-click the channel → "Copy ID"
   • Put the ID in ChannelId or StaffChannelId in discord.yml

7. Enable Discord Support:

   DiscordSupport: true
   

8. Restart your server - Discord integration is now active!

📺 Video Tutorial: Watch the setup guide

🎨 Message Formatting Guide

⚠️ Important: MiniMessage vs Legacy Codes

Do NOT mix MiniMessage formatting with legacy color codes in the same message!

Examples:

# ❌ Wrong (mixed formatting)
message: "<red>&lHello World"

# ✅ Correct (only MiniMessage)
message: "<red><bold>Hello World"

# ✅ Correct (only legacy codes)  
message: "&c&lHello World"

🌈 MiniMessage Examples

# Gradients
message: "<gradient:#ff0000:#0099ff>Beautiful gradient text</gradient>"

# Bold and colors
message: "<red><bold>Important Warning</bold></red>"

# Multiple effects
message: "<yellow><italic><underlined>Stylish text</underlined></italic></yellow>"

🎨 Legacy Color Examples

# Basic colors
message: "&cRed text &aGreen text &bBlue text"

# Formatting
message: "&l&cBold Red &r&oItalic normal"

🔧 Compatibility

💬 Questions?

Join our Discord server for instant support!