Datasworn

repository·main·Indexed 41 days ago

https://github.com/rsek/datasworn

A set of traversal utilities, JSON schemas, and TypeScript declarations for interacting with structured game data for Ironsworn and Starforged. It provides the DataswornTree for centralizing data and the IdParser for type-safe lookups of game items using hierarchical IDs.

Tokens
101.9K
Snippets
134
Records
267
Agent score
50%

What's inside Datasworn

  1. Understand how Impacts affect Momentum

    main

    Impacts represent temporary, long-term, or permanent disadvantages. They affect your character's Momentum in two ways:

    1. Max Momentum Reduction: Each marked impact reduces your maximum momentum (normally 10) by 1.
    2. Momentum Reset Reduction: Impacts reduce the amount of momentum you regain during a reset:
      • 1 marked impact: Momentum reset is +1 (instead of +2).
      • >1 marked impact: Momentum reset is 0 (instead of +2).

    Moves in the game will instruct you when to mark an impact, or may offer an option to mark an impact to avoid a greater danger.

  2. Understand how Moves work in Starforged

    main

    In the context of Starforged, Moves are self-contained systems used to resolve actions, scenes, or questions, particularly during uncertain or risky situations.

    Key principles for using Moves:

    • Focus: Moves are centered on players and protagonists. Other characters do not make moves.
    • Triggering: When an action or situation falls within the scope of a move, you must refer to that specific move and follow its instructions.
    • Narrative Context: Moves are always preceded and followed by fiction (the imagined narrative). You should always envision the situation that triggers the move and the narrative changes that result from it.
    • Terminology: If a move's name is underlined, it is being referenced by another move. For specific terms used within moves, refer to the project glossary.
  3. Understand the Equipment and Supply Meter concept

    main

    In Datasworn, equipment is managed through an abstract representation called a supply meter, which tracks your overall readiness. Instead of tracking every individual item, you are assumed to be armed, armored, and equipped as appropriate for your character.

    Use the supply meter to represent your general preparedness. You should note equipment at whatever level of detail suits your playstyle, focusing on how gear enables specific moves or helps avoid risky actions. If you need to verify if you possess a specific helpful item, use the Check Your Gear move.

  4. How Legacy Tracks work

    main
    Legacy tracks are special progress tracks used to track character advancement through quests, bonds, and discoveries. Unlike standard progress tracks, legacy tracks do not have a rank. They consist of boxes that are filled using ticks; it takes four ticks to fill one box. Boxes must be filled from left to right. If you have a partially filled box and receive a reward in boxes, convert the reward to ticks (e.g., 2 boxes = 8 ticks) and fill the incomplete box first.
  5. How Location Themes work in Starforged

    main

    Location Themes are used to envision the atmosphere, features, and encounters within an unusual or important location. Each theme provides three specific types of oracles:

    • Feature: Reveals a new aspect of the location.
    • Peril: Envisions a complication or hazard.
    • Opportunity: Envisions a beneficial encounter or event (e.g., when rolling a strong hit with a match).

    You can use a single theme to answer questions about a place (like an Infested cave) or combine a theme with other location oracles (like a Haunted Grave World) using oracle array techniques to determine which table to reference.

  6. Use Core Oracles for Descriptor and Focus prompts

    main

    When using the Ask the Oracle move to define the nature of a location, discovery, or encounter, roll for both a Descriptor and a Focus. Combining these results provides an adjective/noun prompt.

    Example: Rolling a Descriptor of 6 (Ancient) and a Focus of 67 (Relic) results in the prompt "Ancient Relic".

    Descriptor Roll | Focus Roll
    ----------------|-----------
    6 (Ancient)     | 67 (Relic)
  7. Use the Sacrifice Resources suffer move

    main

    When losing or consuming resources, use Sacrifice Resources.

    Costs:

    • Minor loss: -1 supply
    • Serious loss: -2 supply
    • Major loss: -3 supply

    Note: If supply is exhausted (0), mark unprepared. When suffering resource loss while unprepared, envision the hardship and apply the cost to a different suffer move.

  8. Understand and use Progress Tracks

    main

    A progress track is a mechanism used to measure headway against goals or obstacles such as quests, expeditions, connections, and fights.

    Progress tracks consist of a row of ten boxes that are marked (filled in) as progress is made. When initializing a progress track, you must assign it a rank which determines the severity of the challenge.

    The available ranks, in increasing order of severity, are:

    • troublesome
    • dangerous
    • formidable
    • extreme
    • epic
  9. Manage shared Supply for Allies

    main

    When playing with allies, the group shares a single Supply value. Any changes to this value are synchronized across all allies:

    • Increases: When any ally makes a move to increase supply.
    • Decreases: When any ally suffers an outcome that forces them to Sacrifice Resources.

    Allies must adjust their individual supply meters to match the shared value whenever these changes occur.

  10. How session moves work in Starforged

    main
    Session moves are meta-mechanics used by players (rather than characters) to moderate and facilitate safe, enjoyable play in solo, co-op, or guided modes. They are used to set content boundaries, adjust the story mid-play, and manage the start and end of play sessions. These moves allow players to manage 'flagged content'—topics that require mindfulness or adjustment for comfort.
  11. Identify vehicle categories in Datasworn

    main

    Vehicles in the system are categorized into three distinct types, each with different rules regarding ownership, usage, and integrity management:

    1. Command Vehicle: Your primary asset (e.g., a STARSHIP) earned at character creation. This is a shared asset if playing in a group. It features an integrity meter and can suffer from battered or cursed impacts.
    2. Support Vehicles: Secondary assets that can be carried and launched by your Command Vehicle. They feature an integrity meter and can suffer from the battered impact.
    3. Incidental Vehicles: Temporary vehicles acquired during a story. They feature an integrity meter but cannot be marked as battered.