Feature Manager

Feature Manager

← Wiki home

Feature Manager is the module's master on/off switch — one place to disable whole SDX features without editing world data.

---

Where to find it

Configure Settings (gear) → Shadowdark Extras → Feature Manager — button label Configure Features (GM only, reload required).

The window title is Feature Manager (featureManagerMenu · FeatureManagerApp).

If a tray tab, settings menu, or automation you expect is missing, open Feature Manager first — the feature is likely disabled there, not broken.

---

How to use it

1. Open Configure Settings and scroll to Shadowdark Extras.
2. Click Feature Manager (Configure Features).
3. Leave the defaults enabled, or uncheck a tray tab or tool your table doesn't use.
4. Leave Advanced & Hidden Features enabled unless you mean to turn off underlying automation — it has no tray button of its own.
5. Click Save Feature Settings.
6. Reload when the banner asks you to — Foundry shows Reload required after you save.
7. Verify the tray tab, menu, or sheet control is gone (re-check it and reload to restore).

---

What it controls

The top line is a master card:

Card	What it hides when off
SDX Tray — Left side of the Foundry canvas	The entire tray, its tabs, and all handle tools

Below that, two visible groups map directly to tray controls you can see:

SDX Tray Tabs

Choice	Location	What it hides when off
Scenes	SDX Tray → Scenes tab	ToM scenes, player view, navigation, arena editor, and video overlays
Party	SDX Tray → Party tab	Roster, health cards, travel, camping, weather, and stat sync
Pins	SDX Tray → Pins tab, Add Pin, and Pin List	Pin list, placement, canvas rendering, folders, and styles
Notes	SDX Tray → Notes tab	Notes on tiles, walls, lights, sounds, and tokens
Hexes	SDX Tray → Hexes tab	Hex tile, symbol, custom tile, POI, and terrain painting
Dungeons	SDX Tray → Dungeons tab	Dungeon painting, generation, biomes, levels, and tile flatten
Decor	SDX Tray → Decor tab	Decor assets and POI transforms (needs Hexes)

SDX Tray Tools

Choice	Location	What it hides when off
Marching Mode	Tray handle → Crown and walking buttons	Party leader and marching movement
Formation Spawner	Tray handle → Formation button	Grid placement and canvas spawn
Light Source Tracker	Tray handle → Fire button	Active lights, durations, and controls
Carousing	Tray handle → Carousing button	Downtime rolls, outcomes, renown, wealth, and log
Drawing Tools	Tray handle → Pencil button	Shapes, stamps, and timed erase
Map Generators	Tray handle → Map button	Watabou generators and scene import
Toggle Coordinates	Tray handle → Globe button	Hex coordinate overlay
Hex Tooltip / Hexplorer	Tray handle → Information button	Hover terrain, settlements, and dungeons
Hex Fog	Tray handle → Fog button	Per-hex fog and fog effects
Solo Hex Mode	Tray handle → Compass button	Wilderness hex generation while exploring
SDX Roller	Tray handle → Dice button	Cinematic rolls, group checks, and recap cards

Each choice shows a preview image, a short description, and where it lives on the tray.

Advanced & Hidden Features

A collapsed section at the bottom. It groups automation that has no tray tab of its own. Each subsection below is a separate card inside Advanced & Hidden Features — use its Enable all / Disable all to toggle the group, or individual checkboxes to keep the hooks you need.

Tray & Canvas

Canvas helpers that don't have a tray button of their own.

Toggle	What it hides when off
Token Toolbar	Quick canvas controls for effects and equipped items
Wall Context Menu	Extra right-click actions for walls

Combat

Combat automation and display. All seven are independent (no dependencies).

Toggle	What it hides when off
Enhanced Damage Cards	Targeting, range checks, multipliers, and damage application
Scrolling Combat Text	Floating damage and healing numbers above tokens
Weapon Bonuses	Hit, damage, critical, on-hit, and item-macro weapon bonuses
Focus Spell Tracker	Focus checks, duration tracking, and effect cleanup
Medkit	Actor and world spell-enhancement scans
Freya's Omen	Omen reroll handling on spell cards
Crawl Helper Death Timer	Death-timer integration with SD Crawler Helper

Animation

Sequencer / TokenMagic / Automated Animations. One dependency: per-item overrides need Animation FX.

Toggle	What it hides when off
Animation FX	Regex-matched Sequencer animation presets and playback
Per-Item Animation Overrides	Item-level Animation FX configuration on activity and weapon sheets — also blocked when Animation FX is disabled
Torch Animations	Persistent torch prop and flame animations on tokens
Level-Up Animations	Level-up arrows and token celebration effects
Weapon & Shield Sprites	Equipped weapon and shield sprites rendered on tokens
TokenMagic Filter Editor	Edit TokenMagic filter parameters used by effects and presets
Automated Animations Integration	Coordinate SDX animation playback with Automated Animations

Character Sheets

Player and NPC sheet enhancements — 12 toggles, all independent.

Toggle	What it hides when off
Enhanced Header	HP, AC, abilities, luck, XP, and custom header backgrounds
HP Wave Animation	Animated portrait waves based on current HP
Quick Conditions	Condition controls on player and NPC sheets
Character Journal Notes	Multi-page journal notes on player sheets
Add Coins Button	Quick coin adjustment controls on character and party sheets
Sheet Locking	Prevent players from editing configured sheet fields
Sheet Styling & Dark Mode	Sheet frames, panels, colors, backgrounds, and themes
Background Sheet & Advancement	Enhanced background sheets and advancement grants
Skills Box	Skills display on character sheets
Spellbook Filter	Alignment-based spellbook filtering
Enhanced Sheet Tabs	Enhanced details, abilities, talents, inventory, spells, and effects tabs
Character Generator	Character-generation helpers and chat roll integration

