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
  • chatPollInterval too high — reduce in config.json
  • Java mod API error — check storage/logs/laravel.log
  • Permission hytale-admin.chat-read missing

"Broadcast failed"

  • No players online to receive the message
  • API connection lost
  • Permission hytale-admin.chat-broadcast missing

Chat history is too short

  • maxChatHistory in config.json limits 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