🎮 TeamPanel GamePanel - Hytale Integration

⚠️ Note: This plugin is currently in Beta. Please report any issues or feedback to our team.

Seamlessly connect your Hytale server with TeamPanel. This mod 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 Hytale Plugin acts as a bridge between your Hytale server and the TeamPanel ecosystem. It automates data collection and provides administrators and community leaders with valuable insights into server performance and player behavior.

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). Commands from the API server are executed via the Hytale console.
Central Configuration (new): Management of Game Group Sync settings directly in the TeamPanel UI.

🛠 Installation

Download the latest .jar file.
Move the file into the mods folder of your Hytale server.
Start the server once to generate the configuration folders.
Edit the mods/GamePanel/config.json (see below).
Restart the server to activate the connection to TeamPanel.

⚙️ Configuration

The configuration is located at mods/GamePanel/config.json. You must enter your credentials here so the mod 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 execute commands).
Behavior: Triggers group synchronization with TeamPanel. Returned commands are executed via CommandManager as console commands.

🧩 Central Configuration (Game Group Sync)

As of version 1.0.1, the Hytale plugin loads a TeamPanel configuration (Key: game-sync) and creates it automatically if needed. It is editable in the TeamPanel UI and controls group synchronization:

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).

The configuration can be reloaded via realtime without restarting the server.

💡 Advanced Features

Auto-Reconnect: The real-time client includes automatic reconnection logic for network interruptions.
Extensible: The plugin is designed to be easily extended with additional Hytale-specific events.

🔒 Permissions

The following permissions are used by the Hytale integration.

syncgroups.use — Allows using /syncgroups and its aliases

GamePanel for TeamPanel