ProxyCore

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.

📋 Table of Contents

• Features
• Requirements
• Installation
• Commands
• Permissions
• Configuration
• API
• Roadmap
• Credits
• License

✨ Features

• ✅ 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

🚀 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

# 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

📢 Communication

🚀 Player Management

⚙️ Administration

🔐 Permissions

⚙️ Configuration

config.yml

# 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

# 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

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

Usage Example

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

🗺️ Roadmap

👤 Credits

📄 License

Copyright (c) 2026 YesithTK. All Rights Reserved.

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.

© 2026 YesithTK — ProxyCore. All Rights Reserved.