2021-06-26 22:02:00 +02:00
|
|
|
<!--
|
|
|
|
SPDX-FileCopyrightText: 2021 Johannes Loher
|
|
|
|
SPDX-FileCopyrightText: 2021 Siegfried Krug
|
|
|
|
|
|
|
|
SPDX-License-Identifier: MIT
|
|
|
|
-->
|
|
|
|
|
2020-12-23 18:48:32 +01:00
|
|
|
# DS4
|
|
|
|
|
2023-06-29 21:53:50 +02:00
|
|
|
[![status-badge](https://ci.f3l.de/api/badges/5/status.svg)](https://ci.f3l.de/repos/5)
|
|
|
|
[![REUSE status](https://api.reuse.software/badge/git.f3l.de/dungeonslayers/ds4)](https://api.reuse.software/info/git.f3l.de/dungeonslayers/ds4)
|
|
|
|
[![Forge installs](https://img.shields.io/badge/dynamic/json?label=Forge%20Installs&query=package.installs&suffix=%25&url=https%3A%2F%2Fforge-vtt.com%2Fapi%2Fbazaar%2Fpackage%2Fds4&colorB=4aa94a)](https://forge-vtt.com/bazaar#package=ds4)
|
|
|
|
[![Supported foundry versions](https://img.shields.io/endpoint?url=https://foundryshields.com/version?url=https%3A%2F%2Fgit.f3l.de%2Fapi%2Fpackages%2Fdungeonslayers%2Fgeneric%2Fds4%2Flatest%2Fsystem.json)](https://git.f3l.de/dungeonslayers/ds4)
|
|
|
|
[![Matrix](https://img.shields.io/matrix/ds4%3Aim.f3l.de?server_fqdn=im.f3l.de&logo=matrix&color=0DBD8B)](https://matrix.to/#/#ds4:im.f3l.de)
|
|
|
|
[![Ko-fi](https://img.shields.io/badge/Ko--fi-ghostfvtt-00B9FE?logo=kofi)](https://ko-fi.com/ghostfvtt)
|
|
|
|
|
2022-01-22 19:19:01 +01:00
|
|
|
An implementation of the [Dungeonslayers] 4 game system for [Foundry Virtual
|
2021-05-23 14:43:52 +02:00
|
|
|
Tabletop].
|
2020-12-23 18:48:32 +01:00
|
|
|
|
2021-01-25 14:16:14 +01:00
|
|
|
This system provides sheet support for Actors and Items and mechanical support
|
|
|
|
for dice and rules necessary to play games of Dungeonslayers 4.
|
2020-12-23 18:48:32 +01:00
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
## Installation
|
2020-12-23 18:48:32 +01:00
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
To install and use the Dungeonslayers 4 system for Foundry Virtual Tabletop,
|
2022-01-22 19:19:01 +01:00
|
|
|
find it in the list in the **Install System** dialog on the Setup menu of the
|
|
|
|
application. Alternatively, paste the following Manifest URL in that dialog:
|
2020-12-23 18:48:32 +01:00
|
|
|
|
2023-06-29 21:53:50 +02:00
|
|
|
https://git.f3l.de/api/packages/dungeonslayers/generic/ds4/latest/system.json
|
2021-01-06 03:22:25 +01:00
|
|
|
|
|
|
|
## Development
|
|
|
|
|
2021-01-25 14:16:14 +01:00
|
|
|
### Prerequisites
|
2021-01-06 03:22:25 +01:00
|
|
|
|
2023-03-23 00:47:54 +01:00
|
|
|
In order to build this system, recent versions of `node` and `pnpm` are
|
|
|
|
required. Most likely using `npm` or `yarn` also works but only `pnpm` is
|
|
|
|
officially supported. We recommend using the latest lts version of `node`. If
|
|
|
|
you use `nvm` to manage your `node` versions, you can simply run
|
2021-02-11 13:57:14 +01:00
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
```
|
|
|
|
nvm install
|
|
|
|
```
|
|
|
|
|
|
|
|
in the project's root directory.
|
|
|
|
|
2021-11-30 17:30:25 +01:00
|
|
|
You also need to install the project's dependencies. To do so, run
|
2020-12-23 18:48:32 +01:00
|
|
|
|
|
|
|
```
|
2023-03-23 00:47:54 +01:00
|
|
|
pnpm install
|
2020-12-23 18:48:32 +01:00
|
|
|
```
|
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
### Building
|
|
|
|
|
|
|
|
You can build the project by running
|
2020-12-23 18:48:32 +01:00
|
|
|
|
|
|
|
```
|
2023-03-23 00:47:54 +01:00
|
|
|
pnpm build
|
2020-12-23 18:48:32 +01:00
|
|
|
```
|
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
Alternatively, you can run
|
|
|
|
|
|
|
|
```
|
2023-03-23 00:47:54 +01:00
|
|
|
pnpm watch
|
2021-01-06 03:22:25 +01:00
|
|
|
```
|
|
|
|
|
|
|
|
to watch for changes and automatically build as necessary.
|
|
|
|
|
|
|
|
### Linking the built system to Foundry VTT
|
|
|
|
|
|
|
|
In order to provide a fluent development experience, it is recommended to link
|
|
|
|
the built system to your local Foundry VTT installation's data folder. In order
|
|
|
|
to do so, first add a file called `foundryconfig.json` to the project root with
|
|
|
|
the following content:
|
2020-12-23 18:48:32 +01:00
|
|
|
|
|
|
|
```
|
|
|
|
{
|
2021-01-06 03:22:25 +01:00
|
|
|
"dataPath": "<path to your home directory>/.local/share/FoundryVTT"
|
2020-12-23 18:48:32 +01:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
On platforms other than Linux you need to adjust the path accordingly.
|
|
|
|
|
2020-12-23 20:33:19 +01:00
|
|
|
Then run
|
|
|
|
|
|
|
|
```
|
2023-03-23 00:47:54 +01:00
|
|
|
pnpm link-package
|
2020-12-23 20:33:19 +01:00
|
|
|
```
|
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
### Running the tests
|
|
|
|
|
|
|
|
You can run the tests with the following command:
|
2020-12-23 18:48:32 +01:00
|
|
|
|
|
|
|
```
|
2023-03-23 00:47:54 +01:00
|
|
|
pnpm test
|
2020-12-23 18:48:32 +01:00
|
|
|
```
|
2020-12-31 05:02:38 +01:00
|
|
|
|
2021-01-06 03:22:25 +01:00
|
|
|
## Contributing
|
|
|
|
|
2023-06-29 21:53:50 +02:00
|
|
|
Code and content contributions are accepted. To report issues, please contact us in [Matrix](https://matrix.to/#/#ds4:im.f3l.de).
|
2021-01-06 03:22:25 +01:00
|
|
|
|
2023-06-30 00:44:33 +02:00
|
|
|
## Licensing
|
2020-12-31 05:02:38 +01:00
|
|
|
|
2021-06-26 22:02:00 +02:00
|
|
|
This project is being developed under the terms of the
|
|
|
|
[LIMITED LICENSE AGREEMENT FOR MODULE DEVELOPMENT] for Foundry Virtual Tabletop.
|
|
|
|
|
2022-01-31 14:17:02 +01:00
|
|
|
The project itself is licensed under multiple licenses. [REUSE] is used to
|
|
|
|
specify the licenses for the individual files. Most of the licenses are
|
|
|
|
specified either inside the source file or by an accompanying `.license` file,
|
|
|
|
but for some files, the licenses are specified in [.reuse/dep5]. Some of the
|
|
|
|
work that is being reused by this project requires attribution to the original
|
|
|
|
author(s). You can find these attributions in [ATTRIBUTION.md](ATTRIBUTION.md).
|
2021-05-23 14:43:52 +02:00
|
|
|
|
2022-01-22 19:19:01 +01:00
|
|
|
[Dungeonslayers]: https://www.dungeonslayers.net/
|
2022-01-31 15:13:32 +01:00
|
|
|
[Foundry Virtual Tabletop]: http://foundryvtt.com/
|
2021-06-26 22:02:00 +02:00
|
|
|
[LIMITED LICENSE AGREEMENT FOR MODULE DEVELOPMENT]: https://foundryvtt.com/article/license/
|
2022-01-31 14:17:02 +01:00
|
|
|
[REUSE]: https://reuse.software/
|
|
|
|
[.reuse/dep5]: .reuse/dep5
|