How to Find and Read Hytale Server Logs for Troubleshooting

Log files are essential for troubleshooting Hytale server issues. This guide shows you where to find logs and how to use them for debugging.

Server Log Location

Hytale server logs are stored in the logs/ directory within your server installation:

/path/to/server/logs/

Pterodactyl Panel

/home/container/logs/

Windows Self-Hosted

C:\HytaleServer\logs\

Linux Self-Hosted

/opt/hytale/logs/

Log File Types

Latest Log

The current session’s log file, typically named latest.log or with a timestamp.

Archived Logs

Previous session logs are often compressed and timestamped:

2026-01-13-1.log.gz
2026-01-13-2.log.gz

What Logs Contain

Server logs include:

• Startup information: Server initialization, version info
• Authentication status: OAuth token validation results
• Player connections: Join/leave events with player names and UUIDs
• Errors and warnings: Stack traces for crashes and issues
• Plugin output: Messages from installed plugins
• World loading: Chunk loading and generation info
• Console commands: Commands executed on the server

Viewing Logs

Real-Time via Console

When running the server directly, logs appear in the console output.

Via Game Panel

Most game panels (including Pterodactyl) provide a web-based console and file browser to view logs.

Via Command Line

Windows (PowerShell):

Get-Content logs\latest.log -Wait

Linux:

tail -f logs/latest.log

Common Log Messages

Successful Authentication

Authentication successful! Mode: OAUTH_DEVICE

Authentication Failed

Token validation failed. Server starting unauthenticated.
Use /auth login to authenticate.

Player Connected

[INFO] PlayerName (UUID: xxx) connected from 192.168.x.x

Server Started

[INFO] Server started on 0.0.0.0:5520

Troubleshooting with Logs

Finding Errors

Search for ERROR or WARN messages:

Linux:

grep -i "error\|warn" logs/latest.log

Windows PowerShell:

Select-String -Path logs\latest.log -Pattern "error|warn"

Connection Issues

Look for messages containing “connect”, “timeout”, or “refused”.

Plugin Errors

Search for the plugin name to find related errors.

Sharing Logs for Support

When requesting support:

1. Locate the relevant log file
2. Copy the full log or relevant sections
3. Use a paste service (pastebin, hastebin) for long logs
4. Include the time when the issue occurred
5. Note any recent changes to the server

Client Log Locations

For client-side issues, Hytale stores logs at: