Pick-Up-Stix
A Foundry VTT v13+ module specifically built for the dnd5e and pf2e systems (system-agnostic is available but with limited functionality) that lets GMs place interactive objects on the canvas for players to discover, inspect, and interact with. Objects use native sheets for specifically supported systems for a seamless experience, and custom sheets for system-agnostic mode.
Features
One Actor, Two Modes
A single interactive object actor type adapts its behavior:
- Item mode -- When the actor is an item type (weapon, potion, quest item, etc.), players can inspect or pick up item-type tokens.
- Container mode -- When the actor is a container type (chests, barrels, crates, etc.), players can inspect, open/close, take items from, or put items in them.
Player Interaction
- Token HUD -- Players interact through buttons on the Token HUD: inspect contents, pick up items, and open/close containers.
- Two proximity ranges -- Each object has a configurable **inspection range** (to see the nameplate and open the sheet) and a tighter **interaction range** (to pick up, open/close, lock, or view container contents). Beyond inspection range, players see a **limited-view dialog** with a generic name and description; when they move into inspection range, the dialog is promoted in place to the real sheet. Sheets update live as a player moves through the ranges.
- Limited name / description -- GMs can set a `Limited Name` and `Limited Description` shown to distant observers. When blank, a sensible fallback is used ("A chest of some sort" / "You are too far away to discern any details."). Containers append an "it appears open/closed" line automatically.
- Hidden container contents -- When a player opens a container sheet while closed, locked, or outside interaction range, the inventory is replaced with a placeholder message instead of listing contents.
- Drop items -- Players can drop items from their inventory onto the canvas via drag-and-drop or the "Drop Item" right-click context menu. Items are placed at the player's token position. By default no modifier key is required; GMs can optionally require Ctrl via the "Require Ctrl for drag actions" Module Setting.
- Deposit items -- Players can drag items from their inventory into an open container's sheet to deposit them.
- Unidentified item privacy -- When an interactive object item is in a player's inventory, the player sees only the generic name, image, and description until a GM reveals it. only supported in some systems.
Light-emitting Items
- Per-item light configuration -- Configure dim/bright radius, color, animation, and advanced lighting options for any interactive item via a lightbulb button in the sheet header (matches Foundry's standard Token Light tab).
- Carry-on-pickup -- When a player picks up a lit item (torch, lantern, etc.), the carrier token emits the item's light additively to its own token-light; the carrier's own light is never overwritten. Movement updates the light position smoothly.
- Container gating -- Items inside an interactive container emit light only while the container is open; closing suppresses the emission.
- On/off toggle -- A lightbulb HUD button on canvas tokens (GM) and a row icon in inventories / container contents (GM or item owner) toggle emission without losing the configured radii.
Requirements
- Foundry VTT v13+
- dnd5e system 4.0.0+, pf2e system 8.0.0+, system agnostic (with limited functionality)
- [lib-wrapper](https://foundryvtt.com/packages/lib-wrapper) module
Installation
Install via the Foundry module browser by searching for "Interactive Items", or paste the manifest URL into the Install Module dialog.
Support
FoundryVTT Discord username kamcknig
Submit an issue on Github https://github.com/kamcknig/pick-up-stix/issues
AI Usage
AI has been used to CSS styling and for researching the Foundry VTT APIs to ensure proper usage most especially for determine the differences between the various versions of Foundry supported by the module. AI also used to create documentation/summarizations of features.