Inventory

Containers, trading, and display — 9 toggles, all independent.

Toggle	What it hides when off
Ammunition per User	Select, apply bonuses from, and consume actor ammunition
Container System	Nested storage, coin storage, and container slot calculations
Trading System	Player trading windows, socket prompts, transfers, and journal
Unidentified Items	Mask unidentified item identity and preserve its flags
Multi-Select & Bulk Delete	Select and modify multiple inventory rows
Inventory Styling	Theme inventory rows by type, magic, rarity, and custom CSS
Gem Enhancements	Gem bag, quantity, and value enhancements
Item Piles Compatibility	Keep SDX item state safe when Item Piles moves or displays items
Player Transfers	Actor-to-actor and party inventory transfers

Effects & Spells

Core spell/effect automation. Three toggles depend on the Spell Activity System.

Toggle	What it hides when off
Spell Activity System	Spell damage, healing, targeting, duration, summoning, item-give, and alignment fields
Damage Type System	Resistance, immunity, and vulnerability processing by damage type
Predefined Effects Library	SDX effect definitions, configuration controls, and condition data
Template Effects	Apply effects when tokens enter or take turns in templates — also blocked when Spell Activity System is disabled
Auras	Persistent aura regions, turn triggers, LOS, Sequencer, and TokenMagic — also blocked when Spell Activity System is disabled
Break on Damage	Expire configured effects when their bearer takes damage
Casting Blockers	Prevent casting under configured active-effect conditions
Invisibility	Synchronize invisibility effects with token visibility
Effect Source Requirements	Enable or suppress effects based on source item state

NPCs

NPC sheet and casting helpers — 4 toggles, all independent.

Toggle	What it hides when off
NPC Inventory	Inventory and coin management on NPC sheets
NPC Creature Types	Creature type assignment and targeting support
Mysterious Casting	Hide configured NPC spellcasting details
NPC Item Sheets	Dedicated NPC attack, special attack, and feature sheets

Journal & Reference

ProseMirror enrichers and journal helpers — 4 toggles, all independent.

Toggle	What it hides when off
Display Cards	NPC, item, and RollTable ProseMirror enrichers
Easy Reference Menu	ProseMirror menu for cards, checks, and dice references
Journal Narration	Send selected journal content to chat narration cards
Icon Picker	Icon selection app used by pins and placeable notes

Item Automation

Item and spell sheet automation — one dependency: spell config panels need the Spell Activity System.

Toggle	What it hides when off
Item Macro Engine	Execute item, effect, spell, weapon, class, and NPC feature macros
Potion, Scroll, Wand & Staff Enhancements	Enhanced magic-item sheets, wand charges, and staff spell management
Spell Configuration Panels	Per-spell damage, targeting, summoning, and item-give controls — also blocked when Spell Activity System is disabled

Leave these enabled unless you intend to turn off that underlying behavior. See Settings Reference for what each hidden key stores.

---

Options that change the path

• Enable All / Disable All — global buttons at the top, and per-group Enable all / Disable all next to each heading, set every checkbox in that scope in one click.
• Partial / indeterminate — a tray choice can be partially disabled (for example Dungeons bundles two features; Scenes bundles five). The checkbox shows an indeterminate state and the card reads Some parts are currently disabled.
• Blocked by dependency — some features need a parent. Decor needs Hexes; per-item animation overrides need Animation FX; template effects, auras, and spell config panels need the Spell Activity System. Disabling the parent disables the child and the card shows Also blocked because … is disabled. — the child checkbox stays off until the parent is back.
• Collapsed automation — Advanced rows have no preview image and no tray location; they hide sheets, hooks, libWrapper patches, and sockets rather than a button.

---

GM and player differences

Only a GM sees Feature Manager (restricted: true). Disabling a feature removes it for everyone in the world — a player can't work around it by flipping a client setting.

---

If something disappears

• A tray tab or tool is missing — open Feature Manager and re-check it. A single unchecked box (or its parent) explains most missing tabs.
• A settings menu is gone — the menu is gated by its feature. Re-enable the feature group it belongs to and reload.
• Nothing changed after saving — reload. disabledFeatures has requiresReload: true; hooks, sheets, and tray modes attach at startup.
• Decor disappeared but Hexes still works — expected. Decor depends on Hexes; re-enable Hexes and Decor together.
• I want everything back — click Enable All at the top, save, and reload. The stored value is disabledFeatures (Array, default []); [] means nothing disabled.

---

Technical detail

Storage, scope, and reload

• Setting key disabledFeatures — World, config: false (hidden), type: Array, default [], requiresReload: true. No direct toggle lives in Configure Settings — only this editor writes it.
• Menu key featureManagerMenu — name: Feature Manager, label: Configure Features, icon: fas fa-toggle-on, hint Completely disable Shadowdark Extras features, including hidden hooks and background behavior.
• Disabling prevents initialization of that feature's menu registrations, settings, Hooks.on/libWrapper.register, sockets, templates, and tray mode. Stored world data (container flags, journal pages, pin pages, aura Regions, carousing sessions, style values, granted advancements, etc.) is preserved — re-enable and reload to restore.
• App id sdx-feature-manager, classes shadowdark-extras sdx-feature-manager-app, size 920×820, template templates/feature-manager.hbs. Previews are assets/feature-manager/*.webp (one per visible choice).

---

Related: Settings Reference · The SDX Tray & Party Tools · Troubleshooting