Chat
Chat
Real-time chat monitoring with configurable polling, event filtering, and broadcast messaging.
Chat Monitor
The chat page displays live server chat messages with automatic polling:
| Setting | Default | Configurable Via |
|---|---|---|
| Poll Interval | 3 seconds | chatPollInterval in config.json |
| Max History | 500 messages | maxChatHistory in config.json |
API Endpoint
| Detail | Value |
|---|---|
| Permission | hytale-admin.chat-read |
| API | GET /chat |
| Parameters | limit (max messages), eventType (filter) |
Event Types
The chat API supports filtering by event type:
- Chat messages — Regular player chat
- System messages — Server announcements
- Join/Leave events — Player connections
Message Display
Each chat message shows:
- Timestamp — Localized to panel timezone
- Player name — With avatar if available
- Message content — Full text
- Event type — Visual indicator for chat/system/join/leave
Broadcast Messages
Send a message to all online players:
| Detail | Value |
|---|---|
| Permission | hytale-admin.chat-broadcast |
| API | POST /chat/broadcast |
| Success | "Broadcast sent" |
| Failure | "Broadcast failed" |
| Logged as | server:hytale-admin.broadcast |
The broadcast message appears in the server chat for all players and is logged in the activity log.
Death Log
The chat page also includes access to the death log via GET /deaths:
- Shows recent player deaths with cause and location
- Useful for monitoring PvP activity or dangerous areas
Troubleshooting
Chat doesn't update
- Server may be offline — no chat to display
chatPollIntervaltoo high — reduce inconfig.json- Java mod API error — check
storage/logs/laravel.log - Permission
hytale-admin.chat-readmissing
"Broadcast failed"
- No players online to receive the message
- API connection lost
- Permission
hytale-admin.chat-broadcastmissing
Chat history is too short
maxChatHistoryinconfig.jsonlimits retained messages (default 500)- Increase if you need more history
- Messages are stored in memory — server restart clears history
Old messages showing
- Chat polling fetches the latest messages each cycle
- If you see stale messages, the server may have restarted and replayed from saved state