? TeamPanel GamePanel - Minecraft (BungeeCord/Velocity) 集成
⚠️ 注意: 此插件目前处于 Beta 阶段。如有任何问题或反馈,请向我们的团队报告。
将您的 Minecraft 代理服务器(BungeeCord 或 Velocity)与 TeamPanel 无缝连接。此插件实现了深度集成,以实时跟踪服务器统计数据、同步玩家活动,并直接从 TeamPanel 仪表板执行远程控制命令。
? 概览
GamePanel Minecraft 插件充当您的代理服务器与 TeamPanel 生态系统之间的桥梁。它自动化数据收集,并为管理员和社区领导者提供关于整个网络中服务器性能和玩家行为的有价值洞察。
主要功能:
- 实时统计: 自动传输玩家数量(在线、加入、离开、新玩家)。
- 在线时长追踪: 精确记录所有用户的游戏会话,非常适合排行榜或奖励系统。
- 实时事件: 接收和处理来自 TeamPanel 仪表板的自定义命令和消息。
- 自动同步: 统计数据在后台定期(每分钟)传输,不会影响服务器性能。
- 群组同步(新增): 通过
/syncgroups 手动同步您的 TeamPanel 群组(30秒冷却时间)——例如用于 LuckPerms 或自定义命令。
- 中央 SyncProxy 配置(新增): 直接在 TeamPanel 中统一管理标签页、MOTD 和设置(白名单模式、槽位、版本范围)。
? 安装
- 下载最新的
.jar 文件。
- 将文件移动到 BungeeCord 或 Velocity 服务器的
plugins 文件夹中。
- 启动服务器一次以生成配置文件夹。
- 编辑
plugins/GamePanel/config.json(见下文)。
- 重启服务器以激活与 TeamPanel 的连接。
⚙️ 配置
配置文件位于 plugins/GamePanel/config.json。您必须在此输入凭据,以便插件能够与 API 通信。
{
"apiKey": "YOUR_API_KEY",
"gameServerId": "YOUR_SERVER_UUID",
"apiHost": "teampanel",
"debug": false
}
参数说明:
- apiKey:您的个人 API 密钥,您可以在 TeamPanel 仪表板中生成。它用于验证您的请求。
- gameServerId:您在 TeamPanel 中的服务器唯一 UUID。
- apiHost:API 请求的目标地址(默认为 "teampanel")。
- debug:如果您希望在控制台中看到详细日志(有助于故障排除),请将此值设置为
true。
? 群组同步 (/syncgroups)
- 命令:
/syncgroups (玩家)
- 别名:
/syncgroup, /sgroup, /sgoups
- 冷却时间:每位玩家 30 秒
- 描述:允许玩家手动将其 TeamPanel 群组与服务器同步(例如,以接收其 LuckPerms 等级或其他奖励)。
- 行为:触发与 TeamPanel 的群组同步。返回的命令(例如 LuckPerms)会通过服务器控制台自动执行。
BungeeCord 和 Velocity 原生注册该命令;仅对玩家可用(需要 UUID)。控制台输出会通知开始和完成状态。
? 中央配置
从版本 1.0.1 开始,插件利用可通过 TeamPanel UI 直接管理的统一配置:
1. SyncProxy 配置 (键: syncproxy_config)
管理代理特定的设置:
- 标签页: 多语言标题和底部信息。
- MOTDs: 针对不同白名单模式的自定义消息。
- 设置: 白名单模式、最大玩家数量和受支持的协议版本。
2. 游戏群组同步 (键: game-sync)
控制 TeamPanel 群组如何与服务器同步:
sync-enabled (布尔值) – 启用/禁用同步。
default-command (字符串) – 如果没有匹配的规则,可选的回退命令。
sync-commands (数组) – 每个 TeamPanel 群组的规则(例如,映射到游戏内群组/权限)。
所有配置都可以在不重启服务器的情况下实时重新加载。
? 高级功能
- 自动重连: 实时客户端包含网络中断时的自动重连逻辑。
- 代理支持: 专为代理环境设计,以高效处理全局玩家统计数据。
- 可扩展性: 该插件基于模块化架构构建,便于轻松扩展和自定义事件处理。
? 权限
以下权限由 SyncProxy 集成使用。
syncgroups.use — 允许使用 /syncgroups 及其别名
syncproxy.admin — 允许使用 /syncproxy 及其子命令
syncproxy.bypass.whitelist.team — 绕过 TEAM 白名单模式
syncproxy.bypass.whitelist.development — 绕过 DEVELOPMENT 白名单模式
syncproxy.bypass.whitelist.beta — 绕过 BETA 白名单模式
syncproxy.bypass.maxPlayerCount — 绕过最大玩家数量限制
? TeamPanel GamePanel - Minecraft (BungeeCord/Velocity) Integration
⚠️ Note: This plugin is currently in Beta. Please report any issues or feedback to our team.
Seamlessly connect your Minecraft proxy server (BungeeCord or Velocity) with TeamPanel. This plugin enables deep integration to track server statistics in real-time, synchronize player activity, and execute remote control commands directly from the TeamPanel dashboard.
? Overview
The GamePanel Minecraft Plugin acts as a bridge between your proxy server and the TeamPanel ecosystem. It automates data collection and provides administrators and community leaders with valuable insights into server performance and player behavior across your entire network.
Key Features:
- Real-time Statistics: Automatic transmission of player counts (Online, Joins, Leaves, New Players).
- Online Time Tracking: Precise recording of play sessions for all users, perfect for leaderboards or reward systems.
- Real-time Events: Receive and process custom commands and messages directly from the TeamPanel dashboard.
- Automated Synchronization: Statistics are transmitted in the background at regular intervals (every minute) without affecting server performance.
- Group Sync (new): Manual synchronization of your TeamPanel groups via
/syncgroups (with 30s cooldown) – e.g. for LuckPerms or custom commands.
- Central SyncProxy Configuration (new): Unified management of tabs, MOTDs, and settings (whitelist mode, slots, version range) directly in TeamPanel.
? Installation
- Download the latest
.jar file.
- Move the file into the
plugins folder of your BungeeCord or Velocity server.
- Start the server once to generate the configuration folders.
- Edit the
plugins/GamePanel/config.json (see below).
- Restart the server to activate the connection to TeamPanel.
⚙️ Configuration
The configuration is located at plugins/GamePanel/config.json. You must enter your credentials here so the plugin can communicate with the API.
{
"apiKey": "YOUR_API_KEY",
"gameServerId": "YOUR_SERVER_UUID",
"apiHost": "teampanel",
"debug": false
}
Parameter Explanation:
- apiKey: Your personal API key, which you can generate in the TeamPanel dashboard. It is used to authenticate your requests.
- gameServerId: The unique UUID of your server from TeamPanel.
- apiHost: The target address for API requests (defaulted to "teampanel").
- debug: Set this value to
true if you want to see detailed logs in the console (useful for troubleshooting).
? Group Sync (/syncgroups)
- Command:
/syncgroups (Player)
- Aliases:
/syncgroup, /sgroup, /sgoups
- Cooldown: 30 seconds per player
- Description: Allows players to manually synchronize their TeamPanel groups with the server (e.g., to receive their LuckPerms ranks or other rewards).
- Behavior: Triggers group synchronization with TeamPanel. Returned commands (e.g., LuckPerms) are automatically executed via the server console.
BungeeCord and Velocity register the command natively; usable only for players (UUID required). Console outputs inform about start and completion.
? Central Configuration
As of version 1.0.1, the plugin utilizes unified configurations manageable directly via the TeamPanel UI:
1. SyncProxy Configuration (Key: syncproxy_config)
Manages the proxy-specific settings:
- Tabs: Multi-language headers and footers.
- MOTDs: Customizable messages for different whitelist modes.
- Settings: Whitelist mode, max player count, and supported protocol versions.
2. Game Group Sync (Key: game-sync)
Controls how TeamPanel groups are synchronized with the server:
sync-enabled (Boolean) – Enables/Disables synchronization.
default-command (String) – Optional fallback command if no mapping matches.
sync-commands (Array) – Rules per TeamPanel group (e.g., mapping to in-game groups/permissions).
All configurations can be reloaded in real-time without restarting the server.
? Advanced Features
- Auto-Reconnect: The real-time client includes automatic reconnection logic for network interruptions.
- Proxy Support: Designed specifically for proxy environments to handle global player statistics efficiently.
- Extensible: The plugin is built on a modular architecture, allowing for easy expansion and custom event handling.
? Permissions
The following permissions are used by the SyncProxy integration.
syncgroups.use — Allows using /syncgroups and its aliases
syncproxy.admin — Allows using /syncproxy and its subcommands
syncproxy.bypass.whitelist.team — Bypass TEAM whitelist mode
syncproxy.bypass.whitelist.development — Bypass DEVELOPMENT whitelist mode
syncproxy.bypass.whitelist.beta — Bypass BETA whitelist mode
syncproxy.bypass.maxPlayerCount — Bypass the max player limit
评论 0
登录后参与评分
还没有评论,来抢沙发吧