Minecraft 服务器的终极安全 REST API 与 WebSocket 编排层。
➤ CoreLink 是什么?
CoreLink 是一个先进的、生产级的 Minecraft 服务器控制层,专为 Paper API (1.21.1+) 设计。它充当您的 Minecraft 服务器基础设施与外部仪表板、Discord 机器人或管理面板之间的双向桥梁。CoreLink 提供极快且安全的 REST API 端点访问以及实时 WebSocket 通信。
停止通过笨拙的控制台面板或 SSH 来管理您的服务器——使用现代化的技术栈全面掌控您的社区。
➤ 快速链接(点击导航)
➤ 核心功能
- 实时 WebSocket 流传输:将实时的控制台输出、游戏内玩家聊天和关键性能指标直接即时地流式传输到您的外部客户端。
- 坚如磐石的安全性:以安全为先构建。您的端点受到 Nimbus JOSE + JWT 身份验证、IP 白名单、严格的速率限制以及核心暴力破解保护的防护。
- 高级管理套件:一套完整的自定义处罚系统(
/mute, /ban, /warn, /freeze, /kick),可异步地将操作永久记录到本地存储或 MongoDB 数据库中。
- 动态服务器工具:通过游戏内命令或 REST API 动态修改
/view-distance、/simulation-distance 和 /max-player。无需重启服务器!
- 服务器属性 (SRV) 管理器:随时随地安全地切换服务器维护模式、更新极端 PVP 状态并管理世界设置。
➤ 游戏内命令
我们构建了一套专用的命令套件,以便您实时管理服务器。点击下方展开列表。
点击查看所有游戏内命令
⚖️ 管理
/mute <player> <duration|perm> [reason] - 禁言玩家(例如 10m, 1h, perm)。
/unmute <player> - 恢复玩家的聊天权限。
/warn <player> [reason] - 发送正式警告。
/ban <player> [duration/perm] [reason] - 封禁玩家(默认为永久)。
/unban <player> - 解除玩家的封禁。
/kick <player> [reason] - 将玩家踢出服务器。
/freeze <player> - 冻结玩家位置。
/unfreeze <player> - 解冻玩家。
⚡ 工具与服务器属性
/view-distance <distance> - 更改世界视距。
/simulation-distance <distance> - 更改世界模拟距离。
/max-player <count> - 设置动态玩家上限。
/pvp <on/off> - 切换全服 PVP。
/pvp-world <world> <on/off> - 切换按世界的 PVP。
/maintenance <on/off> - 切换服务器维护模式。
/maintenance-whitelist <add/remove/list> <player> - 管理维护模式的访问权限。
/broadcast <message> - 发送跨服务器广播。
?️ CoreLink 管理员
/cl-info - 查看详细的插件和节点信息。
/cl-reload - 重新加载插件配置。
/cl-restart - 重启 CoreLink Netty 层。
/cl-connections - 查看活跃的 WebSocket/API 连接。
/cl-help - 显示高级帮助文档。
➤ REST API & WebSockets
CoreLink 不仅仅是一个插件——它是一个以开发者优先的网络层。点击下方查看主要端点。
点击查看主要 API 端点
1. 服务器操作 (基础路径: `/api/server`)
需要 api_server JWT 作用域或全局白名单
GET /health - 返回节点健康状态。
GET /info - 返回版本、运行时间、连接数和玩家数量。
POST /restart - 重启服务器。请求体(可选):{"delay": 10, "reason": "Updating"}
POST /stop - 优雅地停止服务器。
POST /kill - 强制终止 JVM。
POST /save-all - 保存世界和玩家数据。
POST /save-off - 禁用自动保存。
POST /save-on - 启用自动保存。
POST /pvp - 全局切换 PVP 模式。
POST /pvp-on / pvp-off - 全局启用/禁用 PVP。
POST /maintenance - 切换白名单/维护模式。
POST /maintenance-whitelist - 修改白名单。请求体:{"action": "add|remove", "player": "Name"}
POST /broadcast - 发送全服广播消息。
POST /weather - 设置服务器天气(晴天/下雨/雷暴)。
POST /difficulty - 设置世界难度。
POST /view-distance / /simulation-distance - 更新世界缩放属性。
POST /max-players - 更新动态玩家上限。
2. 管理操作 (基础路径: `/api/action`)
需要 api_action JWT 作用域或全局白名单
POST /ban - {"player": "...", "reason": "...", "duration": "1d|perm"}
POST /unban - {"player": "..."}
POST /kick - {"player": "...", "reason": "..."}
POST /mute / /unmute - 管理玩家聊天权限。
POST /gamemode - 更改玩家的游戏模式。
POST /tp - 将玩家传送至指定位置。
POST /freeze / /unfreeze - 管理玩家移动能力。
POST /warn - 发出官方玩家警告。
3. 控制台命令 (基础路径: `/api/console`)
需要 api_console JWT 作用域或全局白名单
POST /send - 执行一条命令。请求体:{"command": "time set day"}
4. 玩家信息 (基础路径: `/api/players`)
需要 api_players JWT 作用域或全局白名单
GET /list - 获取所有玩家列表(名称与 UUID)。
GET /online / /offline - 按连接状态筛选玩家。
GET /banned - 查看服务器封禁列表。
GET /whitelist-list - 查看白名单玩家。
GET /{uuid_or_name} - 返回详细的玩家档案(生命值、位置、游戏模式)。
GET /{uuid_or_name}/stats - 返回方块/物品交互统计数据。
GET /{uuid_or_name}/history - 返回会话加入/离开历史记录。
GET /{uuid_or_name}/inventory - 返回完整背包内容(盔甲箱、末影箱、Base64 编码格式)。
GET /{uuid_or_name}/location - 返回世界/坐标/生物群系数据。
GET /{uuid_or_name}/permissions - 返回当前生效的权限组。
GET /{uuid_or_name}/punishments - 返回历史封禁/静音/警告记录。
POST /{uuid_or_name}/message - 向该玩家发送私聊消息。
?️ WebSocket 频道
`ws://<ip>:<port>/console`
`ws://<ip>:<port>/chat`
- 全局双向通信桥接。
- 功能:玩家消息、加入/离开通知、死亡消息、成就提醒。
`ws://<ip>:<port>/stats`
- 私有服务器健康心跳监测。
- 功能:TPS & MSPT、内存使用情况、实体数量、玩家遥测数据。
➤ 支持的平台与要求
| 平台 / 工具 |
支持版本 |
| 服务器端 |
PaperMC 1.21 - 1.21.x |
| Java |
Java 21+ |
| 数据库 |
LocalDB 或 MongoDB(异步存储必需) |
⚠️ 注意: 本插件需要特定的配置以设置 JWT 密钥和 MongoDB 连接字符串。请在启动服务器前阅读文档!
The Ultimate Secure REST API and WebSocket Orchestration Layer for Minecraft Servers.
➤ What is CoreLink?
CoreLink is an advanced, production-grade Minecraft server control layer designed for Paper API (1.21.1+). It acts as a bidirectional bridge between your Minecraft server infrastructure and external dashboards, Discord bots, or management panels. CoreLink provides extremely fast and secure access to REST API endpoints and real-time WebSocket communication.
Stop managing your server through clunky console panels or SSH—take full control of your community with a modern tech stack.
➤ Quick Links (Click to Navigate)
➤ Core Features
- Real-Time WebSocket Streaming: Stream live console outputs, in-game player chat, and critical performance metrics directly to your external clients instantly.
- Ironclad Security: Built with security first. Your endpoints are protected by Nimbus JOSE + JWT authentication, IP whitelisting, strict rate limiting, and core brute-force protection.
- Advanced Moderation Suite: A full, custom-built punishment system (
/mute, /ban, /warn, /freeze, /kick) that permanently logs actions asynchronously to your Local storage or MongoDB database.
- Dynamic Server Utilities: Modify
/view-distance, /simulation-distance, and /max-player on the fly through in-game commands or the REST API. No server restarts required!
- Server Properties (SRV) Manager: Seamlessly toggle server maintenance modes, update extreme PVP states, and manage world settings from anywhere securely.
➤ In-Game Commands
We've built a suite of dedicated commands to manage your server in real-time. Click below to expand the list.
Click to View All In-Game Commands
⚖️ Moderation
/mute <player> <duration|perm> [reason] - Mute a player (e.g. 10m, 1h, perm).
/unmute <player> - Restore a player's chat.
/warn <player> [reason] - Send an official warning.
/ban <player> [duration/perm] [reason] - Ban a player (defaults to permanent).
/unban <player> - Remove a player's ban.
/kick <player> [reason] - Remove a player from the server.
/freeze <player> - Freeze a player in place.
/unfreeze <player> - Unfreeze a player.
⚡ Utility & Server Properties
/view-distance <distance> - Change world view distance.
/simulation-distance <distance> - Change world simulation distance.
/max-player <count> - Set the dynamic player limit.
/pvp <on/off> - Toggle server-wide PVP.
/pvp-world <world> <on/off> - Toggle per-world PVP.
/maintenance <on/off> - Toggle server maintenance mode.
/maintenance-whitelist <add/remove/list> <player> - Manage maintenance access.
/broadcast <message> - Send a cross-server broadcast.
?️ CoreLink Admin
/cl-info - View detailed plugin and node info.
/cl-reload - Reload plugin configurations.
/cl-restart - Restart the CoreLink Netty layer.
/cl-connections - View active WebSocket/API connections.
/cl-help - Display advanced help documentation.
➤ REST API & WebSockets
CoreLink is more than just a plugin—it's a developer-first networking layer. Click below to view major endpoints.
Click to View Major API Endpoints
1. SERVER ACTIONS (Base: `/api/server`)
Requires api_server JWT scope or global whitelist
GET /health - Returns node health status.
GET /info - Returns version, uptime, connections, and player counts.
POST /restart - Restarts the server. Body (Optional): {"delay": 10, "reason": "Updating"}
POST /stop - Stops the server gracefully.
POST /kill - Forcefully halts the JVM.
POST /save-all - Saves worlds and player data.
POST /save-off - Disables auto-save.
POST /save-on - Enables auto-save.
POST /pvp - Toggles PVP globally.
POST /pvp-on / pvp-off - Enables/Disables PVP globally.
POST /maintenance - Toggles whitelist/maintenance mode.
POST /maintenance-whitelist - Modifies whitelist. Body: {"action": "add|remove", "player": "Name"}
POST /broadcast - Send a server-wide broadcast message.
POST /weather - Sets server weather (clear/rain/thunder).
POST /difficulty - Sets world difficulty.
POST /view-distance / /simulation-distance - Update world scaling properties.
POST /max-players - Update the dynamic player limit.
2. MODERATION ACTIONS (Base: `/api/action`)
Requires api_action JWT scope or global whitelist
POST /ban - {"player": "...", "reason": "...", "duration": "1d|perm"}
POST /unban - {"player": "..."}
POST /kick - {"player": "...", "reason": "..."}
POST /mute / /unmute - Manage player chat access.
POST /gamemode - Change a player's gamemode.
POST /tp - Teleport a player to a destination.
POST /freeze / /unfreeze - Manage player movement.
POST /warn - Issue an official player warning.
3. CONSOLE COMMANDS (Base: `/api/console`)
Requires api_console JWT scope or global whitelist
POST /send - Dispatch a command. Body: {"command": "time set day"}
4. PLAYERS INFORMATION (Base: `/api/players`)
Requires api_players JWT scope or global whitelist
GET /list - Fetch all players (Name & UUID).
GET /online / /offline - Filter players by connection status.
GET /banned - View the server ban-list.
GET /whitelist-list - View whitelisted players.
GET /{uuid_or_name} - Returns detailed player profile (Health, Loc, GM).
GET /{uuid_or_name}/stats - Returns block/item interaction statistics.
GET /{uuid_or_name}/history - Returns session join/quit history.
GET /{uuid_or_name}/inventory - Returns full inventory (Armor, Enderchest, Base64).
GET /{uuid_or_name}/location - Returns world/coords/biome data.
GET /{uuid_or_name}/permissions - Returns active permission groups.
GET /{uuid_or_name}/punishments - Returns historical bans/mutes/warns.
POST /{uuid_or_name}/message - Sends a private message to the player.
?️ WebSocket Channels
`ws://<ip>:<port>/console`
- Raw log/console streaming in real-time.
- Multi-threaded log distribution.
`ws://<ip>:<port>/chat`
- Global bi-directional communication bridge.
- Features: Player messages, Join/Leave notices, Death messages, Advancement alerts.
`ws://<ip>:<port>/stats`
- Private server health heartbeats.
- Features: TPS & MSPT, Memory usage, Entity counts, Player telemetry.
➤ Supported Platforms & Requirements
| Platform / Tool |
Supported Versions |
| Server |
PaperMC 1.21 - 1.21.x |
| Java |
Java 21+ |
| Database |
LocalDB or MongoDB (Required for async storage) |
⚠️ NOTE: This plugin requires a specific setup to configure the JWT secrets and MongoDB connection string. Please read the documentation before starting your server!
评论 0
登录后参与评分
还没有评论,来抢沙发吧