Johannes Loher
8ba05f55f9
Add configuration to directly inject the ddv config into the token config See merge request ghost/darkness-dependent-vision!1 |
||
---|---|---|
.husky | ||
.reuse | ||
.vscode | ||
.yarn | ||
img | ||
LICENSES | ||
src | ||
.editorconfig | ||
.eslintignore | ||
.eslintrc.js | ||
.gitignore | ||
.gitlab-ci.yml | ||
.nvmrc | ||
.nvmrc.license | ||
.prettierignore | ||
.prettierrc.js | ||
.yarnrc.yml | ||
gulpfile.js | ||
LICENSE.md | ||
package.json | ||
package.json.license | ||
README.md | ||
rollup.config.js | ||
yarn.lock | ||
yarn.lock.license |
Darkness Dependent Vision
A module for Foundry Virtual Tabletop that provides functionality to make the dim and bright vision of tokens depend on the scene's darkness level.
Installation
To install and use the Darkness Dependent Vision module for Foundry Virtual Tabletop, simply paste the following URL into the Install Module dialog on the Setup menu of the application.
https://git.f3l.de/ghost/darkness-dependent-vision/-/raw/latest/src/module.json?inline=false
libWrapper
This module uses the libWrapper library for wrapping core methods. It is only a soft dependency (a shim is provided) but it is highly recommended to install libWrapper as a module for the best experience and compatibility with other modules.
Usage
In order to configure the darkness range in which a token has dim and bright vision, a dialog is provided that can be accessed from a header button in the Token Configuration:
In the next image, you can see an example of the module in action: The token is configured to only have bright vision at a darkness level between 0 and 0.5 but the scene's darkness level is set to 0.6, so the token has no bright vision. On the other hand, the token is also configured to have dim vision at a darkness level between 0 and 0.7, so it does have dim vision.
Development
Prerequisites
In order to build this module, recent versions of node
and yarn
are
required. Most likely using npm
also works but only yarn
is officially
supported. We recommend using the latest lts version of node
, which is
v14.17.1
at the time of writing. If you use nvm
to manage your node
versions, you can simply run
nvm install
in the project's root directory.
You also need to install the the project's dependencies. To do so, run
yarn install
Building
You can build the project by running
yarn build
Alternatively, you can run
yarn build:watch
to watch for changes and automatically build as necessary.
Linking the built project to Foundry VTT
In order to provide a fluent development experience, it is recommended to link
the built module 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:
{
"dataPath": "/absolute/path/to/your/FoundryVTT/Data"
}
(if you are using Windows, make sure to use \
as a path separator instead of
/
)
Then run
yarn link-project
On Windows, creating symlinks requires administrator privileges so unfortunately you need to run the above command in an administrator terminal for it to work.
Licensing
This project is being developed under the terms of the LIMITED LICENSE AGREEMENT FOR MODULE DEVELOPMENT for Foundry Virtual Tabletop.
The project itself is licensed under multiple licenses. It is difficult to keep this section up to date, so here is a brief summary as of June 2021:
- The images in img are licensed under CC BY 4.0.
- The files in .yarn by the Yarn Contributors are licensed under BSD-2-Clause.
- Other files are licensed under MIT.
For more accurate information, check the individual files.