Skip to content
/ datasworn Public

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

Notifications You must be signed in to change notification settings

rsek/datasworn

Repository files navigation

Datasworn v0.0.10

@datasworn/core on npm @datasworn/core on npm Official Ironsworn Discord server Visit the r/Ironsworn subreddit

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.

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.

About

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

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published