### \ud83c\udfae TeamPanel GamePanel – Minecraft (BungeeCord\/Velocity) Integration<\/p>\n
> \u26a0\ufe0f **Note:** This plugin is currently in **Beta**. Please report any issues or feedback to our team.<\/p>\n
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.<\/p>\n
—<\/p>\n
### \ud83d\ude80 Overview<\/p>\n
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.<\/p>\n
#### Key Features:
\n* **Real-time Statistics:** Automatic transmission of player counts (Online, Joins, Leaves, New Players).
\n* **Online Time Tracking:** Precise recording of play sessions for all users, perfect for leaderboards or reward systems.
\n* **Real-time Events:** Receive and process custom commands and messages directly from the TeamPanel dashboard.
\n* **Automated Synchronization:** Statistics are transmitted in the background at regular intervals (every minute) without affecting server performance.
\n* **Group Sync (new):** Manual synchronization of your TeamPanel groups via `\/syncgroups` (with 30s cooldown) \u2013 e.g. for LuckPerms or custom commands.
\n* **Central SyncProxy Configuration (new):** Unified management of tabs, MOTDs, and settings (whitelist mode, slots, version range) directly in TeamPanel.<\/p>\n
—<\/p>\n
### \ud83d\udee0 Installation<\/p>\n
1. Download the latest `.jar` file.
\n2. Move the file into the `plugins` folder of your BungeeCord or Velocity server.
\n3. Start the server once to generate the configuration folders.
\n4. Edit the `plugins\/GamePanel\/config.json` (see below).
\n5. Restart the server to activate the connection to TeamPanel.<\/p>\n
—<\/p>\n
### \u2699\ufe0f Configuration<\/p>\n
The configuration is located at `plugins\/GamePanel\/config.json`. You must enter your credentials here so the plugin can communicate with the API.<\/p>\n
“`json
\n{
\n “apiKey”: “YOUR_API_KEY”,
\n “gameServerId”: “YOUR_SERVER_UUID”,
\n “apiHost”: “teampanel”,
\n “debug”: false
\n}
\n“`<\/p>\n
#### Parameter Explanation:<\/p>\n
* **apiKey**: Your personal API key, which you can generate in the TeamPanel dashboard. It is used to authenticate your requests.
\n* **gameServerId**: The unique UUID of your server from TeamPanel.
\n* **apiHost**: The target address for API requests (defaulted to “teampanel”).
\n* **debug**: Set this value to `true` if you want to see detailed logs in the console (useful for troubleshooting).<\/p>\n
—<\/p>\n
### \ud83d\udd01 Group Sync (\/syncgroups)<\/p>\n
* Command: `\/syncgroups` (Player)
\n* Aliases: `\/syncgroup`, `\/sgroup`, `\/sgoups`
\n* Cooldown: 30 seconds per player
\n* Description: Allows players to manually synchronize their TeamPanel groups with the server (e.g., to receive their LuckPerms ranks or other rewards).
\n* Behavior: Triggers group synchronization with TeamPanel. Returned commands (e.g., LuckPerms) are automatically executed via the server console.<\/p>\n
BungeeCord and Velocity register the command natively; usable only for players (UUID required). Console outputs inform about start and completion.<\/p>\n
—<\/p>\n
### \ud83e\udde9 Central Configuration<\/p>\n
As of version 1.0.1, the plugin utilizes unified configurations manageable directly via the TeamPanel UI:<\/p>\n
#### 1. SyncProxy Configuration (Key: `syncproxy_config`)
\nManages the proxy-specific settings:
\n* **Tabs:** Multi-language headers and footers.
\n* **MOTDs:** Customizable messages for different whitelist modes.
\n* **Settings:** Whitelist mode, max player count, and supported protocol versions.<\/p>\n
#### 2. Game Group Sync (Key: `game-sync`)
\nControls how TeamPanel groups are synchronized with the server:
\n* `sync-enabled` (Boolean) \u2013 Enables\/Disables synchronization.
\n* `default-command` (String) \u2013 Optional fallback command if no mapping matches.
\n* `sync-commands` (Array) \u2013 Rules per TeamPanel group (e.g., mapping to in-game groups\/permissions).<\/p>\n
All configurations can be reloaded in real-time without restarting the server.<\/p>\n
—<\/p>\n
### \ud83d\udca1 Advanced Features<\/p>\n
* **Auto-Reconnect:** The real-time client includes automatic reconnection logic for network interruptions.
\n* **Proxy Support:** Designed specifically for proxy environments to handle global player statistics efficiently.
\n* **Extensible:** The plugin is built on a modular architecture, allowing for easy expansion and custom event handling.<\/p>\n
—<\/p>\n
### \ud83d\udd12 Permissions<\/p>\n
The following permissions are used by the SyncProxy integration.<\/p>\n
– `syncgroups.use` \u2014 Allows using `\/syncgroups` and its aliases
\n– `syncproxy.admin` \u2014 Allows using `\/syncproxy` and its subcommands
\n– `syncproxy.bypass.whitelist.team` \u2014 Bypass TEAM whitelist mode
\n– `syncproxy.bypass.whitelist.development` \u2014 Bypass DEVELOPMENT whitelist mode
\n– `syncproxy.bypass.whitelist.beta` \u2014 Bypass BETA whitelist mode
\n– `syncproxy.bypass.maxPlayerCount` \u2014 Bypass the max player limit<\/p>\n","protected":false},"excerpt":{"rendered":"
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.<\/p>\n","protected":false},"featured_media":74720,"template":"","meta":{"_minecraft_slug":"gamepanel-for-teampanel","_minecraft_project_id":"cpKCciKT","_minecraft_author":"teampanel","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":50,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gamepanel-for-teampanel.zip","_minecraft_size_bytes":18526935,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T21:05:51.354906Z","_minecraft_date_created":"2026-02-07T06:58:49.655806Z","_minecraft_date_modified":"2026-02-17T20:52:37.874077Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gamepanel-for-teampanel","_minecraft_icon_attachment_id":74720,"_minecraft_imported_at":"2026-06-04T08:06:54+00:00","_minecraft_import_hash":"855097202528323300387bba8373311c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,126,90,123,985],"mod_loader":[895,986],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-74719","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-management","mod_category-optimization","mod_category-technology","mod_category-velocity","mod_loader-bungeecord","mod_loader-velocity","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n