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!