randomeizer / datasworn

The successor to the original Datasworn repository and Dataforged package, which provide game rules from the Ironsworn and Ironsworn: Starforged TTRPGs in JSON.

Datasworn v0.0.8

What is this?

This is a pre-release of the successor to the original Datasworn repository and Dataforged package, which provided game rules from the Ironsworn and Ironsworn: Starforged in JSON.

Until it reaches v1.0, it may receive breaking changes on any version change.

If you're looking for the original Datasworn JSON files, they are available on the legacy branch.

Why a new version?

Some of the design goals for the new standard:

• provide a format that accomodates both classic Ironsworn and Ironsworn: Starforged
• language-agnostic JSON schema as the "source of truth", rather than a JSON schema generated from Typescript typings
• provide type information for languages other than Typescript
• provide an interchange format that better accomodates homebrew/3rd party content, so it can be imported to any project that relies on the format
• provide a format friendlier to localization
• a format and codebase that are less messy, more consistent, and easier to maintain

Usage

Javascript and Typescript

Datasworn spans several NodeJS packages available via npm.

• @datasworn/core: Contains the Typescript typings and the JSON schema, on which all other Datasworn packages depend.
• @datasworn/ironsworn-classic: Contains JSON data from the original Ironsworn rulebook.
• @datasworn/ironsworn-classic-delve: Contains JSON data from Ironsworn: Delve, an expansion to the Ironsworn rulebook.
• @datasworn/starforged: Contains JSON data from Ironsworn: Starforged, and a number of SVG icons and WEBP planet images.

Other languages

Typings for C# (System.Text), Go, Java (Jackson), Python, Ruby, and Rust are available in the json-typedef directory.

These are automatically generated from a JSON TypeDef schema. For the data itself, see below.

JSON

The JSON schema and JSON data are available in the datasworn directory.

Licensing

Core package content (the typings and JSON schema) and internal tooling use the MIT license.

Textual and image content (in other words, the actual content from the rulebooks as described in JSON, Markdown, and other files) is CC-BY-4.0 or CC-BY-NC-4.0.

Additionally, the JSON files embed licensing information in the source property that appears on many objects throughout Datasworn.

Contributors

The previous versions of Datasworn and Dataforged began as unofficial personal projects of rsek, who now maintains Datasworn in an official capacity.

Special thanks to XenotropicDev for allowing me to use data from TheOracle (a Discord bot for use with Ironsworn and Starforged) as the nucleus of the original.