Skip to main content

Sample Companions

Explore open-source companions built with the Companion API. Clone them, customize them, and deploy your own.

Lore Analyst

A Discord bot that tracks faction movements, territory changes, and political tensions across chapters. Posts daily briefings and answers lore questions using the query endpoint. Built with discord.js and the JS SDK.

Required Scopes

chapters.readfactions.readterritories.readquery

Clone and run:

git clone https://github.com/thelivingchronicle/sample-lore-analyst && cd lore-analyst && npm install && npm start

Strategy Bot

A Telegram bot that analyzes vote outcomes and player behavior patterns. Recommends optimal faction strategies, calculates influence projections, and simulates alliance scenarios. Built with Python and the Python SDK.

Required Scopes

chapters.readfactions.readterritories.read

Clone and run:

git clone https://github.com/thelivingchronicle/sample-strategy-bot && cd strategy-bot && npm install && npm start

Roleplay Companion

A web app that generates in-character dialogue, faction briefings, and narrative summaries. Players enter their faction and rank to get personalized story recaps and character interactions. Built with Next.js and the JS SDK.

Required Scopes

chapters.readcharacters.readlocations.readquery

Clone and run:

git clone https://github.com/thelivingchronicle/sample-roleplay-companion && cd roleplay-companion && npm install && npm start
Sample Companions — Developer Portal | The Living Chronicle