Skip to content

ben/foundry-ironsworn

Repository files navigation

Ironsworn and Starforged for Foundry VTT

Download count of latest release Forge Installs

This is a Foundry VTT implementation of the Ironsworn, Ironsworn: Delve, Ironsworn: Starforged, and Sundered Isles games by Shawn Tomkin.

To install it, just search for "ironsworn" in the system-installation UI, or use this URL:

https://github.com/ben/foundry-ironsworn/releases/latest/download/system.json

For information on how to play a game, check out the wiki.

System Development

Important

Currently you must have Datasworn checked out to the v0.1.0 branch in the same directory as this repo in order for the build to succeed. I don't like it either, and as soon as there's an NPM release, I'll fix it and remove this note.

Here's what you'll need to make changes to this system:

  1. Install Foundry 11 or later, and start it up.
  2. Install the main foundry-ironsworn system, and create a world that uses it.
  3. Clone this repo somewhere you can find it, and run npm install.
  4. Run npm start from this repository.
  5. Open a browser to http://localhost:8080.

When you use that browser window, Vite will serve up freshly-built assets instead of the ones in the installed version of the system, and will do browser-window refreshes for you in many cases. Some things to remember:

  • Only the Javascript and stylesheets are served up by Vite. If you change anything else (like a .hbs file), you'll want to do something like this before reloading:
    cp -R system/* ~/Library/Application\ Support/FoundryVTT/Data/systems/foundry-ironsworn/
    
  • If you make a change to system.json or any of the I18n files, you'll have to return to setup, use the command above, and start the world up again.
  • Vue Inspector is configured, so tap alt+shift (cmd+shift on Mac) and click on a Vue element to open the relevant file in VS Code.

Credits

This work is based on several works created by Shawn Tomkin, and are licensed under the CC-BY-NC-SA license, as detailed at https://tomkinpress.com/pages/licensing.

Data courtesy of Datasworn, which is used here under its MIT license.

Hand-drawn map scene courtesy of McSekcer.

Starforged scenes courtesy of Unsplash, and used under their license.

Ocean scenes courtesy of @AuguestBebel (#993).

Extra location icons courtesy of Eric Rains and Kirin.