-
Notifications
You must be signed in to change notification settings - Fork 3
Troubleshooting
Symptoms, likely causes, and fixes. Feature pages include more specific advice; this page covers problems that cross the module.
- Confirm Shadowdark Extras is enabled for the current world.
- Confirm Foundry shows every required dependency as installed and enabled: socketlib, libWrapper, Sequencer, portal-lib, and TokenMagic FX.
- Open the browser console with
F12. - Reload and find the first error mentioning
shadowdark-extras. The first error is normally more useful than later cascading errors. - Confirm the release is complete. A missing imported
.mjsfile aborts the entire module at startup.
Hard-refresh with Ctrl+Shift+R. A normal Foundry reload can retain cached CSS,
templates, or JavaScript after an update.
Check Settings Reference. Settings marked Reload attach their behavior at startup. Reload the world after changing them.
- Confirm Sequencer is active.
- Confirm a JB2A pack is installed and active.
- In Configure Animations, verify the preset path resolves in the Sequencer database.
- Select a token before pressing preview.
- Confirm the category and the item's own override are enabled.
- Check the per-client sound toggle/volume if visuals work but sound does not.
The psfx module is optional. A preset that references psfx can animate
silently when the sound pack is absent.
Automated Animations and SDX may both be configured for the item. Keep the SDX AA integration enabled, then check whether a second module has its own chat or workflow animation hook.
Current versions guard chat-history re-renders. If this still happens, confirm the client actually updated to the latest module version and hard-refresh.
Many cross-owner changes are sent to an active GM over socketlib. Confirm:
- a GM is connected;
- socketlib is active;
- the player owns the source actor/token;
- the GM has access to the active scene and target documents.
This is the default. The GM must enable Allow Players to Paint Dungeons. Painting still requires a connected GM to perform the scene mutation.
Visibility and authority are separate. Map generation, pin management, scene import, Regions, and destructive cleanup remain GM actions.
- Open Configure Combat Settings and enable Show Damage Card.
- If only the GM sees it, enable Show Damage Card for Players.
- If it was a miss, check Hide Damage Card on Failed Attack.
- Confirm the item produced a Shadowdark attack/damage chat workflow that SDX recognizes.
Auto-Apply Damage is on by default. Turn it off in Combat Settings. Use GM Only Apply Damage if the card should remain visible but only the GM may commit it.
Both checks default to None. Set each to Warn or Block in Combat Settings. SDX treats Close as 5 ft and Near as 30 ft for this check; Far is not blocked by distance.
- Confirm Enhance Spells is on and reload if you just enabled it.
- Open the item's Activity tab and verify its configuration was saved.
- For a Scroll or Wand, confirm its referenced spell UUID still resolves.
- For a Run-as-GM macro, keep caster and target tokens on a scene the receiving client can resolve. Cross-scene token placeables cannot be manufactured.
- Use Medkit if the actor holds an older copy of an SDX-enhanced item.
Current behavior applies the per-turn result only after a successful native focus check. Confirm the spell is marked as a focus spell in Shadowdark data and that old copied items have been refreshed through Medkit.
Update to a current SDX release. The module includes a Foundry v14 compatibility repair for frozen/corrupted Shadowdark compendium index data.
- Confirm Show Medkit Icon is on.
- Confirm the actor owns a Spell, Scroll, or Wand that can be matched.
- A Scroll/Wand must have a valid referenced spell UUID.
- The source pack must be registered; the SDX item pack is always registered.
- A same-named unrelated item is not necessarily a valid source match.
- Nested containers can be disabled separately.
- Items must belong to the same actor for normal owned-container moves.
- Hold
Ctrlwhere the UI indicates move-versus-copy behavior. - Do not delete a container without first deciding what should happen to its contents.
Expected. The feature hides the true name/description from players while preserving GM visibility. Identification uses Shadowdark 4.x's native identified state.
Enable SDX Tray is client-scoped. Turn it on for the affected user and reload. Also check that the browser is wide enough and no theme/module is covering the left edge.
The tray reads the current controlled/owned tokens and configured party state. Select a token, add world Player actors to a Party actor, or allow the GM tray to show NPCs as appropriate.
Confirm the crown tool points to the intended leader and every client has received the current marching state. Toggle Marching Mode off and on after an update if a stale client retained old state.
Keep Block Drawing While Typing enabled. Change or disable the hold-to-draw keybinding under Foundry's Configure Controls if it conflicts with another module.
Use Format Map before painting or procedural generation. Choose the intended hex orientation and dimensions, and do not change the scene grid afterward without rebuilding the tile layout.
Update to a current release. Older builds added extra fit/buffer space. Current formatting sizes the scene to the selected width and height, with Foundry's normal half-hex edge behavior where applicable.
- Confirm the generator is using the bundled local build required for capture.
- Wait for the generator canvas to finish rendering.
- Try reopening the generator rather than importing from a stale window.
- Check the console for a missing render transform or geometry warning.
Some generators can degrade to an image-only import if structured geometry is unavailable; walls, doors, or levels may then be absent.
Generation acts on the current scene and level context. Activate the correct scene and elevation level first. Duplicate important scenes before generation.
- Confirm the scene is hexagonal and Hex Fog is active.
- Check Hex Fog: Default Reveal Radius.
- Shader effects are optional; disabling Enable Fog Effects should improve performance without disabling the underlying fog state.
Try Enable Pixel perfect on Pins and adjust the alpha threshold. For hex-sized image pins, use Fit to hex grid in the Pin Style Editor.
Original-mode mechanical outcomes use the GM-only Apply action. Review its preview and confirm it. Narrative outcomes are appended to character notes rather than guessed into unsupported mechanics.
If Carousing Wealth Base includes gear, the loss can be based on total valued wealth while collection still comes from coins. Any unpaid balance becomes a zero-slot Carousing Debt item.
Use the supported labeled or pipe-separated formats and review the editor. Linking an Original-format table to an Expanded section, or vice versa, is not a valid conversion.
Include:
- Foundry version and build;
- Shadowdark system version;
- Shadowdark Extras version;
- active dependency versions;
- other active modules likely to touch the same sheet/chat/canvas workflow;
- the first relevant console error and stack trace;
- exact steps, expected result, and actual result;
- whether the problem reproduces as GM, player, or both.
Report it through GitHub issues or the Discord community.
Related: Installation & Setup · Settings Reference