\n# The All-in-One Security System for your Velocity Proxy<\/p>\n
**ProxyFlow** is the ultimate security solution for Minecraft server networks based on Velocity. Version 1.4.0 introduces massive performance improvements through **Asynchronous Processing**, **Caching**, and **Database Support**.<\/p>\n
It proactively protects your network from bot attacks, VPN bypasses, and exploits while providing your team with essential tools like a global StaffChat and Discord integration.<\/p>\n
**Support & Community**
\nQuestions, bugs, or feature requests? Join our Discord:
\nhttps:\/\/discord.gg\/DK8ZuTCwEC<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Security System<\/p>\n
Protect your network before malicious connections even reach your backend servers.<\/p>\n
* **Intelligent VPN & Proxy Blocker:**
\n* Blocks connections via anonymous networks (VPNs\/Proxies).
\n* **NEW:** Uses an intelligent **Caching System** (stores results for X minutes) to save API limits and prevent join lag.
\n* Requires a free API key from proxycheck.io.<\/p>\n
* **Persistent Punishments (SQLite):**
\n* **NEW:** Temporary bans (e.g., triggered by Anti-Bot) are now stored in a local SQLite database (`database.db`). Bans remain active even after a proxy restart!<\/p>\n
* **Country Blocker (GeoIP):** Whitelist or Blacklist specific countries.
\n* **Anti-Bot & Anti-Exploit:**
\n* Detects inhumanly fast connection attempts.
\n* Blocks invalid usernames.
\n* Prevents packet exploits at the proxy level.<\/p>\n
* **Multi-Account Protection:** Limits the number of players allowed to join from the same IP address.<\/p>\n
### Discord Integration (NEW)<\/p>\n
Connect your proxy to Discord via Webhooks:<\/p>\n
* Notifications for **VPN\/Bot blocks** (includes IP and username).
\n* Notifications for **Maintenance Mode** status changes.
\n* Fully asynchronous \u2013 your server will never lag, even if Discord is slow to respond.<\/p>\n
### Global StaffChat (NEW)<\/p>\n
Communicate with your team across all servers:<\/p>\n
* Command: `\/sc ### Maintenance System<\/p>\n * **Custom MOTD:** Displays maintenance status directly in the server list (supports color codes). ### Queue System<\/p>\n * Redirects players to a queue server if the target server (Lobby) is full. —<\/p>\n ## Installation<\/p>\n 1. Download the `ProxyFlow-1.4.0+dependencies.jar`. —<\/p>\n ## Configuration (config.yml)<\/p>\n “`yaml whitelist: queue: security: country-block: multi-account: discord: staffchat: “`<\/p>\n —<\/p>\n ## Commands & Permissions<\/p>\n | Command | Permission | Description | ProxyFlow protects your Velocity proxy with a firewall against VPNs, bots, and multi-accounts. The plugin includes a configurable country-blocker and punishes repeated violations with automatic temp-bans. All features are configurable!<\/p>\n","protected":false},"featured_media":125885,"template":"","meta":{"_minecraft_slug":"proxyflow","_minecraft_project_id":"rRMS0zYW","_minecraft_author":"Yu_Dino","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":307,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"proxyflow.zip","_minecraft_size_bytes":14688116,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T11:40:48.459276Z","_minecraft_date_created":"2025-10-09T04:18:11.867740Z","_minecraft_date_modified":"2026-01-02T17:06:39.437106Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/proxyflow","_minecraft_icon_attachment_id":125885,"_minecraft_imported_at":"2026-06-07T09:33:44+00:00","_minecraft_import_hash":"40ac4a574b0b467b63f7bb9d5c299896","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,123,985],"mod_loader":[986],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-125884","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-technology","mod_category-velocity","mod_loader-velocity","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n* **Toggle Mode:** Use `\/sc` without arguments to automatically send all your chat messages to the staff chat.<\/p>\n
\n* **Auto-Kick:** Disconnects players without permission during maintenance.
\n* **Bypass:** Staff members with permission can still join.<\/p>\n
\n* Priority support for VIPs\/Staff.<\/p>\n
\n2. Place the file into the `plugins` folder of your Velocity Proxy.
\n3. **Important:** Ensure **Java 21** is installed.
\n4. Restart the proxy.
\n5. Add your API key to `config.yml` and configure the Discord Webhooks.<\/p>\n
\nmaintenance:
\n enabled: false
\n motd: ” &4&lServer is in maintenance!n &lPlease try again later”
\n kick-message: “&cThis server is currently in maintenance”
\n bypass-permission: “proxyflow.maintenance.bypass”<\/p>\n
\n enabled: false
\n kick-message: “&cYou are not whitelisted on this server!”
\n players:
\n – “Notch”
\n – “Dinnerbone”
\n bypass-permission: “proxyflow.whitelist.bypass”<\/p>\n
\n enabled: false
\n max-players: 100
\n queue-server: “queue”
\n target-server: “lobby”
\n queue-message: “&eYou are in queue… Position: &6{position}&e\/&6{total}”
\n bypass-permission: “proxyflow.queue.bypass”
\n priority-permissions:
\n “proxyflow.queue.priority.high”: 100
\n “proxyflow.queue.priority.medium”: 50
\n “proxyflow.queue.priority.low”: 10<\/p>\n
\n vpn-check:
\n enabled: true
\n api-key: “YOUR_API_KEY_HERE”
\n # How long (in minutes) to cache an IP as “safe”? (Saves API requests)
\n cache-duration-minutes: 60
\n bypass-permission: “proxyflow.security.vpn.bypass”
\n whitelisted-players: []
\n block-server-ips: true
\n notify-admins: true<\/p>\n
\n enabled: false
\n mode: “blacklist”
\n countries:
\n – “US”
\n – “CN”<\/p>\n
\n enabled: true
\n bypass-permission: “proxyflow.security.multiaccount.bypass”
\n action: “kick”
\n kick-message: “&cA player with your IP address is already on this server”
\n whitelisted-players: []<\/p>\n
\n enabled: false
\n webhook-url: “https:\/\/discord.com\/api\/webhooks\/…”
\n notify-vpn-block: true
\n notify-maintenance: true<\/p>\n
\n enabled: true
\n format: “&8[&cSC&8] &e{player}&8: &f{message}”<\/p>\n
\n| — | — | — |
\n| `\/proxyflow reload` | `proxyflow.command.reload` | Reloads the configuration. |
\n| `\/maintenance` | `proxyflow.command.maintenance` | Toggles maintenance mode on\/off. |
\n| `\/staffchat` | `proxyflow.staffchat` | Sends a message or toggles staff chat. |
\n| `\/whitelist
\n| `\/security
\n| **Bypass Permissions** | | |
\n| (See Config) | `proxyflow.maintenance.bypass` | Join during maintenance. |
\n| (See Config) | `proxyflow.security.vpn.bypass` | Join using a VPN. |
\n| **Admin Notify** | `proxyflow.notify` | Receive ingame alerts when blocks occur. |<\/p>\n","protected":false},"excerpt":{"rendered":"