RuneQuest Glorantha system for Foundry Virtual Table Top
Installing
Paste this into Foundry VTT Install System -> Manifest URL https://github.com/sun-dragon-cult/fvtt-system-rqg/releases/latest/download/system.json
You will also need the wiki content module that can be installed with https://github.com/sun-dragon-cult/fvtt-module-wiki-rqg/releases/latest/download/en-module.json
In addition there are some recommended modules that are not necessary, but adds functionality if they are installed:
- Drag Ruler that has an integration to color code token movement limits.
- Times Up that will auto expire token effects like protection spells after 10 combat rounds.
Usage
Se the Wiki for more details.
Development
Written in typescript wih the help of the fantastic League of Foundry Developers Foundry VTT Types.
After a yarn install
to get the dependencies, do yarn build
to build the system and compile the compendium packs into a dist
folder.
For easy development make a softlink from foundrydata/Data/systems/rqg
to that dist
folder.
To decrease the time it takes to build the system you can skip generating the compendium packs by running yarn build:system
.
This assumes that you previously have compiled the compendium packs with yarn build
or yarn build:packs
.
These commands builds the pack db files to src/assets/packs/
from the yaml file sources under src/assets/compendiums/
If you like to remove the system from foundry then remove the file system softlink.
Development in Windows
The build scripts make use of Husky which means that you need to use the Git Bash shell that is supplied by the nodejs windows install when you run the yarn commands to build the system.
Conventional Commit message standard
The changelog of this project is autogenerated from the commit messages. To make this work they must follow the conventional commit
standard. There is a pre-commit hook to check if the commit message follows the rules so if you get an error when committing this could be the cause.
The most common types of commmits are additions of new features: feat: add quantity to all items
and fixing of bugs: fix: dropping items generates a NPE
.
Prettier formatting
The code should be formatted with Prettier and a pre-commit hook will autoformat the code you commit. It is recommended to install a formatter in your IDE to format your code on the fly.
Editing compendium Yaml files
To make it easier to edit the yaml files that is used to create to compendium packs, you can
use the supplied json schema for Rqg Items located here: src/data-model/jsonSchemas/rqg-item-schema.json
.
Visual Studio Code
To enable yaml validation in vs code, you first need to install this YAML plugin and then configure it to use the RqgItem schema, use the setting below.
{
"yaml.schemas": {
"https://raw.githubusercontent.com/sun-dragon-cult/fvtt-system-rqg/master/src/data-model/jsonSchemas/rqg-item-schema.json": ".yaml"
}
}
For details see this article: https://dev.to/brpaz/how-to-create-your-own-auto-completion-for-json-and-yaml-files-on-vs-code-with-the-help-of-json-schema-k1i
Jetbrains Idea
Open a yaml file and click "No JSON Schema" at the bottom left. Choose "+ New Schema Mapping" and paste https://raw.githubusercontent.com/sun-dragon-cult/fvtt-system-rqg/master/src/data-model/jsonSchemas/rqg-item-schema.json
into the "Schema file or URL" input field. Name the schema to for example Rqg Item and set the schema
version to 7.
Project Status
Still very much work in progress. 🚧 But closing in on a release version...