Skip to content

Latest commit

 

History

History
47 lines (37 loc) · 3.05 KB

README.md

File metadata and controls

47 lines (37 loc) · 3.05 KB

Discord Fate Bot

A self-hosted bot for playing Fate RPG completely within Discord.

Example image of bot output

Example image of roll prompt and output

Right now, the bot is meant to be run locally. The current state of the entities (including all aspects, fate points, skills, and stress tracks) are saved in an entities.json at the root of the project. After most successful commands, the bot will update the stored state and print out the affected state. Otherwise, an error message will be displayed.

A "GM" role is required on any server that the bot is invited to, which prevents any commands besides |, |help, |skills, and |roll from being run by players.

Setup

(TODO)

Commands

All commands are prefixed with | (the "pipe" character).

Command Shortcut Description
| Output the current entities list
|aspect+ *entity* *aspect* |a Add aspect to entity", "Shortcut: `
|aspect+1 *entity* *aspect* |a1 Add aspect to entity with 1 free invoke
|aspect+2 *entity* *aspect* |a2 Add aspect to entity with 2 free invokes
|aspect- *entity* *aspect* |A Remove aspect (or boost) from entity
|boost *entity* *aspect* |b Add a boost aspect to entity (with 1 free invoke)
|clear *entity* *type* |C Clear stress of type on the entity
|clearall *type* |CC Clear all stress of type across all entities
|entity+ *entity* |e Create a new entity
|entity- *entity* |E Deletes entity
|fate+ *entity* |f Give a fate point to entity
|fate- *entity* |F Take a fate point from entity
|fate= *points* *entity* |f= Set fate points for the entity
|help |h Print this command list to Discord
|invoke+ *entity* *aspect* |i Add a free invoke to aspect on entity
|invoke- *entity* *aspect* |I Remove a free invoke to aspect on entity
|invoke= *count* *entity* *aspect* |i= Set free invokes to count on the aspect for entity
|roll *rating* |r Roll 4dF with rating of positive or negative number
|skill+ *entity* *skill* *rating* Add a skill with rating to entity
|skill- *entity* *skill* Remove skill from entity
|skills *entity* |k Print out skills list for entity
|stress+ *entity* *type* *number* |s Add type stress (consuming a number box) on entity
|stress- *entity* *type* *number* |S Remove type stress (clearing a number box) on entity
|track+ *entity* *type* *values* |t Create a stress track for entity of type with values as a string of ratings (e.g., 123 for 1️⃣ 2️⃣ 3️⃣)
|track- *entity* *type* |T Remove the stress track of type for entity