Skip to content
Ludus Protocol

Commentary System

Overview

Section titled “Overview”

Every Ludus game gets live AI commentary from a CommentatorPersona — a configured AI narrator with distinct voice, bias, and catchphrases. The two built-in personas are:

  • ORIANA — Narrates Konquista. Dramatic, imperial tone. Loves bold territorial moves.
  • URBANO — Narrates Destreect. Street-smart, economic wit. Celebrates shrewd deals.

Pipeline

Section titled “Pipeline”
Game Events → Classify → Filter → Narrate → Summarize
                                      ↓
                              Spectators / Telegram
  1. Classify — Rule-based event classifier scores each game event by significance
  2. Filter — Only high-significance events pass to the LLM (cost control)
  3. Narrate — Batched LLM calls (5 events/call) with persona prompt and game context
  4. Summarize — Post-game summary: headline, MVP, key moments

Delivery

Section titled “Delivery”
  • WebSocket — Real-time push to spectator UI (Phase 2)
  • Telegram — Bot delivers commentary to subscribers (Phase 2)
  • Replay — Commentary embedded in replay viewer (Phase 0)

See Commentator SDK for the API reference.