Gaming Rcon

Last updated: April 11, 2026

Assistant Hytale and Game RCON

The assistant module includes specialized integration for managing gaming servers, specifically focusing on Hytale and Minecraft via the Remote Console (RCON) protocol.

RCON Implementation (hytale_rcon.go)

The system implements a custom RCON client optimized for the unique requirements of the dLAN gaming cluster.

Key Features

  • Persistence: Maintains long-lived RCON connections to prevent login overhead.
  • Security: Safely handles RCON passwords through the system's encrypted configuration.
  • Command Sanitization: Filters outgoing commands to prevent destructive server-level changes (e.g., stop, op) unless the user has the RoleMasterAdmin.

Agent Integration

The lia and oracle agents are the primary users of these tools.

1. Player Management

Agents can query the server for:

  • Active player lists.
  • Player statistics (playtime, health, location).
  • Chat logs for sentiment analysis or moderation.

2. Server Control

Authorized agents can execute game-level commands:

  • Broadcasting global announcements.
  • Changing game rules (e.g., time of day, weather).
  • Kicking/Banning malicious actors based on automated log scanning.

Integration Flow

  1. Alert: monitor/pelican detects a high player count or a lag spike on a game node.
  2. Investigation: The oracle agent is woken up.
  3. Command: Oracle uses the hytale_rcon tool to query /tps and /list.
  4. Action: If lag is high, Oracle may use the RCON tool to broadcast a warning or restart a specific game world plugin.

Mermaid Diagram: Gaming Flow

sequenceDiagram
    participant U as User / Player
    participant M as monitor/pelican
    participant A as Oracle Agent
    participant R as hytale_rcon.go
    participant G as Game Server (Hytale/MC)

    U->>G: Plays Game
    M->>G: Polls node health
    M-->>A: Trigger Alert (Low TPS)
    A->>R: Execute RCON (/tps)
    R->>G: Send Packet
    G-->>R: Response: 12.5 TPS
    R-->>A: Raw TPS Data
    A->>R: Execute RCON (/say High lag detected. Optimizing...)
    A-->>U: Notifies WhatsApp Group

Guidance for AI Agents

  • Etiquette: When broadcasting to the game server, use a persona-appropriate tone. Lia should be friendly and enthusiastic, while Oracle should be clinical and professional.
  • Caution: Game commands can be disruptive. Always verify the current server state before executing "clearing" or "restarting" commands.

Cross-References