SC - Simple Sockets

Features

• Native sheet integration – adds a first-class Sockets tab to the dnd5e item sheet and supports both Foundry VTT core and Application V2 layouts.
• Drag-and-drop socketing – drop gem items directly into slots; invalid drops raise concise notifications.
• Automatic effect transfer – gem active effects are moved onto the host item and marked for easy cleanup when the gem is removed.
• Activity mirroring – gem activities (including uses) are cloned to the host item, so players can trigger gem powers without opening the gem document.
• Per-gem targeting rules – restrict each gem to specific weapon or equipment subtypes so players only see valid sockets.
• Visual indicators – actor inventory lists show socket badges for equipped items, and item activity cards gain gem markers to show their source.
• Inventory-aware workflow – gems are consumed or returned from the owning actor automatically, keeping quantities accurate.
• Tidy5e Sheet styling – bundled CSS keeps the sockets list attractive and readable on the Tidy5e inventory layout.

Module Settings

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

• Edit Socket Permission – minimum Foundry role required to add or remove sockets. GMs bypass this check.
• Maximum Number of Sockets per Item – world-wide cap; set to -1 for unlimited slots.
• Delete Gem on Removal – toggle whether removing a gem destroys it or sends it back to the actor's inventory.
• Configure Gem Loot Subtypes – opens a management dialog where you choose which loot subtypes count as gems and define custom entries. Custom subtypes are added to the dnd5e loot type dropdown automatically.

Installation

1. In Foundry's Add-on Modules > Install Module dialog, paste the manifest URL  
   `https://github.com/Shattered-Codex/sc-simple-sockets/releases/latest/download/module.json`
2. Install, then enable SC - Simple Sockets in your World's module list.
3. (Optional) Install and activate libWrapper for safer compatibility with other modules.

Quick Start

1. Prepare a host item – open a weapon or equipment item sheet and switch to the new Sockets tab.
2. Add slots – use the `Add` control to create one or more empty sockets (respecting the world limit).
3. Create or import gems – gems are loot-type items whose subtype is set to `gem`. Start with the sample items in the `SC - Gems` compendium or build your own.
4. Socket a gem – drag a gem from an actor sheet, compendium, or sidebar into an empty slot. The gem is consumed from inventory, its active effects are enabled on the host, and any activities are cloned onto the item.
5. Unsocket when needed – remove a gem via the slot controls. By default the gem returns to the actor's inventory; enable the *Delete Gem on Removal* setting to destroy it instead. Hold `Shift` to bypass the confirmation prompt.

Creating Custom Gems

1. Create a new Loot item and set the subtype to gem (or any subtype you flagged as a gem in the settings dialog).
2. Add Active Effects you want to activate when the gem is socketed. The module keeps them disabled on the gem itself and toggles them on for the host item.
3. (Optional) Add Activities (e.g., strikes, save DCs, resource uses). Simple Sockets extends loot items so these are preserved and copied to the host when socketed.
4. Open the Allowed Item Types control on the gem sheet and pick which weapon/equipment subtypes can accept it. Leave the default All Types to allow every socket.
5. Distribute gems via the SC - Gems compendium or your own collections.

If a gem temporarily loses its gem subtype, the module stashes its effects and activities so you do not lose any work.

1. Navigate to Configure Settings > Module Settings > SC - Simple Sockets and click Configure Gem Loot Subtypes.
2. Select the loot subtypes from the left list that should be treated as gems when socketed.
3. Add custom subtype keys and labels as needed; the module registers them with CONFIG.DND5E.lootTypes, so they appear in item sheets and can be localized.
4. Save your changes. Items with any chosen subtype are now considered socket-compatible, preserving all active effects and activities just like the default gem subtype.

Tip: The Allowed Item Types picker on each gem respects these subtypes, letting you combine high-level gem categories with per-gem socket restrictions.