Follow the Quick Start to create and assign your first profile. For a one-token variation, choose Custom in the token’s Vision tab, adjust the values, and click Update Token.

A profile changed from its preset is marked Modified. Restore an individual field or use Restore Preset for the whole profile. Custom (keep current values) removes the preset association while retaining the current values.

Token Custom mode starts with the profile or default values currently in use. You can restore those starting values for one field, one section, or all overrides. Use Profile/Default leaves Custom mode and follows the selected shared profile or default again. Deleting a referenced profile falls back to client defaults.

Use Client Default for your browser’s default values. GMs can assign defaults to Foundry vision modes and import or export shared profiles. Imports merge by profile ID and can optionally restore vision-mode defaults; exported profiles retain their preset restore point.

Prototype tokens support the same profile and custom settings, inherited by newly placed tokens. They are not placed in a scene, so they cannot show a live preview.

• Perceived Light Reach increases the viewer’s sensitivity to existing light. It does not create illumination or grant sight in total darkness. In the default Realistic Sensitivity model, 2× sensitivity extends a 40 ft local-light radius to about 56 ft; 4× extends it to 80 ft. Legacy Distance retains the earlier direct radius multiplier.
• Total-Darkness Sight lets a token see without light, within its configured sight range. Set a range greater than 0 ft to use it. Native darkvision and truesight also use their applicable ranges.
• Color Perception lets you choose one color model at a time, including species presets with their own color settings. Color loss in darkness can be adjusted separately.
• Focus Pattern changes sharpness with token facing. It does not change line of sight or target visibility.
• Natural Clarity makes dimly lit detail easier to see when using light amplification. Adjust its strength with Dim-Light Detail. It fades as the light gets weaker and does not reveal unexplored fog or areas behind walls.

Low-light sensitivity can change which illuminated targets the viewer recognizes. Walls, light paths, and Foundry’s detection checks still constrain that visibility. Seeing faint terrain does not mean you can also recognize a token there.

With active Global Illumination, redundant vision rings and darkness effects are suppressed. Effects Activation Darkness can delay these effects until the scene reaches a chosen darkness level. Native darkness sight remains available when only this threshold suppresses the visual effects.

Foundry’s Light Amplification vision mode uses IVFX’s light response while the module is enabled; disabling IVFX restores the native mode’s presentation.

Species vision and Photometric falloff are visual approximations, not scientific simulations. Display calibration, individual animals, and adaptation vary.

For an individual Ambient Light or token light, open its configuration and expand Advanced Light Softening. Enable Custom Light Softening to override the default fade distance, curve, and intensity. Placed lights preview on the canvas; prototype light settings apply to future tokens without a live canvas preview.

Ordinary lights keep Foundry’s bright/dim structure, wall occlusion, animation, and coloration. Cave-entry lights use the opening’s shape and reach instead of an ordinary circular falloff.

For a basic cave:

1. Supply outdoor illumination through Foundry Global Illumination or Scene Configuration → Immersive Vision FX — Outdoor Light. Sky presets include None, Starlight, Crescent Moon, Half Moon, Full Moon, and Custom.
2. Wall the sealed cave edges and leave an actual gap at the entrance. A darkness Region does not replace walls.
3. Add an Adjust Darkness Level behavior to the Region. Under Light Entry, enable Global Light Penetration and start with Auto from Opening reach.
4. Use Manual reach when you want a fixed scene distance. Daylight Softness shapes the spill; Edge Blend tunes the side and terminal fade without moving that endpoint.
5. Under Indirect Light, choose Aperture Indirect Bounce for diffuse fill. Indirect Bounce sets brightness and Bounce Spread sets fade distance, from 100% to 200% of Daylight Reach.
6. Select a viewer with Selected Token or Sticky Last Selected GM preview. Refresh selected viewer updates the Region form’s setup summary. Save applies the draft; closing discards it.

Advanced controls offer Legacy / Automatic or Height-Aware entry. Height-Aware uses the Opening Height you set and the scene’s daylight elevation. Direct light can follow the opening’s direction or the scene’s daylight direction. Scene azimuth sets the compass direction: 0° is north/up, increasing clockwise. Light spreads across the map in two dimensions; elevation is used when checking what blocks it.

Regions can block outdoor light for interiors, use the scene’s sky settings, or have their own sky preset or custom light level. Darkness Regions default to sealed interiors until configured. The scene needs outdoor light or active Global Illumination for light to spill inward. IVFX creates temporary cave-entry lights as needed; they are not saved as lights on the scene.

