Skip to content

fable

Living world and character tracker for roleplay-focused Red-DiscordBot servers.

Back to the cog catalog

Install

[p]repo add taakoscogs https://github.com/TaakoOfficial/TaakosCogs
[p]cog install taakoscogs fable
[p]load fable

Dashboard

This cog includes standalone Red-Web-Dashboard integration. Server managers can use the dashboard to view visible commands and the current server configuration when Red-Web-Dashboard is installed.

Highlights

  • Character profiles with rich fields and genre templates.
  • Character milestones, development timelines, and story arcs.
  • Relationship tracking with history and visual graphs.
  • Location creation, visits, connections, and maps.
  • In-character event logging.
  • Optional Google Sheets/Docs sync and export workflows.

Command Areas

Area Example Commands
Characters [p]fable character quickstart, [p]fable character view, [p]fable character edit, [p]fable character timeline
Relationships [p]fable relationship set, [p]fable relationship view, [p]fable relations, [p]fable visualize relationships
Events [p]fable event log, [p]fable event edit, [p]fable event delete
Milestones [p]fable milestone add, [p]fable milestone list, [p]fable milestone categories
Locations [p]fable location create, [p]fable location visit, [p]fable location connect, [p]fable location info
Visuals [p]fable visualize relationships, [p]fable visualize locations
Sync [p]fable sysetup, [p]fable syexport, [p]fable syimport, [p]fable systatus

Quick Start

[p]fable character quickstart "Aria" fantasy
[p]fable relationship set "Aria" "Bram" rival 4 "Stolen artifact dispute"
[p]fable location create "Silverwood" forest "Ancient magical forest"
[p]fable milestone add "Aria" "Personal Growth" "Mastered ancient magic"

Requirements

  • Red-DiscordBot 3.5.0 or newer.
  • Python 3.10 or newer.
  • graphviz>=0.20.0, google-api-python-client>=2.0.0, and google-auth>=2.0.0; Red's Downloader installs these Python packages automatically from the cog metadata.
  • Relationship and location graph images additionally require the Graphviz dot executable on the bot host (for Debian/Ubuntu: sudo apt install graphviz).
  • Send Messages and Embed Links.
  • Additional permissions may be needed for admin settings and export workflows.
  • Google API setup is optional and only needed for sync/export features.

Google service-account JSON must be submitted with the private /fable setapikey slash command. Fable deletes and rejects visible prefix messages containing credentials. The key is stored in the server's Red Config and is only sent to Google's APIs during an explicit sync operation.

Data

Fable stores character profiles, relationships, locations, events, story arcs, settings, and optional sync configuration as configured by users. Data is not shared externally unless an explicit export or sync workflow is configured.

Artwork

Book footer icons use Twemoji v17.0.3 graphics under CC-BY 4.0. Full attribution and license links are in the repository's third-party notices.