ProxyCore 是一款强大、轻量级的全功能代理实用插件,专为 BungeeCord 和 Velocity 网络构建。
包含 20 个必备命令、自动公告、维护模式、私聊以及员工工具——所有这些都在一个拥有 零外部依赖 的插件中实现。
? 目录
✨ 特性
| ? 网络信息 |
? 通信 |
? 玩家管理 |
⚙️ 管理 |
| 查找玩家 |
全局公告 |
跨服务器传送玩家 |
维护模式 |
| 服务器列表 |
员工聊天 |
一键移动所有玩家 |
全网警报 |
| 网络统计 |
私聊消息 |
从代理踢出玩家 |
配置热重载 |
| 延迟检测器 |
回复系统 |
员工列表 |
运行时间显示 |
| IP 查询 |
带前缀广播 |
强制执行命令 (sudo) |
按服务器的玩家列表 |
- ✅ 双平台支持 — 同一代码库,两个 JAR 包:BungeeCord & Velocity
- ✅ 零依赖 — 运行时无需任何外部库
- ✅ 热重载 — 应用配置更改而无需重启代理
- ✅ 自动公告 — 可配置间隔的轮播消息
- ✅ 维护模式 — 踢出非员工玩家并阻止新连接
- ✅ 开发者 API — 提供干净的
proxycore-api 模块用于构建附加组件
- ✅ 多模块 Maven —
proxycore-api, proxycore-bungeecord, proxycore-velocity
? 要求
| 要求 |
版本 |
| Java |
17 或更高 |
| BungeeCord |
1.20+ |
| Velocity |
3.x |
| Maven |
3.8+ (用于从源代码构建) |
? 安装
预编译 JAR (推荐)
- 从 Releases 下载正确的 JAR 包:
ProxyCore-BungeeCord-1.0.0.jar → 适用于 BungeeCord
ProxyCore-Velocity-1.0.0.jar → 适用于 Velocity
- 将其放入代理的
plugins/ 文件夹中。
- 启动或重启代理。
- 编辑生成的
plugins/ProxyCore/config.yml 和 messages.yml。
- 运行
/proxyreload 以在不重启的情况下应用更改。
从源代码构建
# 克隆仓库
git clone https://github.com/YesithTK/ProxyCore.git
cd ProxyCore
# 构建 BungeeCord JAR
mvn clean package -pl proxycore-bungeecord -am
# 构建 Velocity JAR
mvn clean package -pl proxycore-velocity -am
输出 JAR 包:
proxycore-bungeecord/target/ProxyCore-BungeeCord-1.0.0.jar
proxycore-velocity/target/ProxyCore-Velocity-1.0.0.jar
? 命令
注意: Velocity 的命令名称带有 v 前缀 —— 例如 /glist → /vglist, /send → /vsend。
? 网络信息
| 命令 |
描述 |
权限 |
/find <player> |
显示玩家所在的服务器 |
proxycore.find |
/glist |
列出所有服务器及其在线人数 |
proxycore.glist |
/network |
显示全局网络统计信息 |
proxycore.network |
/pping [player] |
检测自己或其他玩家的延迟 |
proxycore.ping |
/pip <player> |
获取玩家的 IP 地址 (管理员) |
proxycore.ip |
? 通信
| 命令 |
描述 |
权限 |
/announce <message> |
广播全局公告 |
proxycore.announce |
/staffchat <message> |
发送仅对员工可见的消息 |
proxycore.staffchat |
/pmsg <player> <message> |
跨服务器发送私聊消息 |
proxycore.msg |
/reply <message> |
回复上一条私聊消息 |
proxycore.msg |
/pbroadcast <message> |
带自定义前缀的全网广播 |
proxycore.broadcast |
? 玩家管理
| 命令 |
描述 |
权限 |
/psend <player> <server> |
将玩家传送到其他服务器 |
proxycore.send |
/sendall <server> |
将所有在线玩家移动到某个服务器 |
proxycore.sendall |
/pkick <player> [reason] |
从整个网络中踢出玩家 |
proxycore.kick |
/stafflist |
列出当前所有在线的员工 |
proxycore.stafflist |
/psudo <player> <command> |
强制玩家执行命令 |
proxycore.sudo |
⚙️ 管理
| 指令 |
描述 |
权限 |
/maintenance <on|off> |
在网络中开启或关闭维护模式 |
proxycore.maintenance |
/alert <message> |
向所有玩家发送高亮警告框 |
proxycore.alert |
/plist <server> |
列出特定服务器上的所有玩家 |
proxycore.plist |
/proxyreload |
无需重启即可重载 ProxyCore 配置 |
proxycore.reload |
/uptime |
显示网络已运行的时长 |
proxycore.uptime |
? 权限
| 权限 |
描述 |
默认值 |
proxycore.find |
使用 /find |
true |
proxycore.glist |
使用 /glist |
true |
proxycore.network |
使用 /network |
true |
proxycore.ping |
查看自身延迟 |
true |
proxycore.ping.others |
查看其他玩家的延迟 |
op |
proxycore.ip |
查看玩家的 IP 地址 |
op |
proxycore.announce |
发送全局公告 |
op |
proxycore.broadcast |
发送全网络广播 |
op |
proxycore.staffchat |
访问和阅读员工聊天 |
op |
proxycore.msg |
发送和接收私聊消息 |
true |
proxycore.send |
在服务器间移动玩家 |
op |
proxycore.sendall |
将所有玩家移动到某台服务器 |
op |
proxycore.kick |
将玩家踢出网络 |
op |
proxycore.stafflist |
查看在线员工列表 |
true |
proxycore.staff |
出现在 /stafflist 中 |
op |
proxycore.sudo |
强制玩家执行命令 |
op |
proxycore.maintenance |
切换维护模式 |
op |
proxycore.maintenance.bypass |
在维护期间加入网络 |
op |
proxycore.alert |
发送全网络警报消息 |
op |
proxycore.plist |
列出特定服务器上的玩家 |
true |
proxycore.reload |
重载插件配置 |
op |
proxycore.uptime |
检查网络运行时长 |
true |
⚙️ 配置
config.yml
# ProxyCore 配置 — by YesithTK
maintenance:
enabled: false # 设置为 true 以在启动时启用维护模式
announcements:
enabled: true
interval: 60 # 每次自动公告之间的间隔秒数
messages:
- "&6欢迎来到网络!祝您玩得愉快。"
- "&b加入我们的 Discord 获取新闻和更新!"
- "&a在游戏中使用 /report 报告错误。"
- "&d关注我们的社交媒体以获取活动和抽奖信息!"
messages.yml
# ProxyCore 消息 — 使用 & 表示颜色代码
prefix: "&8[&6ProxyCore&8] &r"
no-permission: "&c您没有权限执行此操作。"
player-not-found: "&c玩家 &e%player% &c未找到或离线。"
default-kick-reason: "&c您已被踢出网络。"
maintenance-kick: |-
&c&l服务器维护中
&7网络当前正在进行维护。
&7请稍后再试。
find-result: "&a%player% &7连接到 &e%server%&7。"
announce-prefix: "&8[&6公告&8] &r"
broadcast-prefix: "&8[&4广播&8] &r"
? API
ProxyCore 提供了一个干净的 proxycore-api 模块,以便开发者可以构建附加组件或与插件集成,而无需触碰平台特定的代码。
项目结构
ProxyCore/
├── proxycore-api/ ← 共享接口与事件
│ └── 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 实现
└── proxycore-velocity/ ← Velocity 实现
Maven 依赖
<dependency>
<groupId>dev.yesithx</groupId>
<artifactId>proxycore-api</artifactId>
<version>1.0.0</version>
<scope>provided</scope>
</dependency>
使用示例
import dev.yesithx.proxycore.api.ProxyCoreAPI;
import dev.yesithx.proxycore.api.IProxyCorePlugin;
// 在使用前进行安全检查
if (ProxyCoreAPI.isAvailable()) {
IProxyCorePlugin api = ProxyCoreAPI.get();
// 检查维护模式
boolean maintenance = api.getMaintenanceManager().isEnabled();
// 切换维护模式
api.getMaintenanceManager().setEnabled(true);
// 重载所有管理器
api.reload();
// 检查公告调度器
int interval = api.getAnnounceManager().getIntervalSeconds();
}
可用接口
| 接口 |
包 |
描述 |
IProxyCorePlugin |
api |
基础插件接口 — 访问所有管理器 |
ProxyCoreAPI |
api |
附加组件的静态入口点 |
IMessageManager |
api.manager |
玩家间的私聊管理 |
IMaintenanceManager |
api.manager |
维护模式控制 |
IAnnounceManager |
api.manager |
自动公告调度器控制 |
ProxyCoreCommandSender |
api.command |
跨平台的命令发送者 |
NetworkPlayer |
api.command |
跨平台的玩家抽象 |
ProxyCoreEvent |
api.event |
所有 ProxyCore 事件的基础类 |
MaintenanceToggleEvent |
api.event |
当维护模式被切换时触发 |
NetworkAnnounceEvent |
api.event |
在每次自动公告前触发 |
?️ 路线图
| 版本 |
功能 |
v1.1.0 |
支持 LuckPerms,实现基于权限的管理员检测 |
v1.1.0 |
/report 命令及管理员通知系统 |
v1.2.0 |
每个服务器可配置的加入/离开消息 |
v1.2.0 |
BossBar 公告作为聊天框的替代方案 |
v1.3.0 |
MySQL 支持,实现跨重启数据持久化 |
v1.3.0 |
REST API,用于外部网络监控 |
v2.0.0 |
完整支持 PlaceholderAPI |
v2.0.0 |
支持后端服务器的插件消息通道 (Plugin Messaging Channel) |
? 致谢
| 角色 |
名称 |
| ?? 开发者与维护者 |
YesithTK |
| ?️ 架构与设计 |
YesithTK |
| ? 文档编写 |
YesithTK |
专为 Minecraft 网络社区打造 ❤️。
? 许可证
Copyright (c) 2026 YesithTK. All Rights Reserved.
本软件及其源代码均为 YesithTK 的独家财产。
未经作者事先书面许可,不得以任何形式复制、分发、修改或使用本软件的任何部分。
严禁通过任何媒介对本仓库进行未经授权地复制、分叉或重新分发。
© 2026 YesithTK — ProxyCore. All Rights Reserved.
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
| ? 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 |
- ✅ 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)
- Download the correct JAR from Releases:
ProxyCore-BungeeCord-1.0.0.jar → for BungeeCord
ProxyCore-Velocity-1.0.0.jar → for Velocity
- Drop it into your proxy's
plugins/ folder.
- Start or restart the proxy.
- Edit the generated
plugins/ProxyCore/config.yml and messages.yml.
- 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
| 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
# 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
| 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 |
Built with ❤️ for the Minecraft network community.
? 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