| .github/workflows | ||
| src | ||
| tasks | ||
| .gitignore | ||
| esbuild.config.mjs | ||
| eslint.config.mjs | ||
| LICENSE | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
Solo RPG Toolkit
A plugin for Obsidian (https://obsidian.md) that adds helpful features for playing TTRPGs. Its features are mainly geared towards solo gameplay using a GM emulator.
Features
Dice roller
Quickly roll a bunch of dice by clicking on a die icon.
Deck of cards
A standard deck of 52 cards plus two optional joker cards.
Random generators
A set of random word generators. Great for coming up with ideas on how to progress the story.
Additionally you may add any number of your own random tables to roll on, by creating notes inside a special folder in your vault (folder "Tables" by default).
Inline dynamic counters
Code blocks with a single number in it (e.g. `5`) will be rendered with - and + buttons for quick adjustment.
Note that this feature is disabled by default and can be enabled in plugin settings.
Inline progress trackers
Similar to counters, code blocks with two numbers separated by a slash (e.g. `1/5`) will be rendered as a set of checkable boxes. For PbtA-style clocks and general progress tracking.
Note that this feature is disabled by default and can be enabled in plugin settings.
Installation
From GitHub Release
Download solo-rpg-toolkit.zip from the latest release, and extract the plugin folder into your vault's plugins folder: <path-to-vault>/.obsidian/plugins/.
Note that .obsidian folder in your vault may be hidden on Linux and MacOS.
From source
You'll need at least node-18 to be installed on your machine. Run the following commands while inside the source folder:
npm install
npm run build
npm run deploy
You will find a newly generated plugin folder solo-rpg-toolkit inside folder dist. Move the solo-rpg-toolkit plugin folder into your vault's plugins folder: <path-to-vault>/.obsidian/plugins/.
Note that .obsidian folder in your vault may be hidden on Linux and MacOS.
Updating
Simply replace <path-to-vault>/.obsidian/plugins/solo-rpg-toolkit folder with a new one.
Note that plugin settings are stored in the file <path-to-vault>/.obsidian/plugins/solo-rpg-toolkit/data.json. You may want to keep it after updating to a newer version.
Feature and content requests
If you have an idea for a new feature or new content, feel free to create an "issue" on github or reach me at kurowski.dev@gmail.com!