ProxyCore

<div align="center"> <img src="proxycore-logo.svg" width="220"/> <br/><br/> <img src="https://capsule-render.vercel.app/api?type=waving&color=0:1a1a2e,50:16213e,100:0f3460&height=160&section=header&text=ProxyCore&fontSize=72&fontColor=e94560&animation=fadeIn&fontAlignY=42&desc=All-in-one%20Proxy%20Utilities%20Plugin&descAlignY=65&descColor=a8b2d8" width="100%"/> <br/> (https://img.shields.io/badge/version-1.0.0-e94560?style=for-the-badge&logo=github&logoColor=white)](https://github.com/YesithTK/ProxyCore) (https://img.shields.io/badge/platform-BungeeCord%20%7C%20Velocity-0f3460?style=for-the-badge&logo=minecraft&logoColor=white)](https://github.com/YesithTK/ProxyCore) (https://img.shields.io/badge/java-17+-e94560?style=for-the-badge&logo=openjdk&logoColor=white)](https://adoptium.net/) (https://img.shields.io/badge/build-Maven-0f3460?style=for-the-badge&logo=apachemaven&logoColor=white)](https://maven.apache.org/) (https://img.shields.io/badge/license-All%20Rights%20Reserved-16213e?style=for-the-badge&logo=gitbook&logoColor=white)](./LICENSE) (https://img.shields.io/badge/author-YesithTK-a8b2d8?style=for-the-badge&logoColor=white)](https://github.com/YesithTK) <br/> > **ProxyCore** is a powerful, lightweight, all-in-one proxy utilities plugin built for **BungeeCord** and **Velocity** networks. > 20 essential commands, automatic announcements, maintenance mode, private messaging, staff tools — all in a single plugin with **zero external dependencies**. <br/> </div> --- ## 📋 Table of Contents - (#-features) - (#-requirements) - (#-installation) - (#-commands) - (#-permissions) - (#-configuration) - (#-api) - (#-roadmap) - (#-credits) - (#-license) --- ## ✨ Features <div align="center"> | 🔍 Network Info | 📢 Communication | 🚀 Player Management | ⚙️ Administration | |:---:|:---:|:---:|:---:| | Find players | Global announcements | Send players across servers | Maintenance mode | | Server list | Staff chat | Move all players at once | Network-wide alerts | | Network stats | Private messages | Kick from proxy | Config hot-reload | | Ping checker | Reply system | Staff list | Uptime display | | IP lookup | Broadcast with prefix | Force commands (sudo) | Per-server player list | </div> <br/> - ✅ **Dual platform** — One codebase, two JARs: BungeeCord & Velocity - ✅ **Zero dependencies** — No external libraries required at runtime - ✅ **Hot reload** — Apply config changes without restarting the proxy - ✅ **Auto announcements** — Rotating messages with a configurable interval - ✅ **Maintenance mode** — Kicks non-staff players and blocks new joins - ✅ **Developer API** — Clean `proxycore-api` module for building addons - ✅ **Multi-module Maven** — `proxycore-api`, `proxycore-bungeecord`, `proxycore-velocity` --- ## 📦 Requirements | Requirement | Version | |-------------|---------| | Java | 17 or higher | | BungeeCord | 1.20+ | | Velocity | 3.x | | Maven | 3.8+ *(for building from source)* | --- ## 🚀 Installation ### Pre-built JAR *(recommended)* 1. Download the correct JAR from (https://github.com/YesithTK/ProxyCore/releases): - `ProxyCore-BungeeCord-1.0.0.jar` → for BungeeCord - `ProxyCore-Velocity-1.0.0.jar` → for Velocity 2. Drop it into your proxy's `plugins/` folder. 3. Start or restart the proxy. 4. Edit the generated `plugins/ProxyCore/config.yml` and `messages.yml`. 5. Run `/proxyreload` to apply changes without restarting. ### Build from Source ```bash # Clone the repository git clone https://github.com/YesithTK/ProxyCore.git cd ProxyCore # Build BungeeCord JAR mvn clean package -pl proxycore-bungeecord -am # Build Velocity JAR mvn clean package -pl proxycore-velocity -am ``` Output JARs: - `proxycore-bungeecord/target/ProxyCore-BungeeCord-1.0.0.jar` - `proxycore-velocity/target/ProxyCore-Velocity-1.0.0.jar` --- ## 💬 Commands > **Note:** Velocity command names are prefixed with `v` — e.g. `/glist` → `/vglist`, `/send` → `/vsend`. ### 🔍 Network Information | Command | Description | Permission | |---------|-------------|------------| | `/find <player>` | Show which server a player is on | `proxycore.find` | | `/glist` | List all servers with their player counts | `proxycore.glist` | | `/network` | Display global network stats | `proxycore.network` | | `/pping ` | Check your own or another player's ping | `proxycore.ping` | | `/pip <player>` | Retrieve a player's IP address *(admin)* | `proxycore.ip` | ### 📢 Communication | Command | Description | Permission | |---------|-------------|------------| | `/announce <message>` | Broadcast a global announcement | `proxycore.announce` | | `/staffchat <message>` | Send a message visible only to staff | `proxycore.staffchat` | | `/pmsg <player> <message>` | Send a private message across servers | `proxycore.msg` | | `/reply <message>` |