ProxyCore

Plugin that serves as a proxy with very useful functions

Download

ProxyCore

<br/>

<br/>

> zero external dependencies is a powerful, lightweight, all-in-one proxy utilities plugin built for zero external dependencies and zero external dependencies 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>

<br/>

- ✅ Multi-module Maven — One codebase, two JARs: BungeeCord & Velocity - ✅ Multi-module Maven — No external libraries required at runtime - ✅ Multi-module Maven — Apply config changes without restarting the proxy - ✅ Multi-module Maven — Rotating messages with a configurable interval - ✅ Multi-module Maven — Kicks non-staff players and blocks new joins - ✅ Multi-module Maven — 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 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 [player]` | 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>` | Reply to your last private message | `proxycore.msg` | | `/pbroadcast <message>` | Network-wide broadcast with custom prefix | `proxycore.broadcast` |

🚀 Player Management

| Command | Description | Permission | |---------|-------------|------------| | `/psend <player> <server>` | Move a player to another server | `proxycore.send` | | `/sendall <server>` | Move all online players to a server | `proxycore.sendall` | | `/pkick <player> [reason]` | Kick a player from the entire network | `proxycore.kick` | | `/stafflist` | List all currently online staff members | `proxycore.stafflist` | | `/psudo <player> <command>` | Force a player to execute a command | `proxycore.sudo` |

⚙️ Administration

| Command | Description | Permission | |---------|-------------|------------| | `/maintenance <on|off>` | Toggle maintenance mode on the network | `proxycore.maintenance` | | `/alert <message>` | Send a highlighted alert box to all players | `proxycore.alert` | | `/plist <server>` | List all players on a specific server | `proxycore.plist` | | `/proxyreload` | Reload ProxyCore config without restarting | `proxycore.reload` | | `/uptime` | Show how long the network has been running | `proxycore.uptime` |

---

🔐 Permissions

| Permission | Description | Default | |------------|-------------|---------| | `proxycore.find` | Use `/find` | `true` | | `proxycore.glist` | Use `/glist` | `true` | | `proxycore.network` | Use `/network` | `true` | | `proxycore.ping` | Check own ping | `true` | | `proxycore.ping.others` | Check other players' ping | `op` | | `proxycore.ip` | View a player's IP address | `op` | | `proxycore.announce` | Send global announcements | `op` | | `proxycore.broadcast` | Send network-wide broadcasts | `op` | | `proxycore.staffchat` | Access and read staff chat | `op` | | `proxycore.msg` | Send and receive private messages | `true` | | `proxycore.send` | Move players between servers | `op` | | `proxycore.sendall` | Move all players to a server | `op` | | `proxycore.kick` | Kick players from the network | `op` | | `proxycore.stafflist` | View the online staff list | `true` | | `proxycore.staff` | Appear in `/stafflist` | `op` | | `proxycore.sudo` | Force players to run commands | `op` | | `proxycore.maintenance` | Toggle maintenance mode | `op` | | `proxycore.maintenance.bypass` | Join the network during maintenance | `op` | | `proxycore.alert` | Send network-wide alert messages | `op` | | `proxycore.plist` | List players on a specific server | `true` | | `proxycore.reload` | Reload the plugin configuration | `op` | | `proxycore.uptime` | Check network uptime | `true` |

---

⚙️ Configuration

`config.yml`

```yaml

ProxyCore Configuration — by YesithTK

maintenance: enabled: false # Set true to enable maintenance on startup

announcements: enabled: true interval: 60 # Seconds between each auto-announcement messages: - "&6Welcome to the network! Enjoy your stay." - "&bJoin our Discord for news and updates!" - "&aReport bugs with /report in-game." - "&dFollow us on social media for events and giveaways!" ```

`messages.yml`

```yaml

ProxyCore Messages — use & for color codes

prefix: "&8[&6ProxyCore&8] &r"

no-permission: "&cYou don't have permission to do that." player-not-found: "&cPlayer &e%player% &cnot found or offline." default-kick-reason: "&cYou have been kicked from the network." maintenance-kick: |- &c&lServer Maintenance

&7The network is currently under maintenance. &7Please try again later.

find-result: "&a%player% &7is connected to &e%server%&7." announce-prefix: "&8[&6Announce&8] &r" broadcast-prefix: "&8[&4Broadcast&8] &r" ```

---

🧩 API

