SC - Simple Sockets

Overview

SC - Simple Sockets lets you create gem items and socket them into compatible items.

The core loop is simple: build gems, decide what they add, and drop them into compatible items to create upgrades, utility effects, or more specialized gear.

Installation

This module is free.

1. Open Add-on Modules in Foundry VTT.
2. Click Install Module.
3. Paste this manifest URL:

https://github.com/Shattered-Codex/sc-simple-sockets/releases/latest/download/module.json

4. Install the module and enable it in your world.

Useful links:

• Foundry package page

Module Settings

All settings live under Configure Settings > Module Settings > SC - Simple Sockets.

Main module settings, where gem rules and socket behavior are configured.

Gem Item Definition

By default, the module treats loot items with subtype gem as valid gems.

Default setup:

• Gem Loot Subtypes: gem
• Custom Loot Subtypes: no additional gem subtypes configured

Use Gem Loot Subtypes to define which standard loot subtypes count as gems.

Default loot subtypes that the module treats as gems.

Use Custom Loot Subtypes if your world needs extra gem families beyond the default subtype.

Custom subtype support lets you define additional gem families beyond the default setup.

Socketable Item Types

This setting defines which item types can receive sockets.

Default setup:

• Socketable Item Types: weapon, equipment

You can enable other types if your world needs them.

At the module level, choose which item types can receive sockets, such as weapons, equipment, or spells.

Other Important Defaults

A few defaults matter right away:

• Edit Socket Permission: Gamemaster
• Maximum Number of Sockets per Item: 6
• Delete Gem on Removal: false by default, so removed gems return to inventory
• Gem damage layout in roll dialog: true by default, so extra gem damage is grouped by gem in the roll dialog

What these do:

• Edit Socket Permission controls who can add or remove sockets. GMs bypass this check.
• Maximum Number of Sockets per Item limits how many slots an item can have. Use -1 for unlimited.
• Delete Gem on Removal decides whether removing a gem destroys it or sends it back to the actor's inventory.
• Gem damage layout in roll dialog changes the damage roll UI so gem-based damage is shown as its own grouped entry.

Creating a Gem

Create a gem item first.

If you are using the default module settings, the standard starting point is:

• item type: loot
• subtype: gem

A gem can contain:

• Activities
• Active Effects
• +details data, including extra damage configuration

Use the Activities tab when the gem should add actions or abilities to the host item.

Use Active Effects when the gem should apply bonuses, modifiers, or automated rules.

Use the +details tab when the gem needs extra damage or other combat-specific configuration.

You can also restrict a gem so it only works on certain item types.

At the gem level, you can restrict which item types are allowed to receive that specific gem.

Socketing a Gem

Once the settings and gem are ready, the rest is quick:

1. Open a compatible item.
2. Go to the Sockets tab.
3. Add one or more empty sockets.
4. Drag the gem into an empty socket.

After socketing:

• the gem is consumed from inventory
• Active Effects are applied to the host item
• Activities are mirrored to the host item
• the item gains the gem's extra behavior

The socketed gem appears directly inside the host item's sockets tab.

If the gem adds extra damage through +details, the result also appears in the roll dialog.

Result in play: the socketed gem contributes extra damage directly to the roll dialog.

SC More Gems

If you want ready-made content instead of building every gem manually, SC - More Gems is an optional follow-up.

It already includes a large ready-to-import gem library and is the fastest way to expand your world without authoring every entry yourself.