ProxyFlow-Folia

# ProxyFlow - Folia Advanced Security for Folia ProxyFlow is an all-in-one solution for server protection and management, built specifically for the high-performance Folia server software. Whether you need to perform maintenance or protect your community from malicious actors, ProxyFlow provides the essential tools, fully optimized for Folia's modern, multi-threaded environment. **Requirements** Server Software: This plugin requires Folia. It will NOT work on standard Spigot or Paper servers. API Key: A free API key from proxycheck.io is required for the VPN/Proxy check feature to work. **Core Features** Easy Maintenance Mode Toggle the server's maintenance status with a single command (/maintenance). Display a custom, animated MOTD in the server list when maintenance is active. Automatically kick players who do not have bypass permission with a configurable message. Grant access to staff and specific players with the proxyflow.maintenance.bypass permission. Advanced Connection Security VPN & Proxy Blocking: Integrates with the free proxycheck.io API to detect and block players using anonymous networks. Country Blocking: Set up a blacklist to block specific countries or a whitelist to only allow certain countries. Built-in Anti-Bot: A simple but effective connection rate-limiter mitigates basic bot attacks. Multi-Account Prevention: Prevents multiple users from joining from the same IP address. Automatic Temp-Ban: IPs that repeatedly trigger security flags are automatically and temporarily banned. **Optimized for Folia** Built from the ground up to integrate seamlessly with Folia's multi-threaded architecture. Connection checks are performed asynchronously to ensure zero impact on your server's main threads and tick rate. Fully configurable to let you decide what runs on your server. **Commands & Permissions** Commands: /maintenance - Toggles maintenance mode on or off. /proxyflow reload - Reloads the configuration file from disk. Permissions: proxyflow.command.maintenance - Allows use of the /maintenance command. proxyflow.command.reload - Allows use of the /proxyflow reload command. proxyflow.maintenance.bypass - Allows a player to join when the server is in maintenance mode. proxyflow.security.vpn.bypass - Allows a player to join even if their IP is flagged as a VPN/proxy. **Configuration** The configuration is designed to be simple and straightforward. Here's a look at the default config.yml: ``` maintenance: enabled: false motd: " &4&lMaintenance Mode\n &lPlease try again later." kick-message: "&cThe server is currently in maintenance mode." bypass-permission: "proxyflow.maintenance.bypass" security: vpn-check: enabled: true # Get a free API key from https://proxycheck.io api-key: "YOUR_API_KEY_HERE" bypass-permission: "proxyflow.security.vpn.bypass" country-block: enabled: false mode: "blacklist" # Can be "blacklist" or "whitelist" countries: - "US" - "CN" - "RU" ``` Have questions or need support? Let me know!