PrimeX ProxyManage Bans, Warns, and Player Profiles Entirely Through Discord.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OverviewPrimeX Proxy is a powerful, production-ready Velocity proxy plugin designed for serious Minecraft networks. It replaces a stack of separate plugins by bundling everything your network needs: intelligent server failover, a full ban system, an embedded Discord bot (JDA 5), an account-linking security layer (PrimeLink), a player report system, a warn system, and deep admin tooling — all backed by a persistent database with fully configurable Discord embeds.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Feature Breakdown
Smart Failover System- Automatic crash detection — detects when a backend server crashes or goes offline.
- Instant player transfer — redirects players to the next available server automatically.
- Configurable priority chain — define the exact fallback order in config.
- Ban-aware redirect — failover avoids sending players to servers where they are banned.
- Separate ban-redirect chain — configure a distinct priority list for banned redirects.
- Proxy MOTD player count — dynamically updates MOTD player count (including Bedrock via Geyser).
Proxy Ban System- Per-server bans — ban a player on a specific backend server.
- Global bans (all) — ban a player network-wide simultaneously.
- Temporary bans — full tempban support (1d, 12h, 30m).
- Automatic expiry sweep — expired bans are automatically cleaned up every 5 minutes.
- IP Banning — ban entire IP addresses with login enforcement.
- IP masking — optionally mask IPs in Discord logs (1.2.xxx.xxx) for privacy.
- Alt account detection — player profiles show all known alt accounts sharing the same IP.
Discord Bot Integration (JDA 5)- Fully embedded Discord bot — runs directly inside the plugin; no external bot service needed.
- Per-command role access — lock any slash command to specific Discord roles via config.
- Live network status embed — continuously updating embed showing player lists, totals, and recent bans.
- Smart embed management — auto-refreshes every 30s without spamming new messages.
- Force resend button — staff can force a fresh embed via an interactive Discord button.
- Custom emojis — configure named Discord emojis for embed branding.
Discord Slash Commands- /pban & /ptempban & /punban — Manage player bans globally or per-server.
- /pipban & /pipunban — Manage IP bans.
- /playerinfo — Full profile with interactive Ban / IP Ban buttons right in Discord.
- /ipinfo — Show all players who have joined using a specific IP.
- /pwarns — View warn count and ban threshold status.
- /dbbackup — Export and upload the database file directly to Discord.
- /link & /unlink & /linkedaccounts — Public account linking management.
PrimeLink — Account Linking & Security- Secure 6-digit codes — generated using SecureRandom with 5-minute expiry.
- Automatic role assignment — assigns a "Linked" Discord role upon success.
- IP change alert (Player DM) — linked players receive an instant Discord DM if their account logs in from a new IP.
- Admin IP whitelist — register an allowed IP per admin. Any unauthorized login is instantly blocked with a Discord emergency alert.
- Mandatory linking toggle — optionally require players to link their account before playing.
Player Reports & Warns- In-game /report — players can report rule-breakers directly to a Discord log channel.
- Auto-escalation system — automatically sends an escalation notice with an "Approve Ban" button to Discord when a player gets too many reports.
- Auto-ban on max warns — players are automatically banned when they reach the configurable warn limit.
Player Profile System- In-game /pinfo — full profile including UUID, IP (permission-gated), link status, warns, and risk classification.
- Global player count — pings all backend servers and sums player counts every 10 seconds.
- Login history — every player login is recorded to the database for full audit trails.
Database & Configuration- Multi-database support — toggle between MySQL, SQLite, or H2 in the config.
- HikariCP pooling — production-grade database connection pool.
- Auto table creation — all tables created automatically on first start.
- SQL injection safe — uses parameterized prepared statements exclusively.
- Zero hardcoded values — every message, channel ID, color, and threshold is configurable.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requirements- Platform: Velocity 3.x (3.3.0 or higher)
- Java: Java 17+
- Database: MySQL 8+, SQLite, or H2
What's Included- primex_proxy.jar — fully shaded fat JAR; zero external dependencies.
- config.yml — auto-generated on first start with all options pre-documented.
