Dashboard
Eranio
Dashboard
The Dashboard provides a real-time overview of your Hytale server with live status monitoring, quick player actions, and server health indicators.
Navigation
The menu at the top lists every page you are allowed to open: Dashboard, Players, Moderation, Chat, World, Memories, Config, Backups, Mods and Setup. Pages you have no permission for are hidden.
There is no refresh button. The pages update themselves: Dashboard every 30 seconds (time of day every second, weather every 10 seconds), Players every 15 seconds, Moderation every 30 seconds, World every 10 seconds, Backups every 60 seconds and Chat at the interval set on the Setup page. Memories, Config, Mods and Setup load fresh whenever you open them. New players from the server files are picked up when you open Dashboard or Players, at most every five minutes.
On phones
On small screens the button row is replaced by one of two layouts:
- Bar at the bottom: Dashboard, Players, Moderation and Chat sit in a bar at the bottom of the screen. "More" opens the remaining pages.
- Dropdown: a field below the title shows the current page. Tap it to see all pages.
Switch between them at the bottom of "More" or of the dropdown list. The choice is saved in the browser and also applies to Game Mods and Minecraft Plugins. On a computer the button row stays as it is.
Header
The top shows whether the Java mod's API can be reached (API online or API offline), plus the Hytale version, the admin mod version, the default world and the uptime since the last server start.
When a newer version of the admin mod exists, a notice shows the new and the installed version with a link to the setup page. Nothing is ever updated automatically, only by hand on the setup page, and the new version takes effect after the next server restart.
When demo mode is on, a notice banner sits above. When the mod's integrity check fails, a warning appears.
Figures
| Card | Content |
|---|---|
| Online players | Players currently on the server |
| TPS | Server ticks per second, 30 is Hytale's maximum |
| CPU (server) | Load of the server process in percent, with a bar |
| Memory | Java memory used by the server, with a bar |
| Installed mods | Number of mods in the mods folder |
TPS Health Indicators
| TPS range | Status | Meaning |
|---|---|---|
| 27-30 | Healthy | Server runs smoothly |
| 20-27 | Warning | Slight lag, look into it if it lasts |
| <20 | Critical | Heavy lag, check the server load |
The page reloads these values every 30 seconds.
Day & Night
The card shows the in-game time and refreshes every second:
| Display | Meaning |
|---|---|
| Time | Game time as hours and minutes, with sun or moon depending on the time of day |
| Sunlight | Brightness of the sun in percent |
| Moon phase | Current moon phase, if the server reports it |
| Day progress | How far the game day has progressed, plus a sky bar with the sun at the matching spot |
With the hytale-admin.world-manage permission there are four buttons that set the time right away: Midnight, Sunrise, Noon and Sunset.
Weather
The weather card shows the current weather and, if one is forced, the badge Forced. Below is the weather per zone with each zone's name.
With the hytale-admin.world-manage permission:
| Control | Effect |
|---|---|
| Clear, Rain, Storm, Snow | Sets the world weather right away |
| World events | Shows whether world events are on or off |
| Weather per zone | Hytale picks new weather for every zone each game hour. Here it can be fixed per zone (Change) or set back to Natural. It applies on the surface, not in caves and dungeons, and survives restarts. Each zone lists the players currently in it. |
| Force for the whole world | Overrides every zone with one weather until it is switched off again |
The weather per zone area refreshes every 10 seconds.
Active Instances
Since Hytale 0.7, portals and dungeons run in temporary instance worlds. The dashboard lists every open instance with a title by portal type instead of the long world id. Per instance (with hytale-admin.world-manage):
| Control | Effect |
|---|---|
| Set spawn | Moves the instance spawn (prefilled with the current spawn) |
| World events | Turns world events in the instance on or off |
| Portal time | Time left -1, +1 or +5 minutes, pause or resume the timer |
| Void invasion | Current stage with a live countdown, stop the invasion or allow it again |
| Close instance | Closes an empty instance |
Players inside an instance are listed by name. Player actions (send into an instance, leave an instance and so on) are on the players page.
Current Players
At the bottom are the players online right now, with avatar, online or offline status and health. All players opens the players page.
Demo Mode
Demo mode is switched on and off on the setup page (permission hytale-admin.setup). It stays on for this server until it is switched off there and shows test data instead of real values on every page:
- Test data from
DemoDataServiceandDemoInventoryService - Actions show success messages without real API calls
- Identicon avatars for demo players
- Useful for training, screenshots or UI tests
For a quick look a page can also be opened with ?demo=1 in the address, which only applies to that request.
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.logfor "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 (Chat page)
- No admin actions performed yet
- User lacks
hytale-admin.activitypermission - Activity logging table issue, check database