Skip to content

Latest commit

 

History

History
77 lines (56 loc) · 3.79 KB

README-DEV.md

File metadata and controls

77 lines (56 loc) · 3.79 KB
Raw

Local development environment

General development

The main development workflow uses a build system using npm and gulp with Github pull requests required for changes made. None of this is required for issues, content or translations described above! This process can be involved and should a step fail with errors please search the web first.

Shadowrun5e uses Typescript, npm with gulp and git. Follow these installation manuals:

Afterwards follow these steps using your terminal (cmd.exe on Windows):

There are multiple gulp tasks available to help development:

  • watch => rebuild the system after a change is detected
  • build => rebuild the system once, manually
  • link => See section below

In general the application within FoundryVTT will use what's the build process puts into dist/, while most else isn't needed to function but only to provide sources.

Linking the dev and system folder

It's helpful, but not strictly necessary, to place your development folder separate from the FoundryVTT system folder as a system update will overwrite your development folder otherwise. This can be done with linking the two.

For the gulp link command to work, you need to include the following file as foundryconfig.json directly underneath your development shadowrun5e system directory. { "dataPath": "C:\\Users\\<addYourUserHere>\\AppData\\Local\\FoundryVTT\\", "linkTargetDirName": "shadowrun5e" }

Afterwards open a terminal (cmd.exe on Windows) with administrative permissions (see here for help):

  • cd <the_cloned_fork_directory>
  • gulp link (should this fail, remove the existing shadowrun5e system or check for administrative permissions)

You should see a success message and a little arrow symbol on the shadowrun5e folder within the FoundryVTT Data/systems directory. Now you can use the Gulp watch-Task as described above. This needs to be repeated after each Shadowrun5eVTT system update.

Linux and docker workflow changes

On Linux you can use docker (or another container runtime like podman) to quickly setup a local instance of foundry:

This will use docker-compose (or podman-compose) to manage the containers.

It requires some manual setup to make the foundryvtt.zip avaiable for installation:

  1. Create a data and a data/cache directory - this will host all files of the installation: mkdir -p data/cache
  2. Download the desired version of foundry from your account as zip and place it inside the data/cache folder (this version has to match the version of the container-image in docker-compose.yml):
wget -O data/cache/foundryvtt-$SOME_VERSION.zip $URL_TO_DOWNLOAD_LINK
  1. Spin up foundryvtt using docker-compose:
# This command must be run inside the root directory of this repository
# It will automatically symlink this system into data/Data/systems
docker-compose up

Now an instance of foundryvtt will be running on http://localhost:30000

If you need to restart the instance:

docker-compose down
docker-compose up