What is MAF?

MAF is a powerful, enterprise-grade firewall plugin designed specifically for Minecraft servers. It provides comprehensive network security through geographical filtering, VPN detection, and intelligent world routing systems. Built with performance and flexibility in mind, MAF protects your server while maintaining a seamless experience for legitimate players.

Key Features

Geographical Access Control

Take complete control over who can access your server based on their location. MAF supports flexible configuration modes:

Whitelist Mode
Allow only players from specific countries or regions. Perfect for regional servers, language-specific communities, or compliance requirements.

Blacklist Mode
Block specific countries while allowing all others. Ideal for preventing access from regions with high abuse rates while keeping your doors open to the world.

Example Configuration:
Allow only North American players:
Advanced VPN & Proxy Detection

Protect your server from anonymous connections with multi-layer detection:

• VPN Detection: Identifies commercial VPN services
• Proxy Detection: Catches web proxies and SOCKS proxies
• Tor Network Detection: Blocks Tor exit nodes
• Datacenter Detection: Identifies hosting provider IPs

Each detection layer can be individually enabled or disabled, giving you precise control over your security policy. The system uses intelligent caching to maintain performance while providing real-time protection.

Intelligent World Routing

Create unique experiences for players from different regions with automatic world routing:

Spawn Routing
Players automatically spawn in region-specific worlds:

• US players → American Hub
• EU players → European Hub
• Asia players → Asian Hub

World Access Control
Restrict which worlds players can access based on their location:

• Premium worlds for specific regions
• Language-specific areas
• Event worlds by timezone

Comprehensive Statistics

Monitor your server security with detailed statistics:

• Total connection attempts
• Allowed vs blocked ratio
• Breakdown by block reason
• Geographic distribution
• Trend analysis over time

Statistics persist across server restarts and are accessible via in-game commands.

Multi-Language Support

MAF speaks your language with complete translations:

• English - Default
• Portuguese (Brazil) - Português Brasileiro
• Spanish - Español
• Italian - Italiano
• Russian - Русский
• Chinese - 中文

All messages including kick screens, commands, and notifications are fully translated. Switch languages instantly with a single configuration change.

Why Choose MAF?

Security Without Compromise

MAF provides enterprise-level security without sacrificing performance. Asynchronous processing ensures connection validation never blocks your server, while intelligent caching minimizes external API calls.

Flexible Configuration

Every aspect of MAF is configurable. From choosing which detection methods to enable, to customizing kick messages in multiple languages, you have complete control over how the plugin operates.

Easy to Use

Despite its powerful features, MAF is incredibly easy to set up and manage. Intuitive configuration files, comprehensive documentation, and user-friendly commands make administration a breeze.

Performance Optimized

Built with performance as a top priority:

• Asynchronous connection validation
• Intelligent caching system
• Minimal memory footprint
• No server lag or delays
• Optimized for high player counts

Real-World Applications

Regional Servers

Create region-specific servers for optimal player experience:
Players enjoy lower latency and language-appropriate communities.

Competitive Servers

Prevent cheating and multi-accounting on competitive servers:

• Block VPN/proxy to prevent ban evasion
• Identify suspicious connection patterns
• Maintain fair play environment

Hub Networks

Route players to appropriate sub-servers:

• Language-specific hubs by region
• Timezone-appropriate event servers
• Regional mini-game lobbies

Compliance & Legal

Meet legal and compliance requirements:

• GDPR-compliant EU-only access
• Age verification by region
• Content restrictions by jurisdiction

Command Overview

MAF provides powerful yet simple commands for server management:

/maf help
Display comprehensive help menu with all available commands and their descriptions.

/maf reload
Instantly reload all configurations without server restart. Apply changes to firewall rules, world routing, and language settings on the fly.

/maf stats
View detailed connection statistics including total connections, blocked attempts, and breakdown by reason. Perfect for monitoring server security.

/maf whitelist
Manage IP whitelist with add, remove, and list operations. Whitelisted IPs bypass all security checks.

All commands include tab completion and intelligent validation for ease of use.

Configuration Philosophy

MAF follows a "secure by default, flexible by design" philosophy:

Default State: Open Access
Out of the box, MAF allows all connections. This ensures your server remains accessible while you configure your specific requirements.

Granular Control
Every security feature can be individually enabled or disabled. You're never forced to use features you don't need.

Clear Documentation
Configuration files include comprehensive comments explaining each option. No guesswork required.

Validation & Feedback
Invalid configurations are caught and reported clearly. The plugin won't start with broken settings, preventing security misconfigurations.

Technical Excellence

Modern Architecture

MAF is built using modern Java design patterns:

• Modular component architecture
• Dependency injection for testability
• Builder patterns for complex objects
• Singleton pattern for managers
• Observer pattern for events

Performance Engineering

Every aspect is optimized for performance:

• Concurrent data structures for thread safety
• Lazy loading of resources
• Efficient caching algorithms
• Minimal object allocation
• Optimized database queries

Security Best Practices

Built with security in mind:

• Input validation on all user data
• Safe defaults for all settings
• No SQL injection vulnerabilities
• Secure API communication
• Permission-based access control

Compatibility & Requirements

Minecraft Versions:

• 1.17.x
• 1.18.x
• 1.19.x
• 1.20.x
• 1.21.x

Server Software:

• Spigot
• Paper (Recommended)
• Purpur
• Any Spigot-based fork

Java Requirements:

• Java 8+ (Minimum)
• Java 17+ (Recommended)

Getting Started

Setting up MAF is quick and easy:

Step 1: Install
Step 2: Configure
Step 3: Test
Step 4: Customize
Support & Updates

MAF is actively maintained and regularly updated:

• Bug Fixes: Rapid response to reported issues
• Feature Updates: New capabilities based on user feedback
• Compatibility: Support for new Minecraft versions
• Performance: Continuous optimization
• Security: Regular security audits and updates

Use Cases Summary

Perfect for:

• Regional servers requiring geographical restrictions
• Competitive servers needing VPN protection
• Hub networks with intelligent routing
• Servers with compliance requirements
• Communities preferring specific languages
• Networks preventing ban evasion
• Servers reducing spam and abuse

What Makes MAF Different?

Comprehensive Solution
Unlike simple geo-blocking plugins, MAF offers a complete security and routing solution in one package.

Production Ready
Thoroughly tested, optimized, and ready for servers of any size. No beta features or experimental code in production.

Professional Quality
Clean code, comprehensive documentation, and professional support. Built to enterprise standards.

Zero Dependencies
No external plugins required. MAF is completely self-contained and works out of the box.

Active Development
Regular updates, bug fixes, and new features. MAF evolves with your needs.

Configuration Examples

Example 1: European Gaming Community
Example 2: Competitive PvP Server
Example 3: Multi-Regional Network
Example 4: Educational Server
Performance Metrics

MAF is designed for high performance:

Connection Validation:
Less than 5ms average response time (cached)
Less than 100ms with API lookup

Memory Usage:
Minimal footprint: 10-20MB typical
Scales efficiently with player count

CPU Impact:
Near zero impact on main server thread
All intensive operations run asynchronously

Database Operations:
Efficient caching reduces external calls
Statistics saved periodically, not per-event

Security Features Summary

• Real-time geolocation validation
• Multi-layer VPN detection
• Proxy server identification
• Tor network blocking
• Datacenter IP detection
• IP whitelist system
• Permission-based bypass
• Intelligent caching
• Rate limiting protection
• Automatic threat logging

Routing Features Summary

• Automatic spawn routing
• World access control
• Per-country world restrictions
• Seamless teleportation
• Default world fallback
• Real-time route updates
• No player disruption
• Configurable routing rules