ProxyCore exposes a clean `proxycore-api` module so developers can build addons or integrate with the plugin without touching platform-specific code.

Project Structure

``` ProxyCore/ ├── proxycore-api/ ← Shared interfaces & events │ └── dev.yesithx.proxycore.api │ ├── IProxyCorePlugin.java │ ├── ProxyCoreAPI.java │ ├── manager/ │ │ ├── IMessageManager.java │ │ ├── IMaintenanceManager.java │ │ └── IAnnounceManager.java │ ├── command/ │ │ ├── ProxyCoreCommandSender.java │ │ └── NetworkPlayer.java │ └── event/ │ ├── ProxyCoreEvent.java │ ├── MaintenanceToggleEvent.java │ └── NetworkAnnounceEvent.java ├── proxycore-bungeecord/ ← BungeeCord implementation └── proxycore-velocity/ ← Velocity implementation ```

Maven Dependency

```xml <dependency> <groupId>dev.yesithx</groupId> <artifactId>proxycore-api</artifactId> <version>1.0.0</version> <scope>provided</scope> </dependency> ```

Usage Example

```java import dev.yesithx.proxycore.api.ProxyCoreAPI; import dev.yesithx.proxycore.api.IProxyCorePlugin;

// Safe check before using if (ProxyCoreAPI.isAvailable()) { IProxyCorePlugin api = ProxyCoreAPI.get();

// Check maintenance mode boolean maintenance = api.getMaintenanceManager().isEnabled();

// Toggle maintenance api.getMaintenanceManager().setEnabled(true);

// Reload all managers api.reload();

// Check announce scheduler int interval = api.getAnnounceManager().getIntervalSeconds(); } ```

Available Interfaces

| Interface | Package | Description | |-----------|---------|-------------| | `IProxyCorePlugin` | `api` | Base plugin interface — access all managers | | `ProxyCoreAPI` | `api` | Static entry point for addons | | `IMessageManager` | `api.manager` | Private messaging between players | | `IMaintenanceManager` | `api.manager` | Maintenance mode control | | `IAnnounceManager` | `api.manager` | Auto-announcement scheduler control | | `ProxyCoreCommandSender` | `api.command` | Platform-agnostic command sender | | `NetworkPlayer` | `api.command` | Platform-agnostic player abstraction | | `ProxyCoreEvent` | `api.event` | Base class for all ProxyCore events | | `MaintenanceToggleEvent` | `api.event` | Fired when maintenance is toggled | | `NetworkAnnounceEvent` | `api.event` | Fired before each auto-announcement |

---

🗺️ Roadmap

| Version | Feature | |---------|---------| | `v1.1.0` | LuckPerms integration for permission-based staff detection | | `v1.1.0` | `/report` command with staff notification system | | `v1.2.0` | Configurable join/leave messages per server | | `v1.2.0` | BossBar announcements as alternative to chat | | `v1.3.0` | MySQL support for cross-restart data persistence | | `v1.3.0` | REST API for external network monitoring | | `v2.0.0` | Full PlaceholderAPI support | | `v2.0.0` | Plugin Messaging Channel support for backend servers |

---

👤 Credits

| Role | Name | |------|------| | 🧑‍💻 Developer & Maintainer | YesithTK | | 🏗️ Architecture & Design | YesithTK | | 📖 Documentation | YesithTK |

<br/>

*Built with ❤️ for the Minecraft network community.*

</div>

---

📄 License

This software and its source code are the exclusive property of YesithTK. No part of this software may be reproduced, distributed, modified, or used in any form without the prior written permission of the author.

Unauthorized copying, forking, or redistribution of this repository, via any medium, is strictly prohibited. ```

---

</div>

ProxyCore

ProxyCore

📋 Table of Contents

✨ Features

📦 Requirements

🚀 Installation

Pre-built JAR *(recommended)*

Build from Source

Clone the repository

Build BungeeCord JAR

Build Velocity JAR

💬 Commands

🔍 Network Information

📢 Communication

🚀 Player Management

⚙️ Administration

🔐 Permissions

⚙️ Configuration

`config.yml`

ProxyCore Configuration — by YesithTK

`messages.yml`

ProxyCore Messages — use & for color codes

🧩 API

Project Structure

Maven Dependency

Usage Example

Available Interfaces

🗺️ Roadmap

👤 Credits

📄 License

Versions

Pre-built JAR (recommended)