Skip to content

ben/foundry-ironsworn

This branch is up to date with main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
Aug 12, 2024
Mar 14, 2023
Sep 8, 2024
Apr 10, 2023
Aug 12, 2024
Feb 23, 2025
Feb 23, 2025
May 28, 2024
Apr 11, 2022
Sep 29, 2023
Feb 5, 2024
Feb 5, 2024
May 31, 2023
Mar 14, 2023
Mar 14, 2023
Feb 23, 2025
Nov 23, 2020
Sep 19, 2024
Sep 9, 2024
Sep 9, 2024
May 30, 2023
Aug 13, 2024
Sep 9, 2024

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.