Game Log

RPGs I've played

About

This is a log of all the games I've played starting in 2021. I'm keeping this log in anticipation of writing a "Every game I played in 2021" blog post in 2022.

I decided to use recutils for this because, why not.

Getting Started

You don't need to install anything if you don't want to. You can just edit the rec file.

But if you want to use the TUI, then npm i and just new (or node bin/cli.js) to create a new entry using the interative prompt.

Dependencies

• GNU recutils

• node (optional)

• just (optional)

• csvkit (optional)

Considerations

What kind of stuff am I interested in keeping track of?

• Role: Player or DM?
• Format: In person? (Ha, one day.) Roll20/Discord? Play by post?
• Length: One-shot, adventure, campaign?
• Crew: Who did I play with?

Schema

You should probably just read the recfile because that will always be the source of truth, but at the time of this writing, the schema is as follows.

%rec: Game
%doc: a ttrpg game I have played or am playing
%key: Id
%type: Id int
%type: System,Module,Format line
%type: Updated,Started date
%typedef: Role enum DM Player
%typedef: Length enum Campaign Adventure Oneshot
%typedef: Status enum Ongoing Complete Hiatus Dead
%auto: Id Updated
%mandatory: Id System Module Format Notes Updated Started Role Length Status

Note: Notes (arguably the most important field) does not have a type because there is no valid type for multi-line entries in recfiles. Thus is remains untyped, uncheckable by recins, and undocumented in the schema. I consider this a bug of the recutils.

Learnings

check out doc/learnings.md

Recsel examples

• recsel -e "Role = 'Player'" games.rec

See justfile for more examples

Todo

• Add types/enums
• tui? run just new (or node bin/cli.js)
• add Update to CLI

Resources

• https://labs.tomasino.org/gnu-recutils/
• https://github.com/zaid/vim-rec
• https://www.gnu.org/software/recutils/manual/