hitcherland / FoundryVTT-Heart

Basic FoundryVTT System for Heart - The City Beneath
Creative Commons Zero v1.0 Universal
7 stars 14 forks source link

Heart - The City Beneath

This is a simplistic implementation of Heart - The City Beneath for FoundryVTT . It provides a character sheet based on the one provided inside Heart. Includes a number of useful dynamic tools for rolling and assessing results.

Features

Usage

Buttons are available in the character sheet for players, or from the hotbar via macros for the GM.

An example character sheet

Macros

Roll Requests

A roll request is a clickable chat message that allows the players to roll with specific parameters. Rolls can be made via:

Clicking on either of these will open a window like below:

Blank Roll Request window

For example, preparing a roll request like this:

Preparing a Roll Request

will create a chat message like this:

Roll Request in Chat

Rolls

This is a typical "Heart" 1d10 roll. Rolls can be made with the following:

As before, this will open a new window.

Prepare roll

Again, this might result in chat messages like:

Success roll Failure roll

Stress

We also can manage stress rolls.

Stress rolls can be made with the following:

From the macro:

Prepare stress roll

From chat: Stress Roll button

which might result in:

Stress chat message

You can then "Take Stress" by clicking the new button. This applies the stress to the character's appropriate resistance.

Take Stress button

Fallout

We also can manage fallout rolls. Stress rolls can be made with the following:

An example chat message as a result:

Fallout Chat Message

You will get a result and an accompanying button to clear the appropriate stress:

Fallout Result Message

Translations

If you're considering writing a translation, firstly: thank you! You can provide translation by submitting a pull request.

You can find the English translation at lang/en.json, and I encourage you to use this as a base for your translation efforts. Don't feel the pressure to translate version info though!

Contributing

It is not recommended to develop on the instance on Foundry you run games from. If you need help installing another version of Foundry or a dev environment this isn't the guide for that.

To test your changes:

Add your Foundry installation's Data location to foundryvtt.config.js it should look something like: foundryvttPath: "/home/yourusername/foundryuserdata/Data"

Inside this directory run:

npm ci
npm run build-local .

If everything is setup correctly this will create a symlink from this directory's dist folder to your Foundry systems folder. It will then build this project and the built version will appear in dist. With the symlink in place you can then open Foundry and interact with the system as normal.

TODO