WederVPN | NEXU STUDIOS

WederVPN is a modern and ultra-optimized security plugin built for Minecraft servers ( Paper, Folia, and Velocity). Designed from the ground up to protect your community against malicious users, bot attacks, alt accounts, and VPN or Proxy connections.

Unlike other solutions on the market, **WederVPN is 100% free**: no licenses, no mandatory API keys, and no hidden limitations.

Key Features

* Zero-Impact Asynchronous Performance: All network checks and inspections run fully asynchronously and in parallel, guaranteeing an untouched TPS even during mass player logins.
* Full IPv4 and IPv6 Support: Native next-generation IP address support across all commands and modules.
* IP Limiter Module (Multi-Account Control):
* Limits how many accounts can connect simultaneously from the same IP address.
* Features a **time-based reset system** (e.g. `30m`) that automatically resets counters to avoid unfair blocks on shared networks (families, schools, internet cafes).
* Multi-API System with Fallback: Native integration with over 20 free VPN/Proxy detection providers (IP-API, FreeIPAPI, ProxyCheck, IPQualityScore, IPHub, and more). If one API fails, the plugin automatically falls back to another.
* GeoLocation & Country Gatekeeper: Allows creating whitelists or blacklists for specific countries using ISO codes (e.g. `US`, `ES`, `MX`).
* ISP Filter & Bogon IP Blocker: Blocks connections coming from high-risk ISPs or non-routable private IP ranges.
* Detailed Real-Time In-Game Alerts: Staff notifications on player join displaying detailed connection info (Username, Client Brand, Version, IP, Country, City, and linked alt accounts).
* Passive Mode: Scans connections in the background without kicking players; ideal for auditing or pairing with other security systems.
* Database Support: Saves logs, cache, and alert preferences using MySQL, MongoDB, or SQLite.

Commands and Permissions

Command	Description	Permission
/wvpn	Displays the main help menu and plugin status.	wvpn.command
/wvpn lookup <player|ip>	Performs a real-time deep security analysis on an IP or player.	wvpn.command.lookup
/wvpn alerts	Toggles in-game security notifications on or off.	wvpn.command.alerts
/wvpn allowlist <add|remove|info|purge>	Manages the allowlist for IP addresses/players to bypass checks.	antivpn.command.allowlist
/wvpn clearcache	Clears the local cached API responses.	wvpn.command.clearcache
/wvpn reload	Reloads all configuration files and modules.	wvpn.command.reload

Modular Directory Structure

Upon initial startup, an organized directory structure is automatically generated for easy customization:
* /plugins/WederVPN/cache/ ➜ Local temporary response cache.
* /plugins/WederVPN/modules/ ➜ Settings for IP Limiter, ISP Filter, Bogon, etc.
* /plugins/WederVPN/services/ ➜ Independent API service configurations.
* /plugins/WederVPN/languages/ ➜ Customizable i18n translation files.