GamePanel for TeamPanel

🎮 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

1. Download the latest .jar file.
2. Move the file into the plugins folder of your BungeeCord or Velocity server.
3. Start the server once to generate the configuration folders.
4. Edit the plugins/GamePanel/config.json (see below).
5. 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