Dashboard

The Dashboard provides a real-time overview of your Hytale server with live status monitoring, quick player actions, and server health indicators.

Status Widget

The status widget polls the Java mod API every 10 seconds via GET /status:

Metric	Description
Online Players	Current player count and list
TPS	Server ticks per second (20 = optimal)
Uptime	Time since last server start
Server Version	Hytale server version and revision

TPS Health Indicators

TPS Range	Status	Meaning
18-20	Healthy	Server running smoothly
15-18	Warning	Slight lag, investigate if persistent
<15	Critical	Significant lag, check server load

Quick Actions

Depending on your permissions, the dashboard provides quick action buttons:

Action	Required Permission	API Call
View online players	`hytale-admin.players-read`	`GET /players`
Kick player	`hytale-admin.players-manage`	`POST /players/{name}/kick`
Broadcast message	`hytale-admin.chat-broadcast`	`POST /chat/broadcast`
View server version	`hytale-admin.dashboard`	`GET /version`

Activity Log Tab

If you have the hytale-admin.activity permission, the dashboard shows a recent activity log — all admin actions performed through the panel:

Kicks, bans, unbans
Teleports, gamemode changes
Inventory edits
Config changes
Backup operations

Activities are logged using Pelican's built-in activity_logs table with the prefix server:hytale-admin.*.

The activity log tab polls every 30 seconds.

Demo Mode

Toggle Demo Mode from the dashboard to test all features without affecting the real server:

Uses DemoDataService and DemoInventoryService for fake data
All actions display success notifications without making real API calls
Identicon avatars generated for demo players
Useful for training, screenshots, or testing UI changes

Demo mode is session-based — it resets when you navigate away or refresh.

Installed Mods

The dashboard also shows a list of installed Java mods on the server via GET /mods. This helps verify the HytaleAdminAPI mod is loaded along with any other server mods.

Troubleshooting

Dashboard shows no data

Server may be offline — check server status in Pelican
Java mod may not be loaded — check mods/ directory
API connection failed — check storage/logs/laravel.log for "Hytale API error: /status"
Port 5550 may be blocked — verify firewall rules

TPS shows 0 or very low

Server is starting up (normal during first 30s)
Server is overloaded — check CPU/RAM usage
World corruption — check server console for errors

Activity log empty

No admin actions performed yet
User lacks hytale-admin.activity permission
Activity logging table issue — check database