Shattered Codex

Wiki

Modules/SC - Setforge

SC - Setforge

Foundry v13+System D&D 5ePremium

SC - Setforge

Overview

SC - Setforge adds a full item set workflow for D&D 5e.

You define which items belong to a set, decide how many equipped pieces unlock each tier, and attach Activities or Active Effects that are granted automatically when actors meet those requirements.

In practice, the workflow revolves around four connected pieces:

  • a set configuration app for defining sets
  • a powers library for Activities and Active Effects
  • tier progression based on equipped piece counts
  • runtime sync that grants and removes bonuses automatically

Installation

This module is premium.

Install access is handled through the Shattered Codex Download Hub.

See How to Download Premium Modules from the Download Hub for the full access and installation flow.

Module Settings

Setforge exposes several world settings and launchers under Configure Settings > Module Settings > SC - Setforge.

Setforge module settings

The settings panel controls the main configuration app, allowed item types, notification channels, and how set information appears on sheets.

The settings you will likely touch first are:

  • Configure Sets opens the main set editor
  • Configure Item Types controls which item types can be dropped into Set Items
  • Configure Notifications defines where activation messages are sent
  • Show Set Membership on Character Sheet adds a Part of <set> label on supported sheet views
  • Show Set Overview Action on Character Sheet adds a quick action to open the overview from item rows
  • Set Overview Item Card Style changes the visual style of cards in the overview window
  • Allow Clicking Unavailable Set Pieces controls whether missing pieces can still be opened from the item tab
  • Show Setforge Storage Folders reveals the module's internal storage folders if you need to inspect them manually

Allowed item types are managed in their own dialog.

Allowed set item types

If an item cannot be dropped into a set, this setting is one of the first things to check.

Default allowed types:

  • equipment
  • loot
  • tool
  • weapon

Create and Configure Sets

The main authoring workflow lives in Setforge Configuration.

Set configuration overview

The main editor combines set metadata, item membership, a powers library, and progression tiers in one place.

Typical setup flow:

  1. Open Setforge Configuration.
  2. Click Add Set.
  3. Give the set a name, rarity, description, and optional image.
  4. Drag matching items into Set Items.
  5. Add Activities and Active Effects to the Powers Library.
  6. Save the configuration.

Each set can include:

  • a name
  • rarity
  • description
  • optional set image
  • set items
  • reusable powers
  • one or more activation tiers

The left column stores your set list. The central column handles metadata, set items, and powers. The right column is where progression tiers are configured.

Build Tier Progression

Setforge uses equipped piece count as the unlock condition for each tier.

Tier progression editor

Each tier defines how many equipped pieces are required and which powers are granted when that threshold is reached.

For each tier, you can configure:

  • required number of equipped pieces
  • optional tier description
  • powers assigned to that tier

A few workflow details matter while building tiers:

  • tiers can be reordered
  • powers are assigned by dragging from the library into the tier
  • the module warns when tier piece counts are not increasing correctly
  • tiers that require more pieces than the set contains cannot activate

A simple example:

  • Tier 1: 2 pieces equipped
  • Tier 2: 3 pieces equipped
  • Tier 3: 4 pieces equipped

When the actor equips enough matching items, Setforge resolves which tiers are unlocked and grants the configured Activities and Active Effects for those tiers.

What Players See

Setforge surfaces set information in a few different places, so players do not have to guess what a piece belongs to or what the next threshold does.

Set Overview Window

Set overview window

The overview window shows the full set in one place and is the clearest way to explain the progression to players.

The overview window displays:

  • set name and rarity
  • number of set items
  • activation range
  • total configured powers
  • item list
  • tier progression and granted powers

The GM can also use Show to Players to push that overview to active players.

Item Sheet Set Tab

If an item belongs to a configured set, its item sheet can show a dedicated Set tab.

Item sheet Set tab

On the item sheet, the Set tab keeps the context close to the item itself. When the item is opened from an actor, it can also show equipped progress.

That tab can show:

  • the set name and rarity
  • set description
  • all set pieces
  • equipped piece progress
  • progression tiers

If you open the item from outside actor context, the module can only show the static set data. Equipped-piece progress is available when the item is opened from an actor.

Actor Sheet Indicators

If the relevant settings are enabled, actor sheets can also show:

  • a subtitle label such as Part of <set name>
  • an action button that opens the set overview directly from the item row

This makes set pieces easier to recognize during normal inventory use, without forcing players to open the full overview every time.