No description
Find a file
2024-06-01 20:29:09 +08:00
.github/workflows Update 2024-05-08 11:02:39 +08:00
src wip 2024-06-01 20:29:09 +08:00
tasks Update 2024-05-09 09:33:25 +08:00
.gitignore Update 2024-05-06 01:55:26 +08:00
esbuild.config.mjs Update 2024-05-11 00:08:40 +08:00
eslint.config.mjs Update 2024-05-06 11:26:27 +08:00
LICENSE Create LICENSE 2024-05-06 15:24:22 +08:00
manifest.json Separate oracle tab 2024-05-28 16:36:19 +08:00
package-lock.json Update 2024-05-11 00:08:40 +08:00
package.json Separate oracle tab 2024-05-28 16:36:19 +08:00
README.md Update README.md 2024-05-29 19:52:48 +08:00
tsconfig.json Update 2024-05-12 09:22:49 +08:00

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!