Skip to content

SettingsAI

ekudram edited this page Jul 3, 2026 · 1 revision

AI Chat Bot 🤖

The AI tab configures integration with an external AI Chat Bot / Storyteller service.

This allows an AI to act as an additional "storyteller" responding to chat or controlling events.

Note: This is advanced and usually kept off unless you're running a compatible AI service.


Enable AI Chat Bot

  • Master toggle to turn the AI integration on or off.
  • When off, the AI features are disabled.

Cleanup Leftover AI Command Files

  • Button to clean up any old AI-generated command or event files left behind.
  • Useful for maintenance after testing or crashes.

Connection Settings

Listener URL / Endpoint

  • The address of your AI service that listens for messages.
  • Default example: http://127.0.0.1:17888
  • This is where RICS sends viewer chat messages for the AI to process.

Bot Response URL

  • Where the AI service sends its responses back.
  • Default example: http://127.0.0.1:5000/chat

Bot Name

  • The display name for the AI (e.g. "Masie Lamia").
  • Used in chat messages and logs.

Game State & Context

Send Game State

  • If enabled, RICS periodically sends current game information (colony status, etc.) to the AI.
  • Helps the AI make context-aware decisions.

Send Chat History

  • Sends recent chat history to the AI for better conversation continuity.

Update Interval (minutes)

  • How often to send updated game state (slider 0-60 min).

Timeout (ms)

  • How long to wait for AI responses (slider, default around 1000-30000 ms).

Push Endpoint

  • URL for pushing game state updates (e.g. http://127.0.0.1:5000/gamestate_update).

Can Execute Commands

  • Allows the AI to directly execute game commands (very powerful).
  • Warning: Only enable if you fully trust the AI service. It can perform actions in your game.

Test Connection

  • Button to test if the AI endpoint is reachable.

Tips

  • Most users leave this off unless experimenting with custom AI setups.
  • The AI name and endpoints must match your running AI service.
  • Use the cleanup button if you see leftover AI files in your mod data.
  • Changes save when you close the settings window.

Related Links

Back to top of Settings

Clone this wiki locally