1. Enable Eyeshine in the module settings as a GM.
2. Select a placed token, open Eyeshine Editor, and choose Add Selected Token Art. Alternatively, use the Eyeshine card on a prototype token’s Appearance tab.
3. Click the art preview to add points. Drag to move them, use the mouse wheel to resize them, or use Add Pair and the deletion controls. Adjust color, intensity, dim-light floor, and size.
4. Use Lighting Test to compare darkness, dim light, bright light, and Global Illumination.
5. Click Save Mapping. Until then, the mapping is a draft.

To build a larger library, expand Browse Token Art, choose the storage location, and open a folder. Use Search source art, select files, and choose Add Selected, or use Add Entire Folder. Folder imports offer Include subfolders and Preserve folder structure, then show a review before Add to Library. Existing mappings are kept and duplicate art is skipped. Open File Picker provides Foundry’s usual file browser.

In Eyeshine Library, use New Folder to organize art and select a destination before importing. Drag source art onto a library folder to add it, or drag library entries between folders to move them. These folders organize the library without moving the underlying files. Use All Art, Unfiled, Search library, and Status to find entries; click an entry to map it and Back to Library to return.

Copy Settings to Selected queues settings from a saved mapping for review. Open each entry marked Needs Review, check its eye positions, and click Save Mapping to apply it. Discard Queued Changes keeps the saved mapping. For unavailable art, use Retry or Locate Replacement, then review and save the replacement mapping.

A prototype-launched mapping is saved separately from Update Prototype Token. It applies globally to that art path, not just to the prototype. For wildcard art, map each concrete variant separately using the previewed image.

Animated art must load its dimensions before point placement is enabled. Playback and timeline controls help choose a frame; the mapping uses fixed coordinates rather than tracking moving eyes through the animation.

Illumination geometry checks light reaching the eyes. Retroreflective (Advanced) also requires observer line of sight and alignment with the incoming light. World settings control eyeshine for all clients; the module’s per-client master toggle remains an opt-out. Export/import lets you transfer mappings, provided the art paths match.

Use Settings & Vision Profiles for client defaults, shared profiles, behavior, and diagnostic settings. Fine-tuning groups cover color, light response, focus and clarity, edge presentation, and special effects.

Shared profiles, vision-mode assignments, the light-amplification model, and eyeshine policy/mappings are world settings. Personal rendering preferences and the master toggle are client settings. The light fade control is a minimum softness; IVFX retains a full-radius fade for ordinary lights.

Reset to Defaults shows the settings you can reset. Players reset their own client settings; GMs can also reset shared world options. Your saved profiles, vision-mode assignments, and eyeshine mappings are preserved.

• No effect: confirm libWrapper is installed and enabled, then check the per-client master toggle, the selected viewer, and its profile. Global Illumination or the activation-darkness threshold can suppress effects that would otherwise appear in darkness.
• No sight in darkness: check the token’s sight range and native vision mode or Total-Darkness Sight. Perceived Light Reach needs existing illumination.
• Unexpected GM view: check GM Vision Preview and select the intended token. With no active viewer, Foundry controls the GM’s overview.
• No cave spill: check outdoor illumination, the Region’s Adjust Darkness Level behavior, and a real gap in the walls. Sealed boundaries block entry.
• No eyeshine: save the mapping, confirm the exact art path, and check scene darkness and local light at an eye point. Active Global Illumination suppresses eyeshine; Retroreflective mode adds alignment and observer line-of-sight requirements.
• Slow rendering: reduce peripheral blur and compare simpler light curves on scenes with many overlapping lights. Keep diagnostic tools off during play. The renderer has limits of 16 vision sources, 48 local lights, and 24 apertures; these are rendering limits, not performance guarantees.
• A possible module conflict: reproduce in a test world with other vision/lighting modules disabled, then report the versions, reproduction steps, and console output on Discord.

Tested with D&D 5e 5.3.3. The optional Vision Mechanics Observer reads character senses and reports lighting and vision information for troubleshooting. It does not add conditions or effects to characters. Other game systems and module combinations have not all been tested.

IVFX requires libWrapper to help it work alongside other modules. Modules that also change vision or lighting can still conflict. If something looks wrong, try disabling the other vision or lighting modules in a test world, then report the combination on Discord.

Light and vision fade across the map in two dimensions. Token and light elevations participate in relevant V14 collision checks, but this is not a 3D lighting simulation. More visible sources, overlapping lights, and blur increase rendering work; results depend on the scene and client hardware.