SC - Item Rarity Colors

Overview

SC - Item Rarity Colors adds configurable rarity and spell visuals to D&D 5e.

Instead of relying on plain rarity text, the module can color item sheets, actor inventory rows, and Foundry directory entries so rarity information is readable at a glance. It also supports spell-school styling, including optional school-and-level variants for spell-heavy worlds.

What the module focuses on:

• configurable rarity colors in one place
• gradients and glow effects where supported
• support for the default D&D 5e sheet and tidy5e-sheet
• actor inventory and item directory styling
• a rarity list manager for add, remove, rename, reorder, and visibility
• spell-school color configuration with built-in theme presets
• optional spell level variants
• sync support for custom-dnd5e rarity data
• Tidy 5e rarity color sync from the module settings menu

The main rarity configuration window previews item-sheet, inventory, and sidebar styling live while you edit a selected rarity tier.

Installation

This module is free.

Install it through Foundry with this manifest URL:

https://github.com/Shattered-Codex/sc-item-rarity-colors/releases/latest/download/module.json

After installing:

1. Enable SC - Item Rarity Colors in your world.
2. Open Configure Settings > Module Settings > SC - Item Rarity Colors.
3. Configure rarity colors, spell school colors, or the rarity list as needed.

Compatibility and related modules:

• Foundry VTT v13 and v14
• system: dnd5e
• recommended: lib-wrapper
• optional: tidy5e-sheet
• optional: custom-dnd5e

Settings Hub

The module exposes a central settings area with launchers for the main tools.

The settings hub acts as the entry point for documentation, support, rarity colors, rarity source management, Tidy sync, spell-school colors, and debugging.

From the module settings you can open:

• documentation
• Patreon support
• item rarity configuration
• rarity list configuration
• Tidy rarity sync
• spell school color configuration
• debug logs

The Tidy sync row is only shown when tidy5e-sheet is active.

Item Rarity Themes

The main rarity editor uses a single configuration window with a rarity selector at the top.

You switch rarities from the selector instead of opening separate menus, and the preview updates immediately as colors or toggles change.

For each rarity, the module lets you configure:

• item sheet background color
• secondary gradient color
• gradient enablement
• glow enablement
• item sheet text color
• inventory title and detail colors
• inventory border and gradient styling
• Foundry directory gradient styling
• Foundry directory text color

Practical behavior:

• built-in rarity theme presets can apply a full baseline to the core rarity tiers
• you can still override any field manually after applying a preset
• the form shows an Unsaved changes state until you save
• the preview covers the item sheet, an inventory row, and a directory row at the same time

Rarity List Manager

The rarity list manager controls which rarity keys and labels the module works with.

This manager is not just cosmetic. It defines the merged rarity list the module uses for settings, sheet styling, and system rarity synchronization.

With the rarity list manager you can:

• enable or disable the module-managed rarity list
• rename rarity labels
• add new custom rarities
• remove custom rarities
• reorder entries by drag and drop
• hide rarities without deleting their configuration

When saved, the module merges entries from:

• the module rarity list
• custom-dnd5e, when active
• the system rarity config
• built-in fallback rarities

The resulting merged list is then applied back to CONFIG.DND5E.itemRarity, so the visual layer and the active D&D 5e rarity config stay aligned.

Spell School Colors

Spell visuals are managed in a dedicated spell-school configuration window.

Spell styling can be configured per school or per school-and-level combination, with its own preset system and the same live preview workflow used for item rarities.

Spell-school styling supports:

• per-school themes
• optional level variants
• built-in spell theme presets
• gradients and glow effects
• sheet, inventory, and directory styling for spells
• import and export of spell theme configuration

When level variants are enabled, the module stores distinct profiles for combinations such as:

• Illusion
• Illusion + Level 1
• Illusion + Level 9

That makes it possible to keep a school identity while still increasing visual intensity for higher-level spells.

Where Visuals Apply

The module is designed to color actual play surfaces, not only the settings window.

Actor Inventory

Inventory rows can pick up gradient backgrounds, border treatment, and text colors so high-value items stand out immediately during play.

Foundry Item Directory

The item directory can reflect rarity styling directly in the sidebar, which helps when browsing large lists without opening each item.

Spell Directory and Spell Lists

Spell entries can use school-based color profiles, and level variants can intensify those visuals for higher spell levels.

The module also styles supported item sheets directly:

• the default D&D 5e item sheet
• tidy5e-sheet

Integrations and Sync

Tidy 5e Sheet

The module supports tidy5e-sheet in two ways:

• rarity and spell styling can apply to Tidy item sheets
• the settings menu can sync primary rarity colors into Tidy's world rarity colors

The sync action copies the primary item-sheet rarity color from this module into Tidy 5e's rarity color settings.

That sync is intentionally narrow: it updates Tidy rarity colors, but it does not replace the rest of your SC Item Rarity Colors configuration.

Custom DND5E

When custom-dnd5e is active and its rarity setting exists, the rarity list manager syncs saved entries into custom-dnd5e.item-rarity.

In practice that means:

• the module can reuse custom rarity keys already present in the world
• renamed or newly created rarities can propagate into the Custom DND5E setting
• the merged rarity list can keep D&D 5e rarity config and visual config from drifting apart

Import Export and Debug

Both major styling windows support configuration portability:

• item rarity configuration can be exported and imported
• spell school configuration can be exported and imported

This is useful when you want to:

• move a theme between worlds
• share a preset setup with another GM
• keep a backup before experimenting with a new visual direction

The settings menu also includes a client-side debug toggle that logs rarity-color flow details to the browser console for troubleshooting.

Notes

Important day-to-day behavior:

• settings are stored at world scope, except the debug and support-card visibility options, which are client-side
• built-in presets are starting points, not locked themes
• the rarity list manager can hide entries without deleting them
• spell level variants are optional and can stay disabled if school-only styling is enough
• lib-wrapper is recommended but not required

If you want the quickest setup path:

1. open Configure Rarity Colors
2. apply a rarity preset
3. fine-tune the tiers you care about
4. open Configure Spell School Colors if you want spell visuals too
5. use Configure Rarity List only if your world needs custom rarity keys or